aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKaren Arutyunov <karen@codesynthesis.com>2018-12-01 23:34:08 +0300
committerKaren Arutyunov <karen@codesynthesis.com>2018-12-02 17:22:24 +0300
commit799540f57efca428b864ec1952f0787de1997fca (patch)
tree88579987eae59f67d3fb227ad8c1d0580050d959
parent564d35474958002a5690c8e98163e904cad49d0a (diff)
Regularize value comments in manifest examples in manual
Make value comments full sentences, separate from the value with a space and align in value blocks.
-rw-r--r--doc/manual.cli34
1 files changed, 17 insertions, 17 deletions
diff --git a/doc/manual.cli b/doc/manual.cli
index ea6079b..5f53e66 100644
--- a/doc/manual.cli
+++ b/doc/manual.cli
@@ -463,7 +463,7 @@ which are ignored, these comments are considered to be part of the value. For
example:
\
-email: foo-users@example.com; Public mailing list.
+email: foo-users@example.com ; Public mailing list.
\
It is recommended that you keep comments short, single-sentence. Note that
@@ -639,8 +639,8 @@ For complex licensing schemes it is recommended to add comments as an aid to
the user, for example:
\
-license: LGPLv2, MIT; If linking with GNU TLS.
-license: BSD; If linking with OpenSSL.
+license: LGPLv2, MIT ; If linking with GNU TLS.
+license: BSD ; If linking with OpenSSL.
\
To assist automated processing, the following pre-defined values should be
@@ -882,10 +882,10 @@ For example:
\
depends: libz
-depends: libfoo ~1.2.0; Only works with libfoo 1.2.*.
+depends: libfoo ~1.2.0 ; Only works with libfoo 1.2.*.
depends: libgnutls >= 1.2.3 | libopenssl >= 2.3.4
-depends: ? libboost-regex >= 1.52.0; Only if no C++11 <regex>.
-depends: ? libqtcore >= 5.0.0; Only if GUI is enabled.
+depends: ? libboost-regex >= 1.52.0 ; Only if no C++11 <regex>.
+depends: ? libqtcore >= 5.0.0 ; Only if GUI is enabled.
\
It is recommended that you specify unconditional dependencies first with
@@ -969,7 +969,7 @@ libraries, that is, the ones not packaged or not in the repository. In this
case it may make sense to also specify the version constraint. For example:
\
-requires: zlib >= 1.2.0; Most systems already have it or get from zlib.net.
+requires: zlib >= 1.2.0 ; Most systems already have it or get from zlib.net.
\
It is recommended that you specify unconditional requirements first with
@@ -1047,14 +1047,14 @@ against the underlying set. The term itself can be either the class name or a
parenthesized expression. Some examples:
\
-builds: none ; None
-builds: all ; All
-builds: default legacy ; Default and legacy
-builds: -windows ; Default except Windows
-builds: all : -windows ; All except Windows
-builds: all : &gcc ; All with GCC only
-builds: gcc : -optimized ; GCC without optimization
-builds: gcc : &( +linux +macos ) ; GCC on Linux or Mac OS
+builds: none ; None.
+builds: all ; All.
+builds: default legacy ; Default and legacy.
+builds: -windows ; Default except Windows.
+builds: all : -windows ; All except Windows.
+builds: all : &gcc ; All with GCC only.
+builds: gcc : -optimized ; GCC without optimization.
+builds: gcc : &( +linux +macos ) ; GCC on Linux or Mac OS.
\
Notice that the colon and parentheses must be separated with spaces from both
@@ -1068,8 +1068,8 @@ the expression. For example:
\
builds: default experimental ; Only modern compilers are supported.
-builds: -gcc ; GCC is not supported
-builds: -clang ; Clang is not supported
+builds: -gcc ; GCC is not supported.
+builds: -clang ; Clang is not supported.
\
\N|The \c{builds} value comments are used by the web interface (\c{brep}) to