[CMake] cpack DEB generator docs

[Doug]

Yeah, I really should. :)

Is this ok? Or shall I create a bug and attach the patch to that? (attach
patch; it's very minor; just missing 3 of the variables)

doug at shadowmint:~/ext/cmake$ ./bin/cpack --help-variable-list |grep DEB <--
All in there now~
CPACK_RPM_PACKAGE_DEBUG
CPACK_DEBIAN_PACKAGE_ARCHITECTURE
CPACK_DEBIAN_PACKAGE_BREAKS
CPACK_DEBIAN_PACKAGE_CONFLICTS
CPACK_DEBIAN_PACKAGE_CONTROL_EXTRA
CPACK_DEBIAN_PACKAGE_DEBUG
CPACK_DEBIAN_PACKAGE_DEPENDS
CPACK_DEBIAN_PACKAGE_DESCRIPTION
CPACK_DEBIAN_PACKAGE_ENHANCES
CPACK_DEBIAN_PACKAGE_HOMEPAGE
CPACK_DEBIAN_PACKAGE_MAINTAINER
CPACK_DEBIAN_PACKAGE_NAME
CPACK_DEBIAN_PACKAGE_PREDEPENDS
CPACK_DEBIAN_PACKAGE_PRIORITY
CPACK_DEBIAN_PACKAGE_PROVIDES
CPACK_DEBIAN_PACKAGE_RECOMMENDS
CPACK_DEBIAN_PACKAGE_REPLACES
CPACK_DEBIAN_PACKAGE_SECTION
CPACK_DEBIAN_PACKAGE_SHLIBDEPS
CPACK_DEBIAN_PACKAGE_SUGGESTS
CPACK_DEBIAN_PACKAGE_VERSION
doug at shadowmint:~/ext/cmake$ ./bin/cpack --help-variable
CPACK_DEBIAN_PACKAGE_CONTROL_EXTRA
cpack version 2.8.8.20120618-g1d819-dirty
  CPACK_DEBIAN_PACKAGE_CONTROL_EXTRA

            Mandatory : NO
            Default   : -
            This variable allow advanced user to add custom script to the
control.tar.gz
            Typical usage is for conffiles, postinst, postrm, prerm.
            Usage: SET(CPACK_DEBIAN_PACKAGE_CONTROL_EXTRA

 "${CMAKE_CURRENT_SOURCE_DIR/prerm;${CMAKE_CURRENT_SOURCE_DIR}/postrm")


doug at shadowmint:~/ext/cmake$ ./bin/cpack --help-variable
CPACK_DEBIAN_PACKAGE_SUGGESTS
cpack version 2.8.8.20120618-g1d819-dirty
  CPACK_DEBIAN_PACKAGE_SUGGESTS

            Mandatory : NO
            Default   : -
            see
http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps
            Allows packages to declare a suggested package install grouping.


doug at shadowmint:~/ext/cmake$ ./bin/cpack --help-variable
CPACK_DEBIAN_PACKAGE_RECOMMENDS
cpack version 2.8.8.20120618-g1d819-dirty
  CPACK_DEBIAN_PACKAGE_RECOMMENDS

            Mandatory : NO
            Default   : -
            see
http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps
            Allows packages to declare a strong, but not absolute,
dependency on other packages.


doug at shadowmint:~/ext/cmake$

~
Doug.

On Mon, Jun 18, 2012 at 2:47 PM, Eric Noulard <eric.noulard at gmail.com>wrote:

> 2012/6/18 Doug <douglas.linder at gmail.com>:
> > Hm... I can't edit the wiki myself without going through the process of
> > getting an account.
>
> Then you should get an account :-)
>
> > Would it be possible to add just a note to this page:
> > http://www.vtk.org/Wiki/CMake:CPackPackageGenerators#DEB_.28UNIX_only.29
>
> I did it at the top:
>
> http://www.cmake.org/Wiki/CMake:CPackPackageGenerators#CPack_Package_Generators
>
> > Some of the supported options are not listed.
>
> As stated in the just-added paragraph. ALL the CPack variables should
> now be documented
> by the builtin documentation support of CPack 2.8.8 and up.
>
> > These are probably seldom used by most people, but they're actually quite
> > important if you're making configuration packages or virtual packages.
> > (and they _are_ supported, so there's no reason to scare people off by
> > making them think they aren't~)
> >
> > Already listed:
> > CPACK_DEBIAN_PACKAGE_ARCHITECTURE
> > CPACK_DEBIAN_PACKAGE_MAINTAINER
> > CPACK_DEBIAN_PACKAGE_DESCRIPTION
> > CPACK_DEBIAN_PACKAGE_DEPENDS
> > CPACK_DEBIAN_PACKAGE_RECOMMENDS
> > CPACK_DEBIAN_PACKAGE_SUGGESTS
> > CPACK_DEBIAN_PACKAGE_CONTROL_EXTRA
> >
> > Not listed, but supported in Source/CPack/cmCPackDebGenerator.cxx:
>
> cpack --help-variable-list | grep CPACK_DEBIAN_
>
> will give you the currently builtin-documented variables but...
> some variables you listed hereafter are not listed or the documentation
> is not as complete as the one you gave.
>
>
>
>
> > CPACK_DEBIAN_PACKAGE_HOMEPAGE
> > The URL of the web site for this package, preferably (when applicable)
> the
> > site from which the original source can be obtained and any additional
> > upstream documentation or information may be found. The content of this
> > field is a simple URL without any surrounding characters such as <>.
>
> [...]
>
> The builtin documentation is extracted from CPackDeb.cmake
> would you be able to provide a patch for this file:
>
> http://cmake.org/gitweb?p=cmake.git;a=blob;f=Modules/CPackDeb.cmake;h=fe81dc92c9ee7958e5cbb82d9990e659e8dbf484;hb=HEAD
>
> containing your update?
>
> The CPack builtin doc uses a basic markup which should be easy to
> understand.
>
>
> --
> Erk
> Le gouvernement représentatif n'est pas la démocratie --
> http://www.le-message.org
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.cmake.org/pipermail/cmake/attachments/20120618/08bba537/attachment.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: cpack-docs-fix.patch
Type: application/octet-stream
Size: 1761 bytes
Desc: not available
URL: <http://www.cmake.org/pipermail/cmake/attachments/20120618/08bba537/attachment.obj>