summaryrefslogtreecommitdiffstats
path: root/Help/prop_tgt/VERSION.rst
diff options
context:
space:
mode:
authorBartosz Kosiorek <bartosz.kosiorek@tomtom.com>2016-06-20 12:34:09 (GMT)
committerBrad King <brad.king@kitware.com>2016-06-23 17:44:26 (GMT)
commit00caa1dde8d7381ce98731af8b8083ca5b8b0be2 (patch)
tree5b14be8023dc57d0e6564923cc00ee3fbe4e5fc0 /Help/prop_tgt/VERSION.rst
parentd152ae123d1a3df456fe24f2e1a06d97083ad2d2 (diff)
downloadCMake-00caa1dde8d7381ce98731af8b8083ca5b8b0be2.zip
CMake-00caa1dde8d7381ce98731af8b8083ca5b8b0be2.tar.gz
CMake-00caa1dde8d7381ce98731af8b8083ca5b8b0be2.tar.bz2
Help: Describe VERSION and SOVERSION meanings for Mach-O binaries
Diffstat (limited to 'Help/prop_tgt/VERSION.rst')
-rw-r--r--Help/prop_tgt/VERSION.rst27
1 files changed, 20 insertions, 7 deletions
diff --git a/Help/prop_tgt/VERSION.rst b/Help/prop_tgt/VERSION.rst
index 87f6c49..66e7bde 100644
--- a/Help/prop_tgt/VERSION.rst
+++ b/Help/prop_tgt/VERSION.rst
@@ -3,14 +3,27 @@ VERSION
What version number is this target.
-For shared libraries VERSION and SOVERSION can be used to specify the
-build version and API version respectively. When building or
+For shared libraries ``VERSION`` and :prop_tgt:`SOVERSION` can be used
+to specify the build version and API version respectively. When building or
installing appropriate symlinks are created if the platform supports
symlinks and the linker supports so-names. If only one of both is
specified the missing is assumed to have the same version number. For
-executables VERSION can be used to specify the build version. When
+executables ``VERSION`` can be used to specify the build version. When
building or installing appropriate symlinks are created if the
-platform supports symlinks. For shared libraries and executables on
-Windows the VERSION attribute is parsed to extract a "major.minor"
-version number. These numbers are used as the image version of the
-binary.
+platform supports symlinks.
+
+Windows Versions
+^^^^^^^^^^^^^^^^
+
+For shared libraries and executables on Windows the ``VERSION``
+attribute is parsed to extract a ``<major>.<minor>`` version number.
+These numbers are used as the image version of the binary.
+
+Mach-O Versions
+^^^^^^^^^^^^^^^
+
+For shared libraries and executables on Mach-O systems (e.g. OS X, iOS),
+the :prop_tgt:`SOVERSION` property correspond to *compatibility version* and
+``VERSION`` to *current version*. See the :prop_tgt:`FRAMEWORK` target
+property for an example. Versions of Mach-O binaries may be checked with the
+``otool -L <binary>`` command.