[Groff-commit] groff ./ChangeLog ./NEWS src/preproc/eqn/eqn.man

[Werner LEMBERG]

CVSROOT:        /cvsroot/groff
Module name:    groff
Branch:         
Changes by:     Werner LEMBERG <address@hidden> 05/02/20 10:38:37

Modified files:
        .              : ChangeLog NEWS 
        src/preproc/eqn: eqn.man 

Log message:
        * src/preproc/eqn/eqn.man, NEWS: Document various extensions of
        eqn.

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/ChangeLog.diff?tr1=1.790&tr2=1.791&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/NEWS.diff?tr1=1.199&tr2=1.200&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/src/preproc/eqn/eqn.man.diff?tr1=1.9&tr2=1.10&r1=text&r2=text

Patches:
Index: groff/ChangeLog
diff -u groff/ChangeLog:1.790 groff/ChangeLog:1.791
--- groff/ChangeLog:1.790       Sat Feb 19 04:23:40 2005
+++ groff/ChangeLog     Sun Feb 20 10:38:36 2005
@@ -1,3 +1,8 @@
+2005-02-20  Werner LEMBERG  <address@hidden>
+
+       * src/preproc/eqn/eqn.man, NEWS: Document various extensions of
+       eqn.
+
 2005-02-17  Werner LEMBERG  <address@hidden>
 
        * doc/pic.ms, man/groff.man: Fix typos.
Index: groff/NEWS
diff -u groff/NEWS:1.199 groff/NEWS:1.200
--- groff/NEWS:1.199    Sat Dec 11 17:02:50 2004
+++ groff/NEWS  Sun Feb 20 10:38:37 2005
@@ -24,6 +24,34 @@
 o The `by' argument in a `for' loop can now be negative if it is additive.
   For the multiplicative case, it must be greater than zero.
 
+Eqn
+---
+
+o The following keywords aren't new but haven't been documented previously:
+
+    undef NAME    (to undefine a macro)
+    copy  "FILE"  (a synonym for `include')
+    space n       (to modify the vertical spacing before and after
+                   an equation)
+
+o The following macros aren't new but haven't been documented previously:
+
+    Alpha, ..., Omega   (the same as `ALPHA', ..., `OMEGA')
+    ldots               (three dots on the base line)
+    dollar              (a dollar glyph)
+
+o The following keywords have been extended.  Again, this isn't new but
+  hasn't been documented previously:
+
+    col n { ... }
+    lcol n { ... }
+    rcol n { ... }
+    ccol n { ... }
+    pile n { ... }
+    lpile n { ... }
+    rpile n { ... }
+    cpile n { ... }   (set vertical spacing between rows to N)
+
 Grohtml
 -------
 
Index: groff/src/preproc/eqn/eqn.man
diff -u groff/src/preproc/eqn/eqn.man:1.9 groff/src/preproc/eqn/eqn.man:1.10
--- groff/src/preproc/eqn/eqn.man:1.9   Sat Dec  4 11:55:12 2004
+++ groff/src/preproc/eqn/eqn.man       Sun Feb 20 10:38:37 2005
@@ -1,5 +1,5 @@
 .ig
-Copyright (C) 1989-2000, 2001, 2004 Free Software Foundation, Inc.
+Copyright (C) 1989-2000, 2001, 2004, 2005 Free Software Foundation, Inc.
 
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice
@@ -32,6 +32,13 @@
 ..
 .
 .
+.de TQ
+.  br
+.  ns
+.  TP \\$1
+..
+.
+.
 .\" The BSD man macros can't handle " in arguments to font change macros,
 .\" so use \(ts instead of ".
 .tr \(ts"
@@ -623,6 +630,51 @@
 .ft
 .RE
 .
+.TP
+.BI space\  n
+A positive value of the integer\~\c
+.I n
+(in hundredths of an em) sets the vertical spacing before the equation,
+a negative value sets the spacing after the equation, replacing the
+default values.
+This primitive provides an interface to
+.BR groff 's
+.B \ex
+escape (but with opposite sign).
+.
+.IP
+This keyword has no effect if the equation is part of a
+.B pic
+picture.
+.
+.SS Extended primitives
+.TP
+.BI col\  n\  {\  .\|.\|.\  }
+.TQ
+.BI ccol\  n\  {\  .\|.\|.\  }
+.TQ
+.BI lcol\  n\  {\  .\|.\|.\  }
+.TQ
+.BI rcol\  n\  {\  .\|.\|.\  }
+.TQ
+.BI pile\  n\  {\  .\|.\|.\  }
+.TQ
+.BI cpile\  n\  {\  .\|.\|.\  }
+.TQ
+.BI lpile\  n\  {\  .\|.\|.\  }
+.TQ
+.BI rpile\  n\  {\  .\|.\|.\  }
+The integer value\~\c
+.I n
+(in hundredths of an em) increases the vertical spacing between rows,
+using
+.BR groff 's
+.B \ex
+escape.
+Negative values are possible but have no effect.
+If there is more than a single value given in a matrix, the biggest one
+is used.
+.
 .SS Customization
 The appearance of equations is controlled by a large number of parameters.
 These can be set using
@@ -968,8 +1020,14 @@
 .
 .TP
 .BI include\ \(ts file \(ts
+.TQ
+.BI copy\ \(ts file \(ts
 Include the contents of
-.IR file .
+.I file
+.RB ( include
+and
+.B copy
+are synonyms).
 Lines of
 .I file
 beginning with
@@ -995,6 +1053,28 @@
 can be any character not appearing in
 .IR anything .
 .
+.TP
+.BI undef\  name
+Remove definition of
+.IR name ,
+making it undefined.
+.
+.LP
+Besides the macros mentioned above, the following definitions are available:
+.BR Alpha ,
+.BR Beta ,
+\&.\|.\|.,
+.B Omega
+(this is the same as
+.BR ALPHA ,
+.BR BETA ,
+\&.\|.\|.,
+.BR OMEGA ),
+.B ldots
+(three dots on the base line),
+and
+.BR dollar .
+.
 .SS Fonts
 .B eqn
 normally uses at least two fonts to set an equation:
@@ -1071,6 +1151,7 @@
 .SH "SEE ALSO"
 .BR groff (@MAN1EXT@),
 .BR @address@hidden (@MAN1EXT@),
+.BR @address@hidden (@MAN1EXT@),
 .BR groff_font (@MAN5EXT@),
 .I The\ \*(txbook
 .