[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Groff-commit] groff/contrib/mom om.tmac momdoc/docelement.html
From: |
Peter Schaffter |
Subject: |
[Groff-commit] groff/contrib/mom om.tmac momdoc/docelement.html |
Date: |
Wed, 06 Nov 2013 19:22:50 +0000 |
CVSROOT: /sources/groff
Module name: groff
Changes by: Peter Schaffter <PTPi> 13/11/06 19:22:50
Modified files:
contrib/mom : om.tmac
contrib/mom/momdoc: docelement.html
Log message:
Fixes to linenumbering; doc updates.
Fix to tbl handling for columns.
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/contrib/mom/om.tmac?cvsroot=groff&r1=1.83&r2=1.84
http://cvs.savannah.gnu.org/viewcvs/groff/contrib/mom/momdoc/docelement.html?cvsroot=groff&r1=1.43&r2=1.44
Patches:
Index: om.tmac
===================================================================
RCS file: /sources/groff/groff/contrib/mom/om.tmac,v
retrieving revision 1.83
retrieving revision 1.84
diff -u -b -r1.83 -r1.84
--- om.tmac 4 Nov 2013 08:20:34 -0000 1.83
+++ om.tmac 6 Nov 2013 19:22:49 -0000 1.84
@@ -1682,6 +1682,9 @@
. ds $CURRENT_TAB \\*[$CURRENT_TAB]
. nr #TAB_OFFSET\\*[$CURRENT_TAB] \\n[#TAB_OFFSET]
. nr #ST_OFFSET \\n[#TAB_OFFSET]
+. ie !'\\\\n[.z]'' \
+\!. po \\\\n[#L_MARGIN]u+\\\\n[#TAB_OFFSET\\\\*[$CURRENT_TAB]]u
+. el \
. po \\\\n[#L_MARGIN]u+\\\\n[#TAB_OFFSET\\\\*[$CURRENT_TAB]]u
. ll \\n[#TAB_LENGTH]u
. ta \En[.l]u
@@ -5572,6 +5575,10 @@
. if !r #LN_GUTTER .nr #LN_GUTTER 2
. if !r #Q_LN_GUTTER .nr #Q_LN_GUTTER 2
. if !r #BQ_LN_GUTTER .nr #BQ_LN_GUTTER 2
+. if !d $LN_FAM .ds $LN_FAM \\*[DOC_FAM]
+. if !d $LN_FT .ds $LN_FT R
+. if !d $LN_SIZE_CHANGE .ds $LN_SIZE_CHANGE +0
+. if !d $LN_COLOR .ds $LN_COLOR black
.\" PDF link colour
. if !\\n[PDFHREF_COLOR_SET] .PDF_LINK_COLOR 0.0 0.3 0.9
.\" String defaults for both PRINTSTYLEs
@@ -9581,6 +9588,9 @@
. nr #L_MARGIN \\n[.o]
. if \\n[#FN_DEPTH] .PROCESS_FN_LEFTOVER
. vs \\n[#SAVED_LEAD]u
+. if \\n[tbl*have-header] \{\
+. address@hidden
+. \}
. if \\n[#PREV_FN_DEFERRED] \{\
. nr #PREV_FN_DEFERRED 2
. \}
@@ -9648,6 +9658,7 @@
. rr #DIVERTED
. ch address@hidden
. wh \\n[nl]u+1u address@hidden
+. if \\n[tbl*have-header] address@hidden
. \}
. el .DO_FOOTER
. pdfmarkrestart
@@ -15578,6 +15589,14 @@
\#
.MAC NUMBER_LINES END
. br
+. if \\n[#QUOTE] \{\
+. if \\n[#QUOTE]=1 .ds macro QUOTE
+. if \\n[#QUOTE]=2 .ds macro BLOCKQUOTE
+. tm1 "[mom]: \\$0 at line \\n[.c] may not be used inside \\*[macro].
+. tm1 " Please set NUMBER_LINES before \\*[macro], followed by
+. tm1 " NUMBER_\\*[macro]_LINES.
+. ab Aborting '\\n[.F]'.
+. \}
. if '\\n[.z]'EPI_TEXT' .return
. if '\\$1'' \{\
. tm1 "[mom]: NUMBER_LINES at line \\n[.c] has no argument.
@@ -16976,7 +16995,10 @@
.END
\#
.MAC address@hidden END
-.\" Not currently used
+. if \\n[.ns] .rs
+. rr #DIVERTED
+. rr @TOP
+. ch address@hidden
.END
\#
.MAC tbl*float-warning END
Index: momdoc/docelement.html
===================================================================
RCS file: /sources/groff/groff/contrib/mom/momdoc/docelement.html,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -b -r1.43 -r1.44
--- momdoc/docelement.html 2 Nov 2013 00:15:13 -0000 1.43
+++ momdoc/docelement.html 6 Nov 2013 19:22:49 -0000 1.44
@@ -3063,7 +3063,7 @@
</ul></li>
<li><a href="#number-lines-control">Control macros and defaults</a>
<ul style="margin-left: -.5em;">
- <li><a href="#number-lines-control-quote">Line numbering control macros
for quotes and blockquotes</a></li>
+ <li><a href="#number-quote-lines">Line numbering control macros for quotes
and blockquotes</a></li>
</ul></li>
</ul>
@@ -3073,14 +3073,15 @@
<ul style="margin-top: -.5em;">
<li>numbers every line of paragraph text; line-numbering is
suspended for all other document processing tags (like
- docheaders, epigraphs, heads, subheads, etc.) and special
+ docheaders, epigraphs, headings, quotes, etc.) and special
pages (covers, endotes, bibliographies, etc.); be aware,
though, that if you turn
<a href="definitions.html#docheader">docheaders</a>
off (with
<a href="docprocessing.html#docheader">DOCHEADER</a> OFF)
and create your own docheader, mom
- <i>will</i> line-number your custom docheader
+ <i>will</i> line-number your custom docheader, so turn
+ line numbering on afterwards
</li>
<li>doesn’t touch your line length; line numbers are hung
outside your current left margin (as set with
@@ -3096,12 +3097,14 @@
</ul>
<p>
-Line numbering may be enabled and disabled for
-<kbd><a href="#quote">QUOTE</a></kbd>
-and/or
-<kbd><a href="#blockquote">BLOCKQUOTE</a></kbd>
-in one of three styles. See
-<a href="#number-lines-control-quote">Line numbering control macros for quotes
and blockquotes</a>.
+Mom expects that
+<kbd><a href="#quote">QUOTE</a></kbd>s
+and
+<kbd><a href="#blockquote">BLOCKQUOTE</a></kbd>s
+will not be line-numbered, however control macros
+are provided to enable line numbering for either.
+See
+<a href="#number-quote-lines">Line numbering control macros for quotes and
blockquotes</a>.
</p>
<!-- -NUMBER_LINES- -->
@@ -3124,19 +3127,36 @@
of paragraph text. One of the chief reasons for wanting numbered
lines is in order to identify footnotes or endnotes by line number
instead of by a marker in the text. (See
-<a href="#footnote-linenumbers">FOOTNOTE_MARKER_STYLE LINE</a>
+<a href="#footnotes-by-linenumber">Footnotes by linenumber</a>
for instructions on line-numbered footnotes, and
-<a href="#endnote-marker-style">ENDNOTE_MARKER_STYLE</a>
+<a href="#endnote-marker-style">ENDNOTE_MARKER_STYLE LINE</a>
for instructions on line-numbered endnotes.)
</p>
+<div class="box-tip">
+<p class="tip">
+<span class="note">Note:</span>
+Do not use <kbd>NUMBER_LINES</kbd> inside
+<a href="#quote">QUOTE</a>
+or
+<a href="#blockquote">BLOCKQUOTE</a>.
+By default, mom expects that quotes and blockquotes will not be
+line numbered. If you wish to enable line numbering for them, you
+must invoke
+<a href="#number-quote-lines">NUMBER_QUOTE_LINES</a>
+or
+<a href="#number-quote-lines">NUMBER_BLOCKQUOTE_LINES</a>.
+</p>
+</div>
+
+
<p>
The first time you invoke
<a href="#number-lines">NUMBER_LINES</a>
you must, at a minimum, tell it what line number you want the
<i>next</i>
<a href="definitions.html#outputline">output line</a>
-to have. The optional arguments which <kbd>lines to number</kbd>
+to have. The optional arguments <kbd>which lines to number</kbd>
and <kbd>gutter</kbd> allow you to state which lines should
be numbered (eg every five or every ten lines), and the gutter to
place between line numbers and
@@ -3301,11 +3321,12 @@
<ol style="margin-top: .5em; padding-bottom: .5em;">
<li><a href="#number-lines-general">Family/font/size/colour</a></li>
- <li><a href="#number-lines-control-quote">Line numbering control for quotes
and blockquotes</a>
- <ul style="margin-left: -.75em; list-style-type: disc;">
- <li><a href="#number-quote-lines">Number QUOTE lines</a></li>
- <li><a href="#number-blockquote-lines">Number BLOCKQUOTE lines</a></li>
- <li><a href="#number-lines-control-case">Numbering QUOTE and BLOCKQUOTE
lines on a case by case basis</a></li>
+ <li><a href="#number-quote-lines">Line numbering control for quotes and
blockquotes</a>
+ <ul>
+ <li><a href="#number-quote-lines-global">Including QUOTEs and BLOCKQUOTEs
in the line numbering scheme</a></li>
+ <li><a href="#number-quote-lines-selective">Selectively enabling line
numbering for QUOTEs and BLOCKQUOTEs</a></li>
+ <li><a href="#number-quote-lines-gutter">Changing the line number gutter
for QUOTEs and BLOCKQUOTEs</a></li>
+ <li><a href="#number-quote-lines-silent">Silently increment line numbers
during QUOTE and BLOCKQUOTE</a></li>
</ul></li>
</ol>
</div>
@@ -3325,184 +3346,127 @@
</span>
</div>
-<h4 id="number-lines-control-quote" class="docs" style="margin-top:
-1.75em;">2. Line numbering control macros for QUOTE and BLOCKQUOTE</h4>
+<h4 id="number-quote-lines" class="docs" style="margin-top: -1.75em;">2. Line
numbering control macros for QUOTE and BLOCKQUOTE</h4>
-<h5 id="number-quote-lines" class="docs" style="margin-top: 1em;">Number QUOTE
lines</h5>
+<h5 id="number-quote-lines-global" class="docs" style="font-size:
87%">• Including QUOTEs and BLOCKQUOTEs in the line numbering
scheme</h5>
<p>
-If you’d like mom to number lines of output text
-in a
+If you’d like mom to number lines in a
<a href="#quote">QUOTE</a>
-as part of the same order and sequence as paragraph text, simply
+or
+<a href="#blockquote">BLOCKQUOTE</a>
+as part of the same order and sequence as paragraph text,
invoke
<span class="pre-in-pp">
.NUMBER_QUOTE_LINES
</span>
-by itself.
-</p>
-
-<p>
-There is a catch with numbering quotes, though. Owing to groff’s
-restriction on accepting only the figure space as the line number
-gutter’s unit of measure, it is not possible for line numbers
-in quotes to hang outside a document’s overall left margin and
-be reliably flush with the line numbers of paragraph text.
-Conseqently, line numbers in quotes hang to the left of the quote,
-separated from the quote by the <kbd><gutter></kbd> argument.
-</p>
-
-<p>
-If you’d like to change the gutter for quotes line-numbered in
-this way, invoke <kbd>.NUMBER_QUOTE_LINES</kbd> with a digit
-representing the number of
-<a href="definitions.html#figurespace">figure spaces</a>
-you’d like between the line numbers and the quoted text, like this:
-<br/>
+or
<span class="pre-in-pp">
- .NUMBER_QUOTE_LINES 1
+ .NUMBER_BLOCKQUOTE_LINES
</span>
-With the above, line numbers in quotes (and only quotes) will have
-a gutter of 1 figure space.
+either before or after <kbd>NUMBER_LINES</kbd>. Both behave
+identically with respect to the affected macro (ie <kbd>QUOTE</kbd>
+or <kbd>BLOCKQUOTE</kbd>).
</p>
-<p>
-If you’re using "line numbering style" for footnotes
-(<a href="#footnote-marker-style">FOOTNOTE_MARKER_STYLE <kbd>LINE</kbd>)</a>,
-you may not wish to have quotes <i>visibly</i> line-numbered, but
-still want to embed footnotes inside quotes. In order to do that,
-mom allows you to say
-<span class="pre-in-pp">
- .NUMBER_QUOTE_LINES SILENT
-</span>
-When you invoke <kbd>.NUMBER_QUOTE_LINES SILENT</kbd>,
-mom continues to increment line numbers while quotes are being
-output, but they won’t appear in the output copy. (Compare
-this with mom’s default behaviour of <i>suspending</i>
-incrementing of line numbers during the output of quotes.) This
-allows you to embed line-numbered footnotes inside quotes and have
-the line number label in the footnote come out sensibly.
-</p>
+<h5 id="number-quote-lines-selective" class="docs" style="font-size:
87%">• Selectively enabling line numbering for QUOTEs and
BLOCKQUOTEs</h5>
<p>
-Once having turned NUMBER_QUOTE_LINES on, you may disable it with
-<span class="pre-in-pp">
- .NUMBER_QUOTE_LINES OFF
-</span>
-(or <kbd>QUIT, END, X,</kbd> etc).
+If you’d like to enable line numbering
+selectively for quotes and blockquotes <i>only</i>, enable
+<kbd>NUMBER_QUOTE_LINES</kbd> or <kbd>NUMBER_BLOCKQUOTE_LINES</kbd>
+first, followed by <kbd>NUMBER_LINES <n></kbd>, where
+<kbd><n></kbd> is the first line number of the quote
+or blockquote. Afterwards, enter your <kbd>QUOTE</kbd> or
+<kbd>BLOCKQUOTE</kbd>. When the quote or blockquote is finished (ie
+after <kbd>QUOTE OFF</kbd> or <kbd>BLOCKQUOTE OFF</kbd>),
+turn line numbering off. Each subsequent quote or blockquote you
+want line numbered requires only <kbd>NUMBER_LINES <n></kbd>
+(with a corresponding <kbd>NUMBER_LINES OFF</kbd>) until you turn
+<kbd>NUMBER_QUOTE_LINES</kbd> or <kbd>NUMBER_BLOCKQUOTE_LINES</kbd>
+off.
</p>
-<h5 id="number-blockquote-lines" class="docs">Number BLOCKQUOTE lines</h5>
-
<p>
-If you’d like mom to number lines of output text
-in a
-<a href="#quote">BLOCKQUOTE</a>
-as part of the same order and sequence as paragraph text, simply
-invoke
+Here’s a recipe where the first line number of quotes starts
+repeatedly at “1”.
<span class="pre-in-pp">
- .NUMBER_BLOCKQUOTE_LINES
+ <running text>
+ .NUMBER_QUOTE_LINES
+ .NUMBER_LINES 1
+ .QUOTE
+ <text of quote>
+ .QUOTE OFF
+ .NUMBER_LINES OFF
+ <further running text>
+ .NUMBER_LINES 1
+ .QUOTE
+ <text of quote>
+ .QUOTE OFF
+ .NUMBER_LINES OFF
+ <further running text>
</span>
-by itself.
</p>
+<h5 id="number-quote-lines-gutter" class="docs" style="font-size:
87%">• Changing the line number gutter for QUOTEs and BLOCKQUOTEs</h5>
+
<p>
-There is a catch with numbering blockquotes, though. Owing to
-groff’s restriction of accepting only the figure space as the
-line number gutter’s unit of measure, it is not possible for line
-numbers in blockquotes to hang outside a document’s overall left
+Owing to groff’s restriction on accepting only the figure
+space as the line number
+<a href="definitions.html#gutter">gutter</a>’s
+unit of measure, it is not possible for line numbers in quotes
+or blockquotes to hang outside a document’s overall left
margin and be reliably flush with the line numbers of paragraph
-text. Conseqently, line numbers in blockquotes hang to the
-left of the blockquote, separated from the blockquote by the
-<kbd><gutter></kbd> argument.
+text. Conseqently, line numbers in quotes or blockquotes hang
+to the left of the quote, separated by the currently active
+gutter for <kbd>NUMBER_LINES</kbd>.
</p>
<p>
-If you’d like to change the gutter for blockquotes line-numbered in
-this way, invoke
-<span class="pre-in-pp">
- .NUMBER_BLOCKQUOTE_LINES
-</span>
-with a digit representing the number of
+If you’d like to change the line number gutter for
+quotes or blockquotes, invoke <kbd>NUMBER_QUOTE_LINES</kbd> or
+<kbd>NUMBER_BLOCKQUOTE_LINES</kbd> with a digit representing the
+number of
<a href="definitions.html#figurespace">figure spaces</a>
-you’d like between the line numbers and the blockquoted text, like
-this:
+you’d like between the line numbers and the quoted text, like this:
<br/>
<span class="pre-in-pp">
- .NUMBER_BLOCKQUOTE_LINES 1
+ .NUMBER_QUOTE_LINES 3
</span>
-
-With the above, line numbers in blockquotes (and only blockquotes)
-will have a gutter of 1 figure space.
+With the above, line numbers in quotes (and only quotes) will have
+a gutter of 3 figure spaces.
</p>
+<h5 id="number-quote-lines-silent" class="docs" style="font-size:
87%">• Silently increment line numbers during QUOTE and
BLOCKQUOTE</h5>
+
<p>
-If you are using "line numbering style" for footnotes
-(<a href="#footnote-marker-style">FOOTNOTE_MARKER_STYLE <kbd>LINE</kbd>)</a>,
-you may not wish to have blockquotes <i>visibly</i> line-numbered,
-but still want to embed footnotes inside blockquotes. In order to
-do that, mom allows you to say
+If you’ve asked mom not to line number quotes or blockquotes,
+but would like line numbering to continue while they’re
+being output (as opposed to mom’s default behaviour of
+<i>suspending</i> incrementing of line numbers during the output of
+quotes and blockquotes), invoke
+<span class="pre-in-pp">
+ .NUMBER_QUOTE_LINES SILENT
+</span>
+or
<span class="pre-in-pp">
.NUMBER_BLOCKQUOTE_LINES SILENT
</span>
-When you invoke <kbd>.NUMBER_BLOCKQUOTE_LINES SILENT</kbd>,
-mom continues to increment line numbers while blockquotes are being
-output, but they won’t appear in the output copy. (Compare
-this with mom’s default behaviour of <i>suspending</i>
-incrementing of line numbers during the output of blockquotes.)
-This allows you to embed line-numbered footnotes inside blockquotes
-and have the line number label in the footnote come out sensibly.
+With these, mom continues to increment line numbers while quotes
+or blockquotes are being output, but the line numbers won’t
+appear in the output copy.
</p>
<p>
-Once having turned NUMBER_BLOCKQUOTE_LINES on, you may disable it
-with
+Once having turned <kbd>NUMBER_QUOTE_LINES</kbd> or
+<kbd>NUMBER_BLOCKQUOTE_LINES</kbd> on, you may disable them with
<span class="pre-in-pp">
- .NUMBER_BLOCKQUOTE_LINES OFF
+ .NUMBER_QUOTE_LINES OFF
</span>
-(or <kbd>QUIT, END, X,</kbd> etc).
-</p>
-
-<h4 id="number-lines-control-case" class="docs" style="margin-top: -.25em;">3.
Numbering QUOTE and BLOCKQUOTE lines on a case by case basis</h4>
-
-<p>
-Sometimes, you may want quotes or blockquotes to have a different
-line numbering scheme from the one used in the rest of the document.
-Or, you may want line numbering enabled only inside a particular
-quote or blockquote. A common reason for this would be if you were
-using the
-<a href="#quote">QUOTE</a>
-macro to insert lines of programming code into a document.
-</p>
-
-<p>
-To enable line numbering within quotes or blockquotes on a case by
-case basis, simply invoke
-<a href="#number-lines">NUMBER_LINES</a>
-with the arguments you need immediately after entering
-<kbd><a href="#quote">.QUOTE</a></kbd>
or
-<kbd><a href="#blockquote">.BLOCKQUOTE</a></kbd>.
-(<a href="number-quote-lines">NUMBER_QUOTE_LINES</a>
-and/or
-<a href="number-blockquote-lines">NUMBER_BLOCKQUOTE_LINES</a>
-should be turned off if you’re doing this.) The quote
-or blockquote will then be line-numbered according to your
-specifications: the starting line number of the quote or blockquote
-will be the one you give as a first argument to NUMBER_LINES; which
-lines to number will be the value you pass to <kbd>which lines
-to number</kbd> (defaults to <kbd>1</kbd>); line numbers will
-hang to the left of the quote or blockquote, separated from the
-quote or blockquote by <kbd>gutter</kbd> (defaults to <kbd>2</kbd>).
-</p>
-
-<p>
-As soon as QUOTE or BLOCKQUOTE is turned off, line numbering ceases,
-not only with respect to subsequent paragraph text (if they are
-not being line-numbered), but also for any subsequent invocation
-of <kbd>.QUOTE</kbd> or <kbd>.BLOCKQUOTE</kbd>. In other words,
-you must re-enable quote or blockquote line-numbering inside every
-instance of QUOTE or BLOCKQUOTE when line-numbering either of them
-on a case by case basis.
+<span class="pre-in-pp">
+ .NUMBER_BLOCKQUOTE_LINES OFF
+</span>
</p>
<div class="rule-short"><hr/></div>
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Groff-commit] groff/contrib/mom om.tmac momdoc/docelement.html,
Peter Schaffter <=