summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPavlina Moravcova Varekova <pmoravco@redhat.com>2019-09-10 12:11:39 +0200
committerPanu Matilainen <pmatilai@redhat.com>2019-11-18 12:46:29 +0200
commitcb0493a67b35c9dc520afc3f3c5a19d3a1824e07 (patch)
treefe820418954f46991eccb99ed236e5104b112653
parente077f749709c8a50a873c0ef10b1b509c2c79102 (diff)
downloadrpm-cb0493a67b35c9dc520afc3f3c5a19d3a1824e07.tar.gz
Add description of comments in spec documentation
(cherry picked from commit 22c26c7444c32dfe6b75b250b247b5d57f989ba6)
-rw-r--r--doc/manual/spec22
1 files changed, 22 insertions, 0 deletions
diff --git a/doc/manual/spec b/doc/manual/spec
index 4c3c7a9d5..a84047e97 100644
--- a/doc/manual/spec
+++ b/doc/manual/spec
@@ -214,6 +214,28 @@ can express this as
BuildConflicts: gcc <= 2.7.2.1
\endverbatim
+\section comments Comments
+
+Comments in spec file have # at the start of the line.
+
+\verbatim
+ # this is a comment
+\endverbatim
+
+Macros are expanded even in comment lines. If this is undesireable, escape
+the macro with an extra percent sign (%):
+
+\verbatim
+ # make unversioned %%__python an error unless explicitly overridden
+\endverbatim
+
+Another option is to use built-in macro %dnl that discards text to next
+line without expanding it.
+
+\verbatim
+ %dnl make unversioned %__python an error unless explicitly overridden
+\endverbatim
+
\section conditionals Conditionals
RPM's spec file format allows conditional blocks of code to be used