contrib/groff/doc/homepage.ms

   1 .\" This file gives a small example how a web page could look like if created
   2 .\" with groff.
   3 .\"
   4 .\"
   5 .\" To make it work with other output devices also, we include arkup.tmac
   6 .\" directly.
   7 .mso www.tmac
   8 .\"
   9 .LP
  10 .\"
  11 .\"  set a longer line than the default as we have some long ftp addresses
  12 .\"  which groff cannot split
  13 .nr LL 7i
  14 .TL
  15 Home of Groff (GNU Troff).
  16 .sp 1i
  17 .LP
  18 GNU Troff
  19 .URL (Groff) http://groff.ffii.org/
  20 \(em a
  21 .URL GNU http://www.gnu.org/
  22 project.
  23 Hosted by
  24 .URL FFII http://ffii.org/ .
  25 .br
  26 .LINE
  27 .LP
  28 Groff (GNU Troff) is a document processor which reads plain text mixed with
  29 formatting commands and produces formatted output.
  30 .LP
  31 Groff now supports HTML for the Web.
  32 Please see
  33 .URL "Groff Web Tips" "#Web Tips" .
  34 .sp
  35 .SH
  36 Download
  37 .LP
  38 .URL Germany "ftp://groff.ffii.org/pub/groff/"
  39 |
  40 .URL USA "ftp://ftp.gnu.org/gnu/groff/"
  41 .LP
  42 .URL License http://www.gnu.org/copyleft/gpl.html
  43 |
  44 .URL "Mailing list" http://ffii.org/mailman/listinfo/groff/
  45 |
  46 .URL "Groff for Windows" "http://www.cs.vu.nl/~tmgil/misc/wingroff.html"
  47 .sp
  48 User issues lead:
  49 .MAILTO Ted.Harding@nessie.mcc.ac.uk "Ted Harding"
  50 .br
  51 Technical issues lead:
  52 .MAILTO wl@gnu.org "Werner Lemberg"
  53 .SH
  54 README
  55 .LP
  56 This is the GNU groff document formatting system.
  57 The version number is given in the file VERSION.
  58 .LP
  59 Included in this release are implementations of troff, pic, eqn, tbl, refer,
  60 the -man macros and the -ms macros, and drivers for PostScript, TeX dvi
  61 format, HP LaserJet 4 printers, HTML format (still alpha), and
  62 typewriter-like devices.
  63 Also included is a modified version of the Berkeley -me macros, an enhanced
  64 version of the X11 xditview previewer, and an implementation of the -mm
  65 macros contributed by
  66 .MAILTO jh@axis.se "J\(:orgen H\(:agg" .
  67 .LP
  68 See the file INSTALL for installation instructions.
  69 You will require a C++ compiler.
  70 .LP
  71 The file NEWS describes recent user-visible changes to groff.
  72 .LP
  73 Groff is free software.
  74 See the file COPYING for copying permission.
  75 .LP
  76 The file PROBLEMS describes various problems that have been encountered in
  77 compiling, installing, and running groff.
  78 .LP
  79 For the moment, the documentation assumes that you are already familiar with
  80 the Unix versions of troff, -man, -ms and the preprocessors.
  81 .LP
  82 The most recent released version of groff is always available by anonymous
  83 ftp from ftp.gnu.org in the directory pub/gnu/groff.
  84 .LP
  85 A CVS repository is now available, containing the current development
  86 version of groff.
  87 You can access it with the commands:
  88 .sp
  89 .RS
  90 .nf
  91 \fC
  92 export CVSROOT=:pserver:anoncvs@anoncvs.ffii.org:/var/cvs
  93 cvs login
  94 cvs -z9 co groff
  95 \fR
  96 .fi
  97 .RE
  98 .sp
  99 .LP
 100 (if the prompt for the password appears, just press the enter key).
 101 After a successful login you no longer need the first two commands; an
 102 update of a checked out repository should be done with:
 103 .sp
 104 .RS
 105 \fC
 106 cvs -z9 update -dP
 107 \fR
 108 .RE
 109 .sp
 110 .LP
 111 Please read the info pages of cvs for further details.
 112 .LP
 113 Alternatively, you can download snapshots (which are updated twice a day)
 114 from
 115 .URL here ftp://ftp.ffii.org/pub/groff/devel/groff-current.tar.gz
 116 or a diff file relative to the latest official groff release as:
 117 .sp
 118 .RS
 119 \fC
 120 ftp://ftp.ffii.org/pub/groff/devel/groff-[version]-current.diff.gz
 121 \fR
 122 .RE
 123 .sp
 124 .LP
 125 Please report bugs using the form in the file BUG-REPORT; the idea of this
 126 is to make sure that FSF has all the information it needs to fix the bug.
 127 At the very least, read the BUG-REPORT form and make sure that you supply
 128 all the information that it asks for.
 129 Even if you are not sure that something is a bug, report it using
 130 BUG-REPORT: this will enable us to determine whether it really is a bug or
 131 not.
 132 .LP
 133 Three mailing lists are available:
 134 .sp
 135 .RS
 136 .nf
 137 \fC
 138 bug-groff@gnu.org      for reporting bugs
 139 groff@gnu.org          for general discussion of groff
 140 groff-commit@ffii.org  a read-only list showing logs of
 141                        commitments to the CVS repository
 142 \fP
 143 .fi
 144 .RE
 145 .sp
 146 .LP
 147 Note that groff@gnu.org is an alias for
 148 .MAILTO groff@ffii.org groff@ffii.org ;
 149 you must be subscribed to the `groff' and `groff-commit' lists to send mails.
 150 .LP
 151 To subscribe, send e-mail to [list]-request@[domain] (example:
 152 .MAILTO groff-request@ffii.org groff-request@ffii.org )
 153 with the word `subscribe' in either the
 154 subject or body of the e-mail (don't include the quotes).
 155 .LP
 156 GNU groff was written by
 157 .MAILTO jjc@jclark.com "James Clark" .
 158 It is now maintained by
 159 .MAILTO Ted.Harding@nessie.mcc.ac.uk "Ted Harding"
 160 and
 161 .MAILTO wl@gnu.org "Werner Lemberg" .
 162 .br
 163 .
 164 .\" EOF