From 76d6c593584e35cf25a50c2e7bac233665da437a Mon Sep 17 00:00:00 2001 From: Zack Galbreath Date: Fri, 3 Aug 2012 09:20:45 -0400 Subject: [PATCH] Clean up documentation formatting so that it is rendered properly in HTML. --- Modules/CPackComponent.cmake | 326 ++++++++++++++++----------------- Source/cmDocumentVariables.cxx | 6 +- 2 files changed, 166 insertions(+), 166 deletions(-) diff --git a/Modules/CPackComponent.cmake b/Modules/CPackComponent.cmake index 15987030e..dce34bf3a 100644 --- a/Modules/CPackComponent.cmake +++ b/Modules/CPackComponent.cmake @@ -28,31 +28,31 @@ ##variable # 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. +#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__COMPONENT_INSTALL - Enable/Disable component install for # CPack generator . # -# 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. +#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. # -# 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: -# - 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 -# One can specify different grouping for different CPack generator by using -# a CPACK_PROJECT_CONFIG_FILE. +#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: +# - 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 +#One can specify different grouping for different CPack generator by using +#a CPACK_PROJECT_CONFIG_FILE. ##end ##variable # CPACK_COMPONENT__DISPLAY_NAME - The name to be displayed for a component. @@ -71,194 +71,194 @@ # CPACK_COMPONENT__REQUIRED - True is this component is required. ##end ##macro -# cpack_add_component - Describes a CPack installation component -# named by the COMPONENT argument to a CMake INSTALL command. +#cpack_add_component - Describes a CPack installation component +#named by the COMPONENT argument to a CMake INSTALL command. # -# cpack_add_component(compname -# [DISPLAY_NAME name] -# [DESCRIPTION description] -# [HIDDEN | REQUIRED | DISABLED ] -# [GROUP group] -# [DEPENDS comp1 comp2 ... ] -# [INSTALL_TYPES type1 type2 ... ] -# [DOWNLOADED] -# [ARCHIVE_FILE filename]) +# cpack_add_component(compname +# [DISPLAY_NAME name] +# [DESCRIPTION description] +# [HIDDEN | REQUIRED | DISABLED ] +# [GROUP group] +# [DEPENDS comp1 comp2 ... ] +# [INSTALL_TYPES type1 type2 ... ] +# [DOWNLOADED] +# [ARCHIVE_FILE filename]) # -# The cmake_add_component command describes an installation -# component, which the user can opt to install or remove as part of -# the graphical installation process. compname is the name of the -# component, as provided to the COMPONENT argument of one or more -# CMake INSTALL commands. +#The cmake_add_component command describes an installation +#component, which the user can opt to install or remove as part of +#the graphical installation process. compname is the name of the +#component, as provided to the COMPONENT argument of one or more +#CMake INSTALL commands. # -# DISPLAY_NAME is the displayed name of the component, used in -# graphical installers to display the component name. This value can -# be any string. +#DISPLAY_NAME is the displayed name of the component, used in +#graphical installers to display the component name. This value can +#be any string. # -# DESCRIPTION is an extended description of the component, used in -# graphical installers to give the user additional information about -# the component. Descriptions can span multiple lines using "\n" as -# the line separator. Typically, these descriptions should be no -# more than a few lines long. +#DESCRIPTION is an extended description of the component, used in +#graphical installers to give the user additional information about +#the component. Descriptions can span multiple lines using "\n" as +#the line separator. Typically, these descriptions should be no +#more than a few lines long. # -# HIDDEN indicates that this component will be hidden in the -# graphical installer, so that the user cannot directly change -# whether it is installed or not. +#HIDDEN indicates that this component will be hidden in the +#graphical installer, so that the user cannot directly change +#whether it is installed or not. # -# REQUIRED indicates that this component is required, and therefore -# will always be installed. It will be visible in the graphical -# installer, but it cannot be unselected. (Typically, required -# components are shown greyed out). +#REQUIRED indicates that this component is required, and therefore +#will always be installed. It will be visible in the graphical +#installer, but it cannot be unselected. (Typically, required +#components are shown greyed out). # -# DISABLED indicates that this component should be disabled -# (unselected) by default. The user is free to select this component -# for installation, unless it is also HIDDEN. +#DISABLED indicates that this component should be disabled +#(unselected) by default. The user is free to select this component +#for installation, unless it is also HIDDEN. # -# DEPENDS lists the components on which this component depends. If -# this component is selected, then each of the components listed -# must also be selected. The dependency information is encoded -# within the installer itself, so that users cannot install -# inconsitent sets of components. +#DEPENDS lists the components on which this component depends. If +#this component is selected, then each of the components listed +#must also be selected. The dependency information is encoded +#within the installer itself, so that users cannot install +#inconsistent sets of components. # -# GROUP names the component group of which this component is a -# part. If not provided, the component will be a standalone -# component, not part of any component group. Component groups are -# described with the cpack_add_component_group command, detailed -# below. +#GROUP names the component group of which this component is a +#part. If not provided, the component will be a standalone +#component, not part of any component group. Component groups are +#described with the cpack_add_component_group command, detailed +#below. # -# INSTALL_TYPES lists the installation types of which this component -# is a part. When one of these installations types is selected, this -# component will automatically be selected. Installation types are -# described with the cpack_add_install_type command, detailed below. +#INSTALL_TYPES lists the installation types of which this component +#is a part. When one of these installations types is selected, this +#component will automatically be selected. Installation types are +#described with the cpack_add_install_type command, detailed below. # -# DOWNLOADED indicates that this component should be downloaded -# on-the-fly by the installer, rather than packaged in with the -# installer itself. For more information, see the cpack_configure_downloads -# command. +#DOWNLOADED indicates that this component should be downloaded +#on-the-fly by the installer, rather than packaged in with the +#installer itself. For more information, see the cpack_configure_downloads +# command. # -# ARCHIVE_FILE provides a name for the archive file created by CPack -# to 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. +#ARCHIVE_FILE provides a name for the archive file created by CPack +#to 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. +#cpack_add_component_group - Describes a group of related CPack +#installation components. # -# cpack_add_component_group(groupname -# [DISPLAY_NAME name] -# [DESCRIPTION description] -# [PARENT_GROUP parent] -# [EXPANDED] -# [BOLD_TITLE]) +# cpack_add_component_group(groupname +# [DISPLAY_NAME name] +# [DESCRIPTION description] +# [PARENT_GROUP parent] +# [EXPANDED] +# [BOLD_TITLE]) # -# The cpack_add_component_group describes a group of installation -# components, which will be placed together within the listing of -# options. Typically, component groups allow the user to -# select/deselect all of the components within a single group via a -# single group-level option. Use component groups to reduce the -# complexity of installers with many options. groupname is an -# arbitrary name used to identify the group in the GROUP argument of -# the cpack_add_component command, which is used to place a -# component in a group. The name of the group must not conflict with -# the name of any component. +#The cpack_add_component_group describes a group of installation +#components, which will be placed together within the listing of +#options. Typically, component groups allow the user to +#select/deselect all of the components within a single group via a +#single group-level option. Use component groups to reduce the +#complexity of installers with many options. groupname is an +#arbitrary name used to identify the group in the GROUP argument of +#the cpack_add_component command, which is used to place a +#component in a group. The name of the group must not conflict with +#the name of any component. # -# DISPLAY_NAME is the displayed name of the component group, used in -# graphical installers to display the component group name. This -# value can be any string. +#DISPLAY_NAME is the displayed name of the component group, used in +#graphical installers to display the component group name. This +#value can be any string. # -# DESCRIPTION is an extended description of the component group, -# used in graphical installers to give the user additional -# information about the components within that group. Descriptions -# can span multiple lines using "\n" as the line -# separator. Typically, these descriptions should be no more than a -# few lines long. +#DESCRIPTION is an extended description of the component group, +#used in graphical installers to give the user additional +#information about the components within that group. Descriptions +#can span multiple lines using "\n" as the line +#separator. Typically, these descriptions should be no more than a +#few lines long. # -# PARENT_GROUP, if supplied, names the parent group of this group. -# Parent groups are used to establish a hierarchy of groups, -# providing an arbitrary hierarchy of groups. +#PARENT_GROUP, if supplied, names the parent group of this group. +#Parent groups are used to establish a hierarchy of groups, +#providing an arbitrary hierarchy of groups. # -# EXPANDED indicates that, by default, the group should show up as -# "expanded", so that the user immediately sees all of the -# components within the group. Otherwise, the group will initially -# show up as a single entry. +#EXPANDED indicates that, by default, the group should show up as +#"expanded", so that the user immediately sees all of the +#components within the group. Otherwise, the group will initially +#show up as a single entry. # -# BOLD_TITLE indicates that the group title should appear in bold, -# to call the user's attention to the group. +#BOLD_TITLE indicates that the group title should appear in bold, +#to call the user's attention to the group. ##end # ##macro -# cpack_add_install_type - Add a new installation type containing a -# set of predefined component selections to the graphical installer. +#cpack_add_install_type - Add a new installation type containing a +#set of predefined component selections to the graphical installer. # -# cpack_add_install_type(typename -# [DISPLAY_NAME name]) +# cpack_add_install_type(typename +# [DISPLAY_NAME name]) # -# The cpack_add_install_type command identifies a set of preselected -# components that represents a common use case for an -# application. For example, a "Developer" install type might include -# an application along with its header and library files, while an -# "End user" install type might just include the application's -# executable. Each component identifies itself with one or more -# install types via the INSTALL_TYPES argument to -# cpack_add_component. +#The cpack_add_install_type command identifies a set of preselected +#components that represents a common use case for an +#application. For example, a "Developer" install type might include +#an application along with its header and library files, while an +#"End user" install type might just include the application's +#executable. Each component identifies itself with one or more +#install types via the INSTALL_TYPES argument to +#cpack_add_component. # -# 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. +#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 # ##macro -# cpack_configure_downloads - Configure CPack to download selected -# components on-the-fly as part of the installation process. +#cpack_configure_downloads - Configure CPack to download selected +#components on-the-fly as part of the installation process. # -# cpack_configure_downloads(site -# [UPLOAD_DIRECTORY dirname] -# [ALL] -# [ADD_REMOVE|NO_ADD_REMOVE]) +# cpack_configure_downloads(site +# [UPLOAD_DIRECTORY dirname] +# [ALL] +# [ADD_REMOVE|NO_ADD_REMOVE]) # -# The cpack_configure_downloads command configures installation-time -# downloads of selected components. For each downloadable component, -# CPack will create an archive containing the contents of that -# component, which should be uploaded to the given site. When the -# user selects that component for installation, the installer will -# download and extract the component in place. This feature is -# useful for creating small installers that only download the -# requested components, saving bandwidth. Additionally, the -# installers are small enough that they will be installed as part of -# the normal installation process, and the "Change" button in -# Windows Add/Remove Programs control panel will allow one to add or -# remove parts of the application after the original -# installation. On Windows, the downloaded-components functionality -# requires the ZipDLL plug-in for NSIS, available at: +#The cpack_configure_downloads command configures installation-time +#downloads of selected components. For each downloadable component, +#CPack will create an archive containing the contents of that +#component, which should be uploaded to the given site. When the +#user selects that component for installation, the installer will +#download and extract the component in place. This feature is +#useful for creating small installers that only download the +#requested components, saving bandwidth. Additionally, the +#installers are small enough that they will be installed as part of +#the normal installation process, and the "Change" button in +#Windows Add/Remove Programs control panel will allow one to add or +#remove parts of the application after the original +#installation. On Windows, the downloaded-components functionality +#requires the ZipDLL plug-in for NSIS, available at: # -# http://nsis.sourceforge.net/ZipDLL_plug-in +# http://nsis.sourceforge.net/ZipDLL_plug-in # -# On Mac OS X, installers that download components on-the-fly can -# only be built and installed on system using Mac OS X 10.5 or -# later. +#On Mac OS X, installers that download components on-the-fly can +#only be built and installed on system using Mac OS X 10.5 or +#later. # -# The site argument is a URL where the archives for downloadable -# components will reside, e.g., http://www.cmake.org/files/2.6.1/installer/ -# All of the archives produced by CPack should be uploaded to that location. +#The site argument is a URL where the archives for downloadable +#components will reside, e.g., http://www.cmake.org/files/2.6.1/installer/ +#All of the archives produced by CPack should be uploaded to that location. # -# UPLOAD_DIRECTORY is the local directory where CPack will create the -# various archives for each of the components. The contents of this -# directory should be uploaded to a location accessible by the URL given -# in the site argument. If omitted, CPack will use the directory -# CPackUploads inside the CMake binary directory to store the generated -# archives. +#UPLOAD_DIRECTORY is the local directory where CPack will create the +#various archives for each of the components. The contents of this +#directory should be uploaded to a location accessible by the URL given +#in the site argument. If omitted, CPack will use the directory +#CPackUploads inside the CMake binary directory to store the generated +#archives. # -# The ALL flag indicates that all components be downloaded. Otherwise, only -# those components explicitly marked as DOWNLOADED or that have a specified -# ARCHIVE_FILE will be downloaded. Additionally, the ALL option implies -# ADD_REMOVE (unless NO_ADD_REMOVE is specified). +#The ALL flag indicates that all components be downloaded. Otherwise, only +#those components explicitly marked as DOWNLOADED or that have a specified +#ARCHIVE_FILE will be downloaded. Additionally, the ALL option implies +#ADD_REMOVE (unless NO_ADD_REMOVE is specified). # -# ADD_REMOVE indicates that CPack should install a copy of the installer -# 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. +#ADD_REMOVE indicates that CPack should install a copy of the installer +#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 #============================================================================= diff --git a/Source/cmDocumentVariables.cxx b/Source/cmDocumentVariables.cxx index 77aaffcba..05ef8fc71 100644 --- a/Source/cmDocumentVariables.cxx +++ b/Source/cmDocumentVariables.cxx @@ -831,9 +831,9 @@ void cmDocumentVariables::DefineVariables(cmake* cm) "the shared MFC library. This is used in visual " "studio 6 and 7 project files. The CMakeSetup " "dialog used MFC and the CMakeLists.txt looks like this:\n" - "add_definitions(-D_AFXDLL)\n" - "set(CMAKE_MFC_FLAG 2)\n" - "add_executable(CMakeSetup WIN32 ${SRCS})\n",false, + " add_definitions(-D_AFXDLL)\n" + " set(CMAKE_MFC_FLAG 2)\n" + " add_executable(CMakeSetup WIN32 ${SRCS})\n",false, "Variables That Change Behavior"); cm->DefineProperty