Merge topic 'GNUInstallDirs-doc-format'

1199ebf1 GNUInstallDirs: Improve documentation formatting
This commit is contained in:
Brad King 2015-06-18 09:05:13 -04:00 committed by CMake Topic Stage
commit ab00ff8d7a
1 changed files with 33 additions and 28 deletions

View File

@ -4,57 +4,62 @@
# #
# Define GNU standard installation directories # Define GNU standard installation directories
# #
# Provides install directory variables as defined for GNU software: # Provides install directory variables as defined by the
# `GNU Coding Standards`_.
# #
# http://www.gnu.org/prep/standards/html_node/Directory-Variables.html # .. _`GNU Coding Standards`: https://www.gnu.org/prep/standards/html_node/Directory-Variables.html
# #
# Inclusion of this module defines the following variables: # Inclusion of this module defines the following variables:
# #
# ``CMAKE_INSTALL_<dir>`` # ``CMAKE_INSTALL_<dir>``
# destination for files of a given type
# ``CMAKE_INSTALL_FULL_<dir>``
# corresponding absolute path
# #
# where <dir> is one of: # Destination for files of a given type. This value may be passed to
# the ``DESTINATION`` options of :command:`install` commands for the
# corresponding file type.
#
# ``CMAKE_INSTALL_FULL_<dir>``
#
# The absolute path generated from the corresponding ``CMAKE_INSTALL_<dir>``
# value. If the value is not already an absolute path, an absolute path
# is constructed typically by prepending the value of the
# :variable:`CMAKE_INSTALL_PREFIX` variable.
#
# where ``<dir>`` is one of:
# #
# ``BINDIR`` # ``BINDIR``
# user executables (bin) # user executables (``bin``)
# ``SBINDIR`` # ``SBINDIR``
# system admin executables (sbin) # system admin executables (``sbin``)
# ``LIBEXECDIR`` # ``LIBEXECDIR``
# program executables (libexec) # program executables (``libexec``)
# ``SYSCONFDIR`` # ``SYSCONFDIR``
# read-only single-machine data (etc) # read-only single-machine data (``etc``)
# ``SHAREDSTATEDIR`` # ``SHAREDSTATEDIR``
# modifiable architecture-independent data (com) # modifiable architecture-independent data (``com``)
# ``LOCALSTATEDIR`` # ``LOCALSTATEDIR``
# modifiable single-machine data (var) # modifiable single-machine data (``var``)
# ``LIBDIR`` # ``LIBDIR``
# object code libraries (lib or lib64 or lib/<multiarch-tuple> on Debian) # object code libraries (``lib`` or ``lib64``
# or ``lib/<multiarch-tuple>`` on Debian)
# ``INCLUDEDIR`` # ``INCLUDEDIR``
# C header files (include) # C header files (``include``)
# ``OLDINCLUDEDIR`` # ``OLDINCLUDEDIR``
# C header files for non-gcc (/usr/include) # C header files for non-gcc (``/usr/include``)
# ``DATAROOTDIR`` # ``DATAROOTDIR``
# read-only architecture-independent data root (share) # read-only architecture-independent data root (``share``)
# ``DATADIR`` # ``DATADIR``
# read-only architecture-independent data (DATAROOTDIR) # read-only architecture-independent data (``DATAROOTDIR``)
# ``INFODIR`` # ``INFODIR``
# info documentation (DATAROOTDIR/info) # info documentation (``DATAROOTDIR/info``)
# ``LOCALEDIR`` # ``LOCALEDIR``
# locale-dependent data (DATAROOTDIR/locale) # locale-dependent data (``DATAROOTDIR/locale``)
# ``MANDIR`` # ``MANDIR``
# man documentation (DATAROOTDIR/man) # man documentation (``DATAROOTDIR/man``)
# ``DOCDIR`` # ``DOCDIR``
# documentation root (DATAROOTDIR/doc/PROJECT_NAME) # documentation root (``DATAROOTDIR/doc/PROJECT_NAME``)
# #
# Each CMAKE_INSTALL_<dir> value may be passed to the DESTINATION # If the includer does not define a value the above-shown default will be
# options of install() commands for the corresponding file type. If the # used and the value will appear in the cache for editing by the user.
# includer does not define a value the above-shown default will be used
# and the value will appear in the cache for editing by the user. Each
# CMAKE_INSTALL_FULL_<dir> value contains an absolute path constructed
# from the corresponding destination by prepending (if necessary) the
# value of CMAKE_INSTALL_PREFIX.
#============================================================================= #=============================================================================
# Copyright 2011 Nikita Krupen'ko <krnekit@gmail.com> # Copyright 2011 Nikita Krupen'ko <krnekit@gmail.com>