[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 01/01: Doc fixes.
From: |
Peter Schaffter |
Subject: |
[groff] 01/01: Doc fixes. |
Date: |
Thu, 15 Aug 2019 14:06:22 -0400 (EDT) |
PTPi pushed a commit to branch master
in repository groff.
commit 8d5492610c9780e3fd7c369f22b2f4036b7fe1f6
Author: Peter Schaffter <address@hidden>
Date: Thu Aug 15 14:05:38 2019 -0400
Doc fixes.
---
contrib/mom/momdoc/cover.html | 22 ++++++++++++++--------
contrib/mom/momdoc/goodies.html | 15 +++++++++++++++
contrib/mom/momdoc/toc.html | 4 ++--
3 files changed, 31 insertions(+), 10 deletions(-)
diff --git a/contrib/mom/momdoc/cover.html b/contrib/mom/momdoc/cover.html
index e18a1c3..5c815a9 100644
--- a/contrib/mom/momdoc/cover.html
+++ b/contrib/mom/momdoc/cover.html
@@ -504,10 +504,10 @@ will print
</div>
<div class="box-macro-args">
-Macro: <b>DOC_COVERTEXT</b> <kbd class="macro-args"><toggle></kbd>
+Macro: <b>DOC_COVERTEXT</b> <kbd class="macro-args">[START <starting
position>] <toggle></kbd>
</div>
<div class="box-macro-args" style="margin-top: 1em;">
-Macro: <b>COVERTEXT</b> <kbd class="macro-args"><toggle></kbd>
+Macro: <b>COVERTEXT</b> <kbd class="macro-args">[START <starting
position>] <toggle></kbd>
</div>
<p class="requires">
@@ -548,16 +548,22 @@ is the only allowed document element tag.
<p>
If you do not instruct mom to put anything on doc-cover or cover
pages except <kbd>DOC_COVERTEXT</kbd> or <kbd>COVERTEXT</kbd>, the
-cover text will begin at the document’s top margin. You must
+cover text will begin at the document’s top margin.
+Equally, if only <kbd>COPYRIGHT</kbd> and/or <kbd>MISC</kbd> are
+to go on the pages, cover text begins at the top margin. In all
+other cases, cover text begins below the last element on the page
+(excluding COPYRIGHT or MISC), separated by a blank line.
+</p>
+
+<p>
+If you wish to change the starting position of the text, you must
use
<a href="typesetting.html#space">SP</a>
or
<a href="typesetting.html#ald">ALD</a>
-to move it further down the page. Equally, if only
-<kbd>COPYRIGHT</kbd> and/or <kbd>MISC</kbd> are to go on the pages,
-cover text begins at the top margin. In all other cases, cover text
-begins below the last element on the page (excluding COPYRIGHT or
-MISC), separated by a blank line.
+to move it further down the page. Alternatively, you may use the
+optional START argument to give a precise location for the text to
+begin.
</p>
<p>
diff --git a/contrib/mom/momdoc/goodies.html b/contrib/mom/momdoc/goodies.html
index 24c1a27..046e07d 100644
--- a/contrib/mom/momdoc/goodies.html
+++ b/contrib/mom/momdoc/goodies.html
@@ -524,6 +524,21 @@ not
<span class="pre-in-pp">
\*[UC]All work and no play makes Jack a dull boy\*[LC].
</span>
+Conversely, an initial period must come <em>before</em>
+<kbd>\*[UC]</kbd>, or be preceded by <kbd>\&</kbd>, like this:
+<br/>
+<span class="pre-in-pp">
+ .\*[UC]start\*[LC] is used to begin document processing.
+</span>
+or
+<span class="pre-in-pp">
+ \*[UC]\&.start\*[LC] is used to begin document processing.
+</span>
+Upon output, either will produce
+<br/>
+<span class="pre-in-pp">
+ START is used to begin document processing.
+</span>
</p>
</div>
diff --git a/contrib/mom/momdoc/toc.html b/contrib/mom/momdoc/toc.html
index eb1df1d..1631624 100644
--- a/contrib/mom/momdoc/toc.html
+++ b/contrib/mom/momdoc/toc.html
@@ -20,7 +20,7 @@ FDL in the main directory of the groff source package.
<head>
<meta http-equiv="content-type" content="text/html;charset=utf-8"/>
- <title>Mom, version 2.4 -- Table of Contents</title>
+ <title>Mom, version 2.4-1 -- Table of Contents</title>
<link rel="stylesheet" type="text/css" href="stylesheet.css" />
</head>
@@ -31,7 +31,7 @@ FDL in the main directory of the groff source package.
<div class="page">
<div class="version">
- mom, version 2.4
+ mom, version 2.4-1
</div>
<h1 class="toc" style="margin-top: 9px;">Table of Contents</h1>
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 01/01: Doc fixes.,
Peter Schaffter <=