summaryrefslogtreecommitdiffstats
path: root/Modules/CPackComponent.cmake
diff options
context:
space:
mode:
authorKitware Robot <kwrobot@kitware.com>2013-10-15 17:23:23 (GMT)
committerBrad King <brad.king@kitware.com>2013-10-16 13:22:39 (GMT)
commita77e3086938d46c56f62901531245711dbd55cc4 (patch)
tree310f64bed6b69c741cbd1ec4e2be8177004d86e2 /Modules/CPackComponent.cmake
parente7ca48f226782e7354a7ea9d6f9cef58e8773306 (diff)
downloadCMake-a77e3086938d46c56f62901531245711dbd55cc4.zip
CMake-a77e3086938d46c56f62901531245711dbd55cc4.tar.gz
CMake-a77e3086938d46c56f62901531245711dbd55cc4.tar.bz2
CPack: Replace #<type> markup with reStructuredText equivalent
Drop #end and #module. Convert #section to a subsection header. Convert #variable to the cmake domain "variable" directive. Convert #macro to the cmake domain "command" directive. Perform minor formatting fixes in text near these changes.
Diffstat (limited to 'Modules/CPackComponent.cmake')
-rw-r--r--Modules/CPackComponent.cmake113
1 files changed, 49 insertions, 64 deletions
diff --git a/Modules/CPackComponent.cmake b/Modules/CPackComponent.cmake
index 4674a7b..a55a01e 100644
--- a/Modules/CPackComponent.cmake
+++ b/Modules/CPackComponent.cmake
@@ -4,7 +4,8 @@
#
# Build binary and source package installers
#
-# #section Variables concerning CPack Components #end #module
+# Variables concerning CPack Components
+# ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
#
# The CPackComponent module is the module which handles the component
# part of CPack. See CPack module for general information about CPack.
@@ -23,84 +24,64 @@
# of components to install during the install process. Installation
# components are identified by the COMPONENT argument of CMake's INSTALL
# commands, and should be further described by the following CPack
-# commands: #end
+# commands:
#
-# #variable
+# .. variable:: CPACK_COMPONENTS_ALL
#
-# ::
-#
-# CPACK_COMPONENTS_ALL - The list of component to install.
-#
-#
-#
-# The default value of this variable is computed by CPack and contains
-# all components defined by the project. The user may set it to only
-# include the specified components. #end
-#
-# #variable
-#
-# ::
-#
-# CPACK_<GENNAME>_COMPONENT_INSTALL - Enable/Disable component install for
-# CPack generator <GENNAME>.
-#
-#
-#
-# Each CPack Generator (RPM, DEB, ARCHIVE, NSIS, DMG, etc...) has a
-# legacy default behavior. e.g. RPM builds monolithic whereas NSIS
-# builds component. One can change the default behavior by setting this
-# variable to 0/1 or OFF/ON. #end #variable
-#
-# ::
-#
-# CPACK_COMPONENTS_GROUPING - Specify how components are grouped for multi-package
-# component-aware CPack generators.
+# The list of component to install.
#
+# The default value of this variable is computed by CPack and contains all
+# components defined by the project. The user may set it to only include the
+# specified components.
#
+# .. variable:: CPACK_<GENNAME>_COMPONENT_INSTALL
#
-# Some generators like RPM or ARCHIVE family (TGZ, ZIP, ...) generates
-# several packages files when asked for component packaging. They group
-# the component differently depending on the value of this variable:
+# Enable/Disable component install for CPack generator <GENNAME>.
#
-# ::
+# Each CPack Generator (RPM, DEB, ARCHIVE, NSIS, DMG, etc...) has a legacy
+# default behavior. e.g. RPM builds monolithic whereas NSIS builds
+# component. One can change the default behavior by setting this variable to
+# 0/1 or OFF/ON.
#
-# - ONE_PER_GROUP (default): creates one package file per component group
-# - ALL_COMPONENTS_IN_ONE : creates a single package with all (requested) component
-# - IGNORE : creates one package per component, i.e. IGNORE component group
+# .. variable:: CPACK_COMPONENTS_GROUPING
#
-# One can specify different grouping for different CPack generator by
-# using a CPACK_PROJECT_CONFIG_FILE. #end #variable
+# Specify how components are grouped for multi-package component-aware CPack
+# generators.
#
-# ::
+# Some generators like RPM or ARCHIVE family (TGZ, ZIP, ...) generates
+# several packages files when asked for component packaging. They group
+# the component differently depending on the value of this variable:
#
-# CPACK_COMPONENT_<compName>_DISPLAY_NAME - The name to be displayed for a component.
+# * ONE_PER_GROUP (default): creates one package file per component group
+# * ALL_COMPONENTS_IN_ONE : creates a single package with all (requested) component
+# * IGNORE : creates one package per component, i.e. IGNORE component group
#
-# #end #variable
+# One can specify different grouping for different CPack generator by
+# using a CPACK_PROJECT_CONFIG_FILE.
#
-# ::
+# .. variable:: CPACK_COMPONENT_<compName>_DISPLAY_NAME
#
-# CPACK_COMPONENT_<compName>_DESCRIPTION - The description of a component.
+# The name to be displayed for a component.
#
-# #end #variable
+# .. variable:: CPACK_COMPONENT_<compName>_DESCRIPTION
#
-# ::
+# The description of a component.
#
-# CPACK_COMPONENT_<compName>_GROUP - The group of a component.
+# .. variable:: CPACK_COMPONENT_<compName>_GROUP
#
-# #end #variable
+# The group of a component.
#
-# ::
+# .. variable:: CPACK_COMPONENT_<compName>_DEPENDS
#
-# CPACK_COMPONENT_<compName>_DEPENDS - The dependencies (list of components)
-# on which this component depends.
+# The dependencies (list of components) on which this component depends.
#
-# #end #variable
+# .. variable:: CPACK_COMPONENT_<compName>_REQUIRED
#
-# ::
+# True is this component is required.
#
-# CPACK_COMPONENT_<compName>_REQUIRED - True is this component is required.
+# .. command:: cpack_add_component
#
-# #end #macro cpack_add_component - Describes a CPack installation
+# Describes a CPack installation
# component named by the COMPONENT argument to a CMake INSTALL command.
#
# ::
@@ -170,10 +151,10 @@
# be used for downloaded components. If not supplied, CPack will create
# a file with some name based on CPACK_PACKAGE_FILE_NAME and the name of
# the component. See cpack_configure_downloads for more information.
-# #end
#
-# #macro cpack_add_component_group - Describes a group of related CPack
-# installation components.
+# .. command:: cpack_add_component_group
+#
+# Describes a group of related CPack installation components.
#
# ::
#
@@ -217,9 +198,11 @@
# single entry.
#
# BOLD_TITLE indicates that the group title should appear in bold, to
-# call the user's attention to the group. #end
+# call the user's attention to the group.
+#
+# .. command:: cpack_add_install_type
#
-# #macro cpack_add_install_type - Add a new installation type containing
+# Add a new installation type containing
# a set of predefined component selections to the graphical installer.
#
# ::
@@ -239,9 +222,11 @@
#
# DISPLAY_NAME is the displayed name of the install type, which will
# typically show up in a drop-down box within a graphical installer.
-# This value can be any string. #end
+# This value can be any string.
+#
+# .. command:: cpack_configure_downloads
#
-# #macro cpack_configure_downloads - Configure CPack to download
+# Configure CPack to download
# selected components on-the-fly as part of the installation process.
#
# ::
@@ -297,7 +282,7 @@
# that can be called from Windows' Add/Remove Programs dialog (via the
# "Modify" button) to change the set of installed components.
# NO_ADD_REMOVE turns off this behavior. This option is ignored on Mac
-# OS X. #endmacro
+# OS X.
#=============================================================================
# Copyright 2006-2009 Kitware, Inc.