README revision 55839
175584SruThis is the GNU groff document formatting system. The version number 275584Sruis given in the file VERSION. 375584Sru 475584SruIncluded in this release are implementations of troff, pic, eqn, tbl, 575584Srurefer, the -man macros and the -ms macros, and drivers for PostScript, 675584SruTeX dvi format, HP LaserJet 4 printers, HTML format (still alpha), and 775584Srutypewriter-like devices. Also included is a modified version of the 875584SruBerkeley -me macros, an enhanced version of the X11 xditview 975584Srupreviewer, and an implementation of the -mm macros contributed by 1075584SruJoergen Haegg (jh@axis.se). 1175584Sru 1275584SruSee the file INSTALL for installation instructions. You will require 1375584Srua C++ compiler. 1475584Sru 1575584SruThe file NEWS describes recent user-visible changes to groff. 1675584Sru 1775584SruGroff is free software. See the file COPYING for copying permission. 1875584Sru 1975584SruThe file PROBLEMS describes various problems that have been 2075584Sruencountered in compiling, installing, and running groff. 2175584Sru 2275584SruFor the moment, the documentation assumes that you are already 2375584Srufamiliar with the Unix versions of troff, -man, -ms and the 2475584Srupreprocessors. 2575584Sru 2675584SruThe most recent released version of groff is always available by 2775584Sruanonymous ftp from ftp.gnu.org in the directory pub/gnu/groff. 2875584Sru 2975584SruA CVS repository is now available, containing the current development 3075584Sruversion of groff. You can access it with the commands 3175584Sru 3275584Sru export CVSROOT=:pserver:anoncvs@anoncvs.ffii.org:/var/cvs 3375584Sru cvs login 3475584Sru cvs -z9 co groff 3575584Sru 3675584Sru(if the prompt for the password appears, just press the enter key). 3775584SruAfter a successful login you no longer need the first two commands; an 3875584Sruupdate of a checked out repository should be done with 3975584Sru 4075584Sru cvs -z9 update -d 4175584Sru 4275584SruPlease read the info pages of cvs for further details. 4375584Sru 4475584SruAlternatively, you can download snapshots (which are updated twice a 4575584Sruday) from 4675584Sru 4775584Sru ftp://ftp.ffii.org/pub/groff/devel/groff-current.tar.gz 4875584Sru 4975584Sruor a diff file relative to the latest official groff release as 5075584Sru 5175584Sru ftp://ftp.ffii.org/pub/groff/devel/groff-<version>-current.diff.gz 5275584Sru 5375584SruPlease report bugs using the form in the file BUG-REPORT; the idea of 5475584Sruthis is to make sure that FSF has all the information it needs to fix 5575584Sruthe bug. At the very least, read the BUG-REPORT form and make sure 5675584Sruthat you supply all the information that it asks for. Even if you are 5775584Srunot sure that something is a bug, report it using BUG-REPORT: this 5875584Sruwill enable us to determine whether it really is a bug or not. 5975584Sru 6075584SruThree mailing lists are available: 6175584Sru 6275584Sru bug-groff@gnu.org for reporting bugs 6375584Sru groff@gnu.org for general discussion of groff 6475584Sru groff-commit@ffii.org a read-only list showing logs of 6575584Sru commitments to the CVS repository 6675584Sru 6775584SruNote that groff@gnu.org is an alias for groff@ffii.org; you must be 6875584Srusubscribed to the `groff' and `groff-commit' lists to send mails. 6975584Sru 7075584SruTo subscribe, send a mail to <list>-request@<domain> (example: 7175584Srugroff-request@ffii.org) with the word `subscribe' in either the 7275584Srusubject or body of the email (don't include the quotes). 7375584Sru 7475584SruGNU groff was written by James Clark <jjc@jclark.com>. It is now 7575584Srumaintained by Ted Harding <ted.harding@nessie.mcc.ac.uk> and Werner 7675584SruLemberg <wl@gnu.org>. 7775584Sru