[Groff-commit] groff ./ChangeLog ./MANIFEST ./README doc/webpa...

[Werner LEMBERG]

CVSROOT:        /cvsroot/groff
Module name:    groff
Branch:         
Changes by:     Werner LEMBERG <address@hidden> 05/05/27 07:10:53

Modified files:
        .              : ChangeLog MANIFEST README 
        doc            : webpage.ms 

Log message:
        * MANIFEST, README, doc/webpage.ms: Updated.

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/ChangeLog.diff?tr1=1.828&tr2=1.829&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/MANIFEST.diff?tr1=1.9&tr2=1.10&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/README.diff?tr1=1.12&tr2=1.13&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/doc/webpage.ms.diff?tr1=1.17&tr2=1.18&r1=text&r2=text

Patches:
Index: groff/ChangeLog
diff -u groff/ChangeLog:1.828 groff/ChangeLog:1.829
--- groff/ChangeLog:1.828       Thu May 26 21:01:56 2005
+++ groff/ChangeLog     Fri May 27 07:10:53 2005
@@ -1,3 +1,7 @@
+2005-05-27  Werner LEMBERG  <address@hidden>
+
+       * MANIFEST, README, doc/webpage.ms: Updated.
+
 2005-05-26  Werner LEMBERG  <address@hidden>
 
        * All affected files: Update postal address of FSF.
Index: groff/MANIFEST
diff -u groff/MANIFEST:1.9 groff/MANIFEST:1.10
--- groff/MANIFEST:1.9  Thu Jun  3 06:24:23 2004
+++ groff/MANIFEST      Fri May 27 07:10:53 2005
@@ -1,10 +1,10 @@
 MANIFEST 
 
-Last update: 1 June 2004
+Last update: 26 May 2005
 
 This file is part of groff, the GNU roff type-setting system.
 
-Copyright (C) 2001, 2003, 2004 Free Software Foundation, Inc.
+Copyright (C) 2001, 2003, 2004, 2005 Free Software Foundation, Inc.
 written by Bernd Warken <address@hidden>
 maintained by Werner Lemberg <address@hidden>
 
@@ -38,7 +38,6 @@
   PROBLEMS      Tips to handle known critical situations.
   PROJECTS      Long-term additions to groff.
   README        Availability and contact information for groff.
-  README.CVS    Development build information.
   README.MinGW  Build information for MinGW.
   TODO          Things planned for future groff versions.
 
@@ -55,10 +54,15 @@
 ./contrib       Part of groff, but maintained by other people.
   eqn2graph     Convert equations created with EQN into different
                 graphical formats.
+  gdiffmk       An improved implementation of the diffmk command to mark
+                differences between groff/nroff/troff files.
   grap2graph    Convert grap diagraps into different graphical formats.
   groffer       A wrapper to conveniently view roff files.
   mm            The groff mm macro package.
   mom           The groff mom macro package.
+  pdfmark       A package to add PDF marks to groff documents, together
+                with a shell script (pdfroff) for easy creation of PDF
+                documents.
   pic2graph     Convert PIC diagrams into different graphical formats.
 
 ./doc           Manuals and tutorials to groff aspects.
Index: groff/README
diff -u groff/README:1.12 groff/README:1.13
--- groff/README:1.12   Wed May 25 18:25:21 2005
+++ groff/README        Fri May 27 07:10:53 2005
@@ -20,18 +20,18 @@
 in compiling, installing, and running groff.
 
 The most recent released version of groff is always available by
-anonymous ftp from ftp.gnu.org in the directory pub/gnu/groff.
+anonymous ftp from ftp.gnu.org in the directory gnu/groff.
 
 The current development version of groff is available from a CVS
 repository.  You can access it by first selecting a parent directory in
-which to create a working copy, (call it, say ~/cvswork), and then
+which to create a working copy (call it, say, ~/cvswork), and then
 executing the commands
 
   cd ~/cvswork
   CVS_RSH=ssh; export CVS_RSH
   cvs -d:ext:address@hidden/cvsroot/groff -z5 co groff
 
