diff options
author | ru <ru@FreeBSD.org> | 2003-05-01 13:09:50 +0000 |
---|---|---|
committer | ru <ru@FreeBSD.org> | 2003-05-01 13:09:50 +0000 |
commit | c96557721be60d942f4d486b9ea7f9b7cbb034cc (patch) | |
tree | 5bb520ef39570cf7c612b59697308ed396ca84e0 /contrib/groff/doc/webpage.ms | |
parent | f78d5fa81a0b603b2741c98c8f48ce8245a18a4c (diff) | |
download | FreeBSD-src-c96557721be60d942f4d486b9ea7f9b7cbb034cc.zip FreeBSD-src-c96557721be60d942f4d486b9ea7f9b7cbb034cc.tar.gz |
Virgin import of FSF groff v1.19
Diffstat (limited to 'contrib/groff/doc/webpage.ms')
-rw-r--r-- | contrib/groff/doc/webpage.ms | 443 |
1 files changed, 397 insertions, 46 deletions
diff --git a/contrib/groff/doc/webpage.ms b/contrib/groff/doc/webpage.ms index f40b29b..0287787 100644 --- a/contrib/groff/doc/webpage.ms +++ b/contrib/groff/doc/webpage.ms @@ -42,9 +42,9 @@ Home of Groff (GNU Troff). .HnS 1 .HR GNU Troff -.URL http://\:groff.ffii.org/ (Groff) +.URL http://\:groff.ffii.org/ (Groff) \[em] a -.URL http://\:www.gnu.org/ GNU +.URL http://\:www.gnu.org/ GNU project. Hosted by .URL http://\:ffii.org/ FFII . @@ -62,15 +62,26 @@ Groff now supports HTML. .SH Download -.URL "ftp://\:groff.ffii.org/\:pub/\:groff/" Germany -| -.URL "ftp://\:ftp.gnu.org/\:gnu/\:groff/" USA +The source code of the currently released versions of groff is +available at the +.URL "ftp://\:groff.ffii.org/\:pub/\:groff/" "FFII host (Germany)" , +.URL "ftp://\:ftp.gnu.org/\:gnu/\:groff/" "GNU host (USA)" , +and its mirrors. +. +The USA site also contains more old, obsolete versions. + +The most actual pre-release, development version is available from a +CVS repository, see below. +. +Development snapshots (produced twice a day from the CVS repository) +can be downloaded with FTP from +.URL "ftp://\:groff.ffii.org/\:pub/\:groff/devel" here . -.URL http://\:www.gnu.org/\:copyleft/\:gpl.html License -| -.URL http://\:ffii.org/\:mailman/\:listinfo/\:groff/ "Mailing list" -| -.URL "http://\:gnuwin32.sf.net/\:packages/\:groffl.htm" "Groff for Windows" +For a special version of groff on the Microsoft operating systems, see +.URL "http://\:gnuwin32.sf.net/\:packages/\:groffl.htm" "Groff for Windows" . + +GNU troff is released under the +.URL http://\:www.gnu.org/\:copyleft/\:gpl.html "GNU Copyright License" . User issues lead: .MTO Ted.Harding@\:nessie.mcc.ac.uk "Ted Harding" @@ -115,7 +126,7 @@ A CVS repository is now available, containing the current development version of groff. You can access it with the commands -.RS +.in 2m .nf .ft C export CVSROOT=:pserver:anoncvs@anoncvs.ffii.org:/var/cvs @@ -123,17 +134,17 @@ cvs login cvs -z9 co groff .ft P .fi -.RE +.in (if the prompt for the password appears, just press the enter key). After a successful login you no longer need the first two commands; an update of a checked out repository should be done with -.RS +.in 2m .ft C cvs -z9 update -dP .ft P -.RE +.in Please read the info pages of cvs for further details. @@ -142,17 +153,17 @@ from .URL ftp://\:ftp.ffii.org/\:pub/\:groff/\:devel/\:groff-current.tar.gz here or a diff file relative to the latest official groff release as: -.RS +.in 2m .ft C ftp://ftp.ffii.org/pub/groff/devel/groff-\[la]version\[ra]-current.diff.gz .ft P -.RE +.in Assuming that groff-\[la]version\[ra].tar.gz and groff-\[la]version\[ra]-current.diff.gz are in the same directory, do the following to apply the diff file: -.RS +.in 2m .nf .ft C tar xzvf groff-\[la]version\[ra].tar.gz @@ -160,7 +171,7 @@ cd groff-\[la]version\[ra] gunzip -c ../groff-\[la]version\[ra]-current.diff.gz | patch -p1 .ft P .fi -.RE +.in 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. @@ -194,7 +205,10 @@ To subscribe, send e-mail to \[la]list\[ra]-request@\[la]domain\[ra] (example: .MTO groff-request@\:ffii.org groff-request@\:ffii.org ) with the word `subscribe' in either the -subject or body of the e-mail (don't include the quotes). +subject or body of the e-mail (don't include the quotes) or have a look +at the +.URL http://\:ffii.org/\:mailman/\:listinfo/\:groff/ \ + "groff mailing list webpage" . GNU groff was written by .MTO jjc@\:jclark.com "James Clark" . @@ -205,6 +219,335 @@ and . . .SH +NEWS VERSION 1.19 +. +.SH 2 +troff + +.ULS +.LI +Input encoding files for \%latin-9 (a.k.a.\& \%latin-0 and ISO \%8859-15) +and \%latin-2 (ISO \%8859-2) have been added. +Example use: + +.in 2m +.ft C +groff -Tdvi -mlatin9 my_file > my_file.dvi +.ft P +.in + +You still need proper fonts with the necessary glyphs. +Out of the box, the groff package supports \%latin-9 only for \-Tps, +\-Tdvi, and \-Tutf8, and \%latin-2 only for \-Tdvi and \-Tutf8. + +.LI +Composite glyphs are now supported. +To do this, a subset of the Adobe Glyph List (AGL) Algorithm as described in +.URL http://partners.adobe.com/asn/developer/typeforum/unicodegn.html \ + http://partners.adobe.com/asn/developer/typeforum/unicodegn.html +is used to construct glyph names based on Unicode character codes. +The existing groff glyph names are frozen; no glyph names which can't be +constructed algorithmically will be added in the future. + +The \e[...] escape sequence has been extended to specify multiple glyph +components. +Example: + +.in 2m +.ft C +\e[A ho] +.ft R +.in + +this accesses a glyph with the name `u0041_0328'. + +Some groff glyphs which are useful as composites map to `wrong' Unicode +code points. +For example, `ho' maps to U+02DB which is a spacing ogonek, whereas a +non-spacing ogonek U+0328 is needed for composite glyphs. +The new request + +.in 2m +.ft C +\&.composite from to +.ft R +.in + +will change the mapping while a composite glyph name is constructed. +To make \e[A ho] yield the expected result, + +.in 2m +.ft C +\&.composite ho u0328 +.ft R +.in + +is needed. +[The new file `composite.tmac' loaded at start-up already +contains proper calls to `.composite'.] + +Please refer to the info pages of groff and to the groff_char man page +for more details. + +.LI +A new request `fschar' has been added to define font-specific fallback +characters. +They are searched after the list of fonts declared with the +`fspecial' request but before the list of fonts declared with `special'. + +.LI +Fallback characters defined with `fschar' can be removed with the +new `rfschar' request. + +.LI +A new request `schar' has been added to define global fallback +characters. +They are searched after the list of fonts declared with the +`special' request but before the already mounted special fonts. + +.LI +In groff versions 1.18 and 1.18.1, \eD'f ...' didn't move the current +point horizontally. +Despite of being silly, this change has been reverted for backwards +compatibility. +Consequently, the intermediate output command `Df' also moves the +position horizontally again. + +\eD'f ...' is deprecated since it depends on the horizontal resolution of +the output device (given with the `hor' parameter in the DESC file). +Use the new \eD'Fg ...' escape instead. + +.LI +For orthogonality, new \eD subcommands to change the fill color are +available: + +.in 2m +.ft C +\eD'Fr ...' \f[R](rgb)\f[] +.br +\eD'Fc ...' \f[R](cmy)\f[] +.br +\eD'Fg ...' \f[R](gray)\f[] +.br +\eD'Fk ...' \f[R](cmyk)\f[] +.br +\eD'Fd' \f[R](default color)\f[] +.ft R +.in + +The arguments are the same as with the `defcolor' request. +The current position is \f[I]not\f[] changed. + +.LI +The values set with \eH and \eS are now available in number registers +\en[.height] and \en[.slant], respectively. + +.LI +The `.pe' number register isn't new but hasn't been documented before. +It is set to 1 during a page ejection caused by the `bp' request. + +.LI +The new glyph symbol `tno' is a textual variant of `no'. + +.LI +The new glyph symbol `+e' represents U+03F5, GREEK LUNATE EPSILON SYMBOL. +(Well, it is not really new since it has been previously supported by +grolj4.) +The mapping for both the dvi and lj4 symbol font has been +changed accordingly so that Greek small letter epsilon, `*e', has the +same glyph shape as with other devices. +.ULE +. +. +.SH 2 +grops + +.ULS +.LI +The font `freeeuro.pfa' has been added to provide various default glyph +shapes for `eu' and `Eu'. + +.LI +It is now possible to access all glyphs in a Type\~1 font, not only 256 +(provided the font file created by afmtodit has proper entries). +grops constructs additional encoding vectors on the fly if necessary. + +.LI +The paper size is now emitted via the %%DocumentMedia and PageSize +mechanisms so that it is no longer required to tell `gv' or `ps2pdf' +about the paper size. +The `broken' flag value\~16 omits this feature +(the used PostScript command `setpagedevice' is a LanguageLevel\~2 +extension). +Patch by +.MTO egil@\:kvaleberg.no "Egil Kvaleberg" . + +.LI +Non-slanted PostScript metrics have been changed again; they no longer +contain negative left italic correction values. +This assures correct spacing with eqn. +.ULE +. +. +.SH 2 +grodvi + +.ULS +.LI +The font cmtex10 has been added as the special font `SC' to the DVI fonts. +It is used as a font-specific special font for CW and CWI. + +.LI +New options \-l and \-p to set landscape orientation and the paper size. +grodvi now emits a `papersize' special which is understood by DVI drivers +like dvips. + +Consequently, the DESC file should contain a `papersize' keyword. + +.LI +The glyph shapes for \e[*f] and \e[*e] have been exchanged with \e[+f] and +\e[+e], respectively, to be in sync with all other devices. + +.LI +Glyphs \e[HE] and \e[DI] have been replaced with \e[u2662] and \e[u2661], +respectively, since the former two glyphs have a black (filled) shape +which grodvi doesn't provide by default (it never has actually). +.ULE +. +. +.SH 2 +grolj4 + +.ULS +.LI +The glyphs \e[*e] and \e[+e] have been exchanged to be in sync with +all other devices. + +.LI +The glyph \e[~=] is now called \e[|=]. Similar to other devices, \e[~=] +is now another name for glyph \e[~~]. +.ULE +. +. +.SH 2 +grotty + +.ULS +.LI +New option `\-r'. +It is similar to the \-i option except it tells grotty to +use the `reverse video' attribute to render italic fonts. +.ULE +. +. +.SH 2 +pic + +.ULS +.LI +New command `figname' to set the name of a picture's output box in TeX +mode. +.ULE +. +. +.SH 2 +refer + +.ULS +.LI +The environment variable `REFER' to override the name of the default +database isn't new but hasn't been documented before. +.ULE +. +. +.SH 2 +soelim + +.ULS +.LI +New option `\-r' to avoid emission of `.lf' lines. + +.LI +New option `\-t' to emit TeX comment lines (giving current file and the +line number) instead of `.lf' lines. +.ULE +. +. +.SH 2 +afmtodit + +.ULS +.LI +Unencoded glyphs in an AFM file are output also (since grops can now emit +multiple encoding vectors for a single font). + +.LI +New option `\-m' to prevent negative left italic correction values. + +.LI +The mapping and encoding file together with file `DESC' are now searched +in the default font directory also. +Please refer to the man page of afmtodit for more details. +.ULE +. +. +.SH 2 +macro packages + +.ULS +.LI +.MTO kollar@\:alltel.net "Larry Kollar" +and others made the man macros more customizable. + +.ULS +.LI +New command line options \-rFT, \-rIN, and \-rSN to set the vertical +location of the footer line, the body text indentation, and the +sub-subheading indentation. + +.LI +New command line option \-rHY (similar to the ms macros) to control +hyphenation. + +.LI +New macros `.PT' and `.BT' to print the header and footer strings. +They can be replaced with a customized version in `man.local'. + +.LI +The string `HF' now holds the typeface to print headings and +subheadings. + +.LI +Similar to the ms macros, the LT register now defaults to LL if not +explicitly specified on the command line. +.ULE + +.LI +troff's start-up file `troffrc' now includes `papersize.tmac' to set +the paper size with the command line option `-dpaper=<size>'. + +Possible values for `<size>' are the same as the predefined `papersize' +values in the DESC file (only lowercase; see the groff_font man page) +except \%a7-d7. +An appended `l' (ell) character denotes landscape orientation. +Examples: `a4', `c3l', `letterl'. + +Most output drivers need additional command line switches `\-p' and +`\-l' to override the default paper length and orientation as set in +the driver specific DESC file. + +For example, use the following for PS output on A4 paper in landscape +orientation: + +.in 2m +.ft C +groff -Tps -dpaper=a4l -P-pa4 -P-l -ms foo.ms > foo.ps +.ft R +.in +.ULE +. +. +.SH NEWS VERSION 1.18.1 . .SH 2 @@ -293,23 +636,24 @@ It is scanned from left to the right, and the first valid argument is used. This makes it possible to provide a fallback paper size. Example: -.RS + +.in 2m .ft C papersize /etc/papersize a4 .ft P -.RE +.in .LI A local font directory has been prepended to the default font path; it defaults to /usr/local/share/groff/site-font. Similar to the normal -font searching process, files must be placed into a dev\fIXXX\fP +font searching process, files must be placed into a dev\f[I]XXX\f[] subdirectory, e.g. -.RS +.in 2m .ft C /usr/local/share/groff/site-font/devps/FOO .ft P -.RE +.in for a PostScript font definition file FOO. .ULE @@ -402,20 +746,22 @@ got the troff glyph name `mc'. .LI Strings can take arguments, using this syntax: \e*[foo\~arg1\~arg2\~.\|.\|.]. Example: -.RS + +.in 2m .nf .ft C \&.ds xxx This is a \e\e$1 test. \e*[xxx nice] .ft P .fi -.RE +.in .LI It is now possible to have whitespace between the first and second dot (or the name of the ending macro) to end a macro definition. Example: -.RS + +.in 2m .nf .ft C \&.de ! @@ -430,7 +776,7 @@ Example: \&.. .ft P .fi -.RE +.in .LI `.fn' is a new string-valued register which returns the (internal) real @@ -505,7 +851,8 @@ final `0' can be omitted. the exception that the `asciify' request will use the character code (if any) before the character translation. Example: -.RS + +.in 2m .nf .ft C \&.trin ax @@ -519,7 +866,7 @@ a \&.xxx .ft P .fi -.RE +.in The result is `x\~a'. Using `tr', the result would be `x\~x'. @@ -535,21 +882,22 @@ post-vertical line space. For compatibility with plan 9's troff, multiple `pi' requests are supported: -.RS +.in 2m .nf .ft C \&.pi foo \&.pi bar .ft P .fi -.RE +.in is now equivalent to -.RS + +.in 2m .ft C \&.pi foo | bar .ft P -.RE +.in .LI A new escape sequence `\eO' is available to disable and enable glyph @@ -645,13 +993,14 @@ documented properly before. .ULS .LI The following macros have been renamed: -.RS + +.in 2m .nf MAILTO -> MTO IMAGE -> IMG LINE -> HR .fi -.RE +.in .LI For consistency, the macros `URL', `FTL', and `MTO' now all have the @@ -733,11 +1082,12 @@ New keywords `color' (or `colour', `colored', `coloured'), `outline' (or `outline' sets the color of the outline, `shaded' the fill color, and `color' sets both. Example: -.RS + +.in 2m .ft C circle shaded "green" outline "black" ; .ft P -.RE +.in Filled arrows always use the outline color for filling. @@ -814,7 +1164,8 @@ By default, font sizes are now available in the range 5\-10000pt, similar to PS fonts. If you want the old behaviour (i.e., font sizes at discrete values only), insert the following at the start of your document: -.RS + +.in 2m .nf .ft C \&.if '\e*[.T]'dvi' \e @@ -822,7 +1173,7 @@ insert the following at the start of your document: \& 1728 1800 2000 2074 2200 2400 2488 2800 3600 .ft P .fi -.RE +.in .LI A new font file HBI (using cmssbxo10; this is slanted sans serif bold @@ -939,17 +1290,17 @@ of examples. A new keyword `papersize' has been added to the DESC file format. Its argument is either -.RS -.IP \[bu] +.ULS +.LI a predefined paper format (e.g. `A4' or `letter') -.IP \[bu] +.LI a file name pointing to a file which must contain a paper size specification in its first line (e.g. `/etc/papersize') -.IP \[bu] +.LI a custom paper size definition like `35c,4i' -.RE +.ULE See groff_font(5) for more details. This keyword only affects the physical dimensions of the output medium; @@ -959,7 +1310,7 @@ troff completely ignores it. . .HR . -\s-2\fIThis document was produced using +\s[-2]\f[I]This document was produced using .URL http://groff.ffii.org/ groff-\n[.x].\n[.y].\n[.Y] . .br The image at the top has been contributed by Imogen Mulley (born 1991), |