[Groff-commit] groff/contrib/mom BUGS om.tmac momdoc/rectovers...

[Peter Schaffter]

CVSROOT:        /sources/groff
Module name:    groff
Changes by:     Peter Schaffter <PTPi>  12/09/06 21:14:42

Modified files:
        contrib/mom    : BUGS om.tmac 
        contrib/mom/momdoc: rectoverso.html refer.html 
                            tables-of-contents.html 

Log message:
        Fixes missing period after page number(s) in some reference types
        generated with refer.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/contrib/mom/BUGS?cvsroot=groff&r1=1.50&r2=1.51
http://cvs.savannah.gnu.org/viewcvs/groff/contrib/mom/om.tmac?cvsroot=groff&r1=1.66&r2=1.67
http://cvs.savannah.gnu.org/viewcvs/groff/contrib/mom/momdoc/rectoverso.html?cvsroot=groff&r1=1.16&r2=1.17
http://cvs.savannah.gnu.org/viewcvs/groff/contrib/mom/momdoc/refer.html?cvsroot=groff&r1=1.14&r2=1.15
http://cvs.savannah.gnu.org/viewcvs/groff/contrib/mom/momdoc/tables-of-contents.html?cvsroot=groff&r1=1.4&r2=1.5

Patches:
Index: BUGS
===================================================================
RCS file: /sources/groff/groff/contrib/mom/BUGS,v
retrieving revision 1.50
retrieving revision 1.51
diff -u -b -r1.50 -r1.51
--- BUGS        31 Aug 2012 22:49:57 -0000      1.50
+++ BUGS        6 Sep 2012 21:14:42 -0000       1.51
@@ -25,6 +25,10 @@
 Version 2.0
 ===========
 
+Terminal period after page number(s) in refer items not always
+printing.
+---Fixed---
+
 ====================================================================
 
 Version 6-a

Index: om.tmac
===================================================================
RCS file: /sources/groff/groff/contrib/mom/om.tmac,v
retrieving revision 1.66
retrieving revision 1.67
diff -u -b -r1.66 -r1.67
--- om.tmac     31 Aug 2012 22:49:57 -0000      1.66
+++ om.tmac     6 Sep 2012 21:14:42 -0000       1.67
@@ -11764,8 +11764,6 @@
 .    FAMILY  \\*[$PAGE_NUM_FAM]
 .    FT      \\*[$PAGE_NUM_FT]
 .    PT_SIZE \\n[#DOC_PT_SIZE]u\\*[$PAGE_NUM_SIZE_CHANGE]
-\#.    if \\n[#TOC] .ab \\n[.ps]
-\#.    if \\n[#TOC] .tm \\n[#TOC_PS]\\*[$TOC_PN_SIZE_CHANGE]
 .    if \\n[#PRINT_STYLE]=1 .TYPEWRITER
 .    if \\n[#PAGE_NUM_V_POS]=1 .vs 0
 .    if o \{\
@@ -17417,7 +17415,7 @@
 .ie '\\*[$REF_STYLE]'NOTE' \{\
 .   ie \\n[ref*type]=1 .ref*field P : "" .
 .   el .ref*field P "" "\|"
-.   nr ref*suppress-period 1
+.   if \\n[ref*type]=1 .nr ref*suppress-period 1
 .\}
 .el \{\
 .   ie \\n[ref*type]=1 .ref*field P \|:

Index: momdoc/rectoverso.html
===================================================================
RCS file: /sources/groff/groff/contrib/mom/momdoc/rectoverso.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -b -r1.16 -r1.17
--- momdoc/rectoverso.html      31 Aug 2012 22:49:59 -0000      1.16
+++ momdoc/rectoverso.html      6 Sep 2012 21:14:42 -0000       1.17
@@ -281,17 +281,30 @@
 <div class="box-tip">
 <p class="tip">
 <span class="tip">Tip:</span>
-If the last
-<a href="definitions.html#outputline">output line</a>
-of a document before COLLATE falls too close to the bottom margin
-for running text, mom may output a blank page with only a header
-or footer between collated documents.  In order to avoid this, I
-recommend always preceding COLLATE with
-<kbd><a href="typesetting.html#el">.EL</a></kbd>,
-like this
+If the last line of text before <kbd>.COLLATE</kbd>
+falls too close to the bottom margin, or if the line is followed
+by a macro likely to cause a linebreak (eg <kbd>.LIST OFF</kbd> or
+<kbd>.IQ</kbd>), mom may output a superfluous blank page before
+the start of the following document.
+</p>
+
+<p class="tip-bottom">
+In order to avoid this, insert
+<a href="docprocessing.html#EL"><kbd>.EL</kbd></a>
+after the last line of text, before <kbd>.COLLATE</kbd> and/or any
+concluding macros.  For example,
+<br/>
+<span class="pre-in-pp">
+  some concluding text.
+  .EL
+  .COLLATE
+</span>
+or
 <br/>
 <span class="pre-in-pp">
+  some concluding text.
   .EL
+  .LIST OFF
   .COLLATE
 </span>
 </p>

Index: momdoc/refer.html
===================================================================
RCS file: /sources/groff/groff/contrib/mom/momdoc/refer.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -b -r1.14 -r1.15
--- momdoc/refer.html   31 Aug 2012 22:49:59 -0000      1.14
+++ momdoc/refer.html   6 Sep 2012 21:14:42 -0000       1.15
@@ -253,7 +253,7 @@
 
 <p style="margin-top: .5em;">
 If you want a bibliography, place this block at the <i>bottom</i> of
-your mom file, prior to invoking
+your mom file, either prior to or immediately after invoking
 <a href="#bibliography">BIBLIOGRAPHY</a>.
 </p>
 

Index: momdoc/tables-of-contents.html
===================================================================
RCS file: /sources/groff/groff/contrib/mom/momdoc/tables-of-contents.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -b -r1.4 -r1.5
--- momdoc/tables-of-contents.html      31 Aug 2012 22:49:59 -0000      1.4
+++ momdoc/tables-of-contents.html      6 Sep 2012 21:14:42 -0000       1.5
@@ -285,6 +285,38 @@
 very end of your document.  Mom takes care of the rest.
 </p>
 
+<div class="box-tip">
+<p class="tip">
+<span class="tip">Tip:</span>
+If the last line of text in a document, before <kbd>.TOC</kbd>,
+falls too close to the bottom margin, or if the line is followed
+by a macro likely to cause a linebreak (eg <kbd>.LIST OFF</kbd> or
+<kbd>.IQ</kbd>), mom may output a superfluous blank page before the
+Table of Contents.
+</p>
+
+<p class="tip-bottom">
+In order to avoid this, insert
+<a href="docprocessing.html#EL"><kbd>.EL</kbd></a>
+after the last line of text, before <kbd>.TOC</kbd> and/or any
+concluding macros.  For example,
+<br/>
+<span class="pre-in-pp">
+  some concluding text.
+  .EL
+  .TOC
+</span>
+or
+<br/>
+<span class="pre-in-pp">
+  some concluding text.
+  .EL
+  .LIST OFF
+  .TOC
+</span>
+</p>
+</div>
+
 <div class="rule-short"><hr/></div>
 
 <h2 id="toc-control-top" class="macro-group">Control macros for tables of 
contents</h2>