[Groff-commit] groff ChangeLog README README.CVS

[Werner LEMBERG]

CVSROOT:        /cvsroot/groff
Module name:    groff
Branch:         
Changes by:     Werner LEMBERG <address@hidden> 05/05/25 18:25:21

Modified files:
        .              : ChangeLog README 
Removed files:
        .              : README.CVS 

Log message:
        * README: More fixes.
        
        * README.CVS: Removed.  Its contents is now part of the README file.

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/ChangeLog.diff?tr1=1.826&tr2=1.827&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/README.diff?tr1=1.11&tr2=1.12&r1=text&r2=text

Patches:
Index: groff/ChangeLog
diff -u groff/ChangeLog:1.826 groff/ChangeLog:1.827
--- groff/ChangeLog:1.826       Sat May 21 07:08:41 2005
+++ groff/ChangeLog     Wed May 25 18:25:21 2005
@@ -1,3 +1,10 @@
+2005-05-25  Keith Marshall  <address@hidden>
+           Bernd Warken
+
+       * README: More fixes.
+
+       * README.CVS: Removed.  Its contents is now part of the README file.
+
 2005-05-21  Werner LEMBERG  <address@hidden>
 
        * README: Updated.  Based on a patch from Bernd Warken.
Index: groff/README
diff -u groff/README:1.11 groff/README:1.12
--- groff/README:1.11   Mon May 23 12:01:00 2005
+++ groff/README        Wed May 25 18:25:21 2005
@@ -22,29 +22,38 @@
 The most recent released version of groff is always available by
 anonymous ftp from ftp.gnu.org in the directory pub/gnu/groff.
 
-A CVS repository is available (http://savannah.gnu.org/cvs/?group=groff),
-containing the current development version of groff.  You can access it
-with the commands
+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
+executing the commands
 
-  export CVS_RSH=ssh
+  cd ~/cvswork
+  CVS_RSH=ssh; export CVS_RSH
   cvs -d:ext:address@hidden/cvsroot/groff -z5 co groff
 
-This will create a subdirectory ./groff with the groff CVS tree.  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
 
+  cd ~/cvswork/groff
   CVS_RSH=ssh cvs -z5 update -dP
 
-in the generated ./groff subdirectory.  Please read the info pages of
-cvs for further details.
+Please read the CVS info pages for further details.
 
-Alternatively, you can download snapshots (which are updated twice a
-day) from
+Finally, it is possible to access the CVS with a web browser by
+pointing it to
+
+  http://savannah.gnu.org/cvs/?group=groff
+
+Alternatively, you can download snapshots. The complete groff source
+as a single file is available at
 
   http://groff.ffii.org/groff/devel/groff-current.tar.gz
 
-or a diff file relative to the latest official groff release as
+A diff file relative to groff-<version>, the latest official groff
+release is available at
 
   http://groff.ffii.org/groff/devel/groff-<version>-current.diff.gz
 
@@ -56,10 +65,28 @@
   cd groff-<version>
   gunzip -c ../groff-<version>-current.diff.gz | patch -p1
 
-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:
 
-  http://savannah.gnu.org/cvs/?group=groff
+  ghostscript
+  the psutils package
+  the netpbm package
+  texinfo 4.8
+  bison >= 1.875b or byacc
+
+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 *may* find that bison releases < 1.875
+will work, but in case of difficulty, please update to a later version
+*before* posting a bug report.
+
+For *all* 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
@@ -75,17 +102,21 @@
   address@hidden       a read-only list showing commitments
                              to the CVS repository
 
-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 a mail to <list>-request@<domain> (example:
address@hidden) with the word `subscribe' in either the subject
-or body of the email (don't include the quotes) or have a look at the
-groff mailing list web pages at
address@hidden for the `groff' list) with the word `subscribe'
+in either the subject or body of the email (don't include the quotes).
+Alternatively, you may subscribe by visiting the web pages at
 
   http://lists.gnu.org/mailman/listinfo/bug-groff
   http://lists.gnu.org/mailman/listinfo/groff
   http://lists.gnu.org/mailman/listinfo/groff-commit
 
+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 James Clark <address@hidden>.  It is now
 maintained by Ted Harding <address@hidden> and Werner
 Lemberg <address@hidden>.