-(Note that you need an SSH client for security reasons).
+(Note that you need an SSH client for security reasons.)
 
 This will create a subdirectory, ~/cvswork/groff, with a `checked out'
 copy of the CVS repository.  An update of this working copy may be
@@ -47,8 +47,8 @@
 
   http://savannah.gnu.org/cvs/?group=groff
 
-Alternatively, you can download snapshots. The complete groff source
-as a single file is available at
+Alternatively, you can download snapshots (which are updated twice a day).
+The complete groff source as a single file is available at
 
   http://groff.ffii.org/groff/devel/groff-current.tar.gz
 
Index: groff/doc/webpage.ms
diff -u groff/doc/webpage.ms:1.17 groff/doc/webpage.ms:1.18
--- groff/doc/webpage.ms:1.17   Wed Nov 24 14:18:21 2004
+++ groff/doc/webpage.ms        Fri May 27 07:10:53 2005
@@ -120,40 +120,52 @@
 The file PROBLEMS describes various problems that have been encountered in
 compiling, installing, and running groff.
 
-The most recent released version of groff is always available by anonymous
-ftp from ftp.gnu.org in the directory pub/\:gnu/\:groff.
+The most recent released version of groff is always available by
+.URL "ftp://\:ftp.gnu.org/\:gnu/\:groff"; "anonymous ftp" .
 
-A
-.URL "http://\:savannah.gnu.org/\:cvs/\:?group=groff"; "CVS repository"
-is available, containing the current development version of groff.
-You can access it with the commands
+The current development version of groff is available from a
+.URL "http://\:savannah.gnu.org/\:cvs/\:?group=groff"; "CVS repository" .
+You can access it by first selecting a parent directory in
+which to create a working copy (call it, say, ~/cvswork), and then
+executing the commands
 
 .in 2m
 .nf
 .ft C
-export CVSROOT=:ext:address@hidden:/cvsroot/groff
-export CVS_RSH=ssh
-cvs -z9 co groff
+cd ~/cvswork
+CVS_RSH=ssh; export CVS_RSH
+cvs -d:ext:address@hidden/cvsroot/groff -z5 co groff
 .ft P
 .fi
 .in
 
-Note that you need an SSH client for security reasons.    
+(Note that you need an SSH client for security reasons.)
 
-An update of a checked out repository should be done with
+This will create a subdirectory, ~/cvswork/groff, with a `checked out'
+copy of the CVS repository.
+An update of this working copy may be
+achieved, at any later time by invoking the commands
 
 .in 2m
+.nf
 .ft C
-CVS_RSH=ssh cvs -z9 update -dP
+cd ~/cvswork/groff
+CVS_RSH=ssh cvs -z5 update -dP
 .ft P
+.fi
 .in
 
-Please read the info pages of cvs for further details.
+Please read the CVS info pages for further details.
+
+Finally, it is possible to access the CVS with a
+.URL http://\:savannah.gnu.org/\:cvs/\:?group=groff "web browser" .
 
-Alternatively, you can download snapshots (which are updated twice a day)
-from
-.URL http://\:groff.ffii.org/\:groff/\:devel/\:groff-current.tar.gz here
-or a diff file relative to the latest official groff release as
+Alternatively, you can download snapshots (which are updated twice a day).
+The complete groff source as a single file is available
+.URL http://\:groff.ffii.org/\:groff/\:devel/\:groff-current.tar.gz here .
+
+A diff file relative to groff-\[la]version\[ra], the latest official groff
+release is available at
 
 .in 2m
 .ft C
@@ -175,14 +187,34 @@
 .fi
 .in
 
-Finally, it is possible to access the CVS with a browser by pointing it
-to
+Depending on your requirements, you may need at least some of the
+following tools to build groff directly from its source:
 
 .in 2m
-.URL http://savannah.gnu.org/cvs/?group=groff \
-     http://savannah.gnu.org/cvs/?group=groff
+.nf
+ghostscript
+the psutils package
+the netpbm package
+texinfo 4.8
+bison \[>=] 1.875b or byacc
+.fi
 .in
 
