diff options
| author | Brad King <brad.king@kitware.com> | 2023-11-27 15:21:36 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2023-11-27 15:22:12 (GMT) |
| commit | 907d4db558aceab9cf8f834d536e48d5c42f9108 (patch) | |
| tree | d0fdff6899b2d1255cf35f2699ee73952ce2b83d /Help/cpack_gen/deb.rst | |
| parent | 0cd2ada2d14e391d8bff89a1f47753ad51a44ab5 (diff) | |
| download | CMake-907d4db558aceab9cf8f834d536e48d5c42f9108.zip CMake-907d4db558aceab9cf8f834d536e48d5c42f9108.tar.gz CMake-907d4db558aceab9cf8f834d536e48d5c42f9108.tar.bz2 | |
Help: Format allowed CPACK_{DEB,RPM}_FILE_NAME values as definition list
This provides a structured location for notes about each value.
Diffstat (limited to 'Help/cpack_gen/deb.rst')
| -rw-r--r-- | Help/cpack_gen/deb.rst | 31 |
1 files changed, 15 insertions, 16 deletions
diff --git a/Help/cpack_gen/deb.rst b/Help/cpack_gen/deb.rst index 705ec9c..1aac279 100644 --- a/Help/cpack_gen/deb.rst +++ b/Help/cpack_gen/deb.rst @@ -69,28 +69,27 @@ List of CPack DEB generator specific variables: :Mandatory: Yes :Default: ``<CPACK_PACKAGE_FILE_NAME>[-<component>].deb`` - This may be set to ``DEB-DEFAULT`` to allow the CPack DEB generator to generate - package file name by itself in deb format:: + This may be set to: - <PackageName>_<VersionNumber>-<DebianRevisionNumber>_<DebianArchitecture>.deb + ``DEB-DEFAULT`` + Tell CPack to automatically generate the package file name in deb format:: - Alternatively provided package file name must end - with either ``.deb`` or ``.ipk`` suffix. + <PackageName>_<VersionNumber>-<DebianRevisionNumber>_<DebianArchitecture>.deb - .. versionadded:: 3.10 - ``.ipk`` suffix used by OPKG packaging system. - - .. note:: + This setting recommended as the preferred behavior, but for backward + compatibility with the CPack DEB generator in CMake prior to version 3.6, + this is not the default. Without this, duplicate names may occur. + Duplicate files get overwritten and it is up to the packager to set + the variables in a manner that will prevent such errors. - Preferred setting of this variable is ``DEB-DEFAULT`` but for backward - compatibility with the CPack DEB generator in CMake prior to version 3.6 this - feature is disabled by default. + ``<file-name>.deb`` + Use the given file name. The ``.deb`` suffix is required. - .. note:: + ``<file-name>.ipk`` + .. versionadded:: 3.10 - By using non default filenames duplicate names may occur. Duplicate files - get overwritten and it is up to the packager to set the variables in a - manner that will prevent such errors. + Use the given file name. + The ``.ipk`` suffix is used by the OPKG packaging system. .. variable:: CPACK_DEBIAN_PACKAGE_EPOCH |