[CMake] cpack DEB generator docs

[Doug]

Hm... I can't edit the wiki myself without going through the process of
getting 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

Some of the supported options are not listed.

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_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 <>.

CPACK_DEBIAN_PACKAGE_PREDEPENDS
This field is like Depends, except that it also forces dpkg to complete
installation of the packages named before even starting the installation of
the package which declares the pre-dependency.

CPACK_DEBIAN_PACKAGE_ENHANCES
This field is similar to Suggests but works in the opposite direction. It
is used to declare that a package can enhance the functionality of another
package.
CPACK_DEBIAN_PACKAGE_BREAKS
When one binary package declares that it breaks another, dpkg will refuse
to allow the package which declares Breaks to be unpacked unless the broken
package is deconfigured first, and it will refuse to allow the broken
package to be reconfigured.

CPACK_DEBIAN_PACKAGE_CONFLICTS
When one binary package declares a conflict with another using a Conflicts
 field, dpkg will refuse to allow them to be unpacked on the system at the
same time. This is a stronger restriction than Breaks, which prevents the
broken package from being configured while the breaking package is in the
"Unpacked" state but allows both packages to be unpacked at the same time.

CPACK_DEBIAN_PACKAGE_PROVIDES
A *virtual package* is one which appears in the Provides control field of
another package. The effect is as if the package(s) which provide a
particular virtual package name had been listed by name everywhere the
virtual package name appears.

CPACK_DEBIAN_PACKAGE_REPLACES
Packages can declare in their control file that they should overwrite files
in certain other packages, or completely replace other packages. The
Replaces control field has these two distinct purposes.

~
Doug.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.cmake.org/pipermail/cmake/attachments/20120618/26c809c3/attachment.htm>