+Note that texinfo and bison or byacc are required only for building from
+CVS sources (either a checked out working copy, or a daily snapshot).
+They are not required for building from a stable release tarball.
+Also note that the version numbers stated are the minimum supported.
+No version of texinfo < 4.8 will work, and the original release of bison
+1.875 is known not to work; you \fImay\fP find that bison releases < 1.875
+will work, but in case of difficulty, please update to a later version
+\fIbefore\fP posting a bug report.
+
+For \fIall\fP sources, you need ghostscript for creation of either PDF or
+HTML output; the netpbm and psutils packages are required only for HTML
+output.
+If you don't intend to produce output in either of these formats, then
+these packages are unnecessary.
+
 Please report bugs using the form in the file BUG-REPORT; the idea of this
 is to make sure that FSF has all the information it needs to fix the bug.
 At the very least, read the BUG-REPORT form and make sure that you supply
@@ -207,16 +239,26 @@
 a read-only list showing commitments to the CVS repository
 .ULE
 
-You must be subscribed to the `groff' list to send mails.
+You can post mails directly to the `bug-groff' list, without subscribing;
+to post mails to the `groff' list you must subscribe to it.
 
 To subscribe, send e-mail to address@hidden
 (example:
-.MTO address@hidden:gnu.org address@hidden:gnu.org )
-with the word `subscribe' in either the
-subject or body of the e-mail (don't include the quotes) or have a look
-at the
-.URL http://\:lists.gnu.org/\:mailman/\:listinfo/\:groff/ \
-     "groff mailing list webpage" .
+.MTO address@hidden:gnu.org address@hidden:gnu.org
+for the `groff' list) with the word `subscribe' in either the
+subject or body of the e-mail (don't include the quotes).
+Alternatively, you may subscribe by visiting the web pages at
+
+.in 2m
+.nf
+.URL http://lists.gnu.org/mailman/listinfo/bug-groff
+.URL http://lists.gnu.org/mailman/listinfo/groff
+.URL http://lists.gnu.org/mailman/listinfo/groff-commit
+.fi
+.in
+
+Each of these web pages also provides a link to a browseable archive of
+postings to the corresponding mailing list.
 
 GNU groff was written by
 .MTO address@hidden:jclark.com "James Clark" .
@@ -227,6 +269,257 @@
 .
 .
 .SH
+NEWS VERSION 1.19.2
+.
+.SH 2 troff
+
+.ULS
+.LI
+Analogously to the .ft and \ef pair, two new requests `gcolor' and
+`fcolor' (which pair with \em and \eM, respectively) have been added to
+set the glyph and background colours.
+
+.LI
+A new read-only, string-valued register `.sty' returns the name of the
+current style.
+
+.LI
+Two new conditional operators `F\~\[la]name\[ra]' and `S\~\[la]name\[ra]'
+have been added.
+`F' is true if a font \[la]name\[ra] exists.
+`S' is true if a style \[la]name\[ra] has been registered.
+
+.LI
+Cyrillic characters have been added to the `utf8' and `html' output
+devices.
+.ULE
+.
+.
+.SH 2
+pic
+
+.ULS
+.LI
+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.
+.ULE
+.
+.
+.SH 2
+eqn
+
+.ULS
+.LI
+The following keywords aren't new but haven't been documented previously:
+
+.in 2m
+\fBundef NAME\fP (to undefine a macro)
+.br
+\fBcopy "FILE"\fP (a synonym for `include')
+.br
+\fBspace n\fP (to modify the vertical spacing before and after an equation)
+.in
+
+.LI
+The following macros aren't new but haven't been documented previously:
+
+.in 2m
+\fBAlpha, .\|.\|., Omega\fP (the same as `ALPHA', .\|.\|., `OMEGA')
+.br
+\fBldots\fP (three dots on the base line)
+.br
+\fBdollar\fP (a dollar glyph)
+.in
+
+.LI
+The following keywords have been extended.  Again, this isn't new but
+hasn't been documented previously:
+
+.in 2m
+.ft B
+col n { .\|.\|. }
+.br
+lcol n { .\|.\|. }
+.br
+rcol n { .\|.\|. }
+.br
+ccol n { .\|.\|. }
+.br
+pile n { .\|.\|. }
+.br
+lpile n { .\|.\|. }
+.br
+rpile n { .\|.\|. }
+.br
+cpile n { .\|.\|. }
+.ft P
+(set vertical spacing between rows to\~N)
+.ULE
+.
+.
+.SH 2
+grohtml
+
+.ULS
+.LI
+This device driver has been raised to beta stage; its set of tags should
+be stable now.
+
+.LI
+New command line option `\-s' to set the base point size.
+
+.LI
+New command line option `\-S' to set the split level while generating
+multiple files.
+.ULE
+.
+.
+.SH 2
+gxditview
+
+.ULS
+.LI
+On platforms which have the X\~Window System this program is now built and
+installed automatically.
+.ULE
+.
+.
+.SH 2
+xtotroff
+
+.ULS
+.LI
+This program to create font definition files for xditview isn't new but
+hasn't been installed previously.
+.ULE
+.
+.
+.SH 2
+groffer
+
+.ULS
+.LI
+A security problem (reported as CAN-2004-0969) has been fixed.
+.ULE
+.
+.
+.SH 2
+gdiffmk
+
+.ULS
+.LI
+A new script contributed by Mike Bianchi.
+It compares two groff, nroff, or troff documents and creates an output with
+added margin characters (using `.mc') to indicate the differences.
+.ULE
+.
+.
+.SH 2
+pdfroff
+
+.ULS
+.LI
+A new wrapper script contributed by Keith Marshall to easily create PDF
+documents with groff.
+.ULE
+.
+.
+.SH 2
+macro packages
+
+.ULS
+.LI
+ms.tmac
+
+.ULS
+.LI
+Support for fractional point sizes: A value for the `PS', `VS', `FPS',
+and `VPS' register larger than or equal to 1000 is always divided by 1000.
+For example, `.nr\~PS\~10250' sets the document's font size to 10.25 points.
+
+.LI
+The `Ds' and `De' macros provided in ms since groff version 1.19 have
+been removed; the equivalent `DS' and `DE' macros should be used instead.
+X11 documents which actually use `Ds' and `De' always load a
+specific macro file from the X11 distribution (`macros.t') which
+provides proper definitions for the two macros.
+
+.LI
+The following registers have been added for improving layout control:
+
+.IP PORPHANS
+Defines number of lines following `LP', `PP', `QP', `IP' or `XP' which
+must be kept together, before any automatic page break.
+
+.IP HORPHANS
+Sets number of lines of following paragraph which must be kept with a
+heading, defined by `NH' or `SH', before any automatic page break.
+
+.IP GROWPS
+Sets the first level of heading (set with `NH') which will keep the
+same point size as body text.
+
+.IP PSINCR
+Sets the point size increment for each level of heading (set with
+`NH'), below the threshold level set by `GROWPS'; e.g., if
+\en[PS]\~=\~10, \en[GROWPS]\~=\~3 and \en[PSINCR]\~=\~2.0p, then `.NH\~1'
+will produce 14pt headings, `.NH\~2' will produce 12pt, and all other levels
+will remain at 10pt (because \en[PS]\~=\~10).
+
+.LI
+The `SH' macro now accepts a numeric argument, to make heading size
+match that of `NH' with same argument value when the `GROWPS'/`PSINCR'
+feature is enabled.
+.ULE
+
+Please refer to the documentation of the ms package for other, minor
+improvements.
+
+.LI
+me.tmac
+
+The section type set with the `++' request is available in the `_M'
+register.
+This isn't new but hasn't been documented before.
+
+.LI
+www.tmac
+
+The `HR' macro no longer causes an empty line for non-HTML devices.
+
+A new macro `HEAD' has been added to directly add data to the
+<head>...</head> block.
+
+New macros `OLS' and `OLE' to start and end an ordered list.
+
+New macros `DLS' and `DLE' to start and end a definition list.
+.ULE
+.
+.
+.SH 2
+pdfmark
+
+.ULS
+.LI
+A new macro package contributed by Keith Marshall which implements PDF
+marks.
+This is in alpha stage currently.
+.ULE
+.
+.
+.SH 2
+miscellaneous
+
+.ULS
+.LI
+Two new keywords to the DESC file have been added which are needed for
+grohtml: `image_generator' and `unscaled_charwidths'.
+The former gives the name of the program which creates PNG images,
+and the latter makes troff always use unscaled character widths.
+.ULE
+.
+.
+.SH
 NEWS VERSION 1.19.1
 .
 .SH 2