[Groff-commit] groff ./ChangeLog src/devices/grops/grops.man

[Werner LEMBERG]

CVSROOT:        /cvsroot/groff
Module name:    groff
Branch:         
Changes by:     Werner LEMBERG <address@hidden> 06/03/18 17:30:20

Modified files:
        .              : ChangeLog 
        src/devices/grops: grops.man 

Log message:
        * src/devices/grops/grops.man: Add section how to install fonts.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/groff/ChangeLog.diff?tr1=1.930&tr2=1.931&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/groff/groff/src/devices/grops/grops.man.diff?tr1=1.29&tr2=1.30&r1=text&r2=text

Patches:
Index: groff/ChangeLog
diff -u groff/ChangeLog:1.930 groff/ChangeLog:1.931
--- groff/ChangeLog:1.930       Sat Mar 18 08:27:36 2006
+++ groff/ChangeLog     Sat Mar 18 17:30:20 2006
@@ -4,6 +4,8 @@
        * LICENSES: This.  Collect all licensing information in this file.
        * tmac/README, src/libs/snprintf/README: Removed.
 
+       * src/devices/grops/grops.man: Add section how to install fonts.
+
 2006-03-17  Werner LEMBERG  <address@hidden>
 
        * Makefile.comm (.y.cpp): Fix #line arguments in output.
Index: groff/src/devices/grops/grops.man
diff -u groff/src/devices/grops/grops.man:1.29 
groff/src/devices/grops/grops.man:1.30
--- groff/src/devices/grops/grops.man:1.29      Thu Jan 19 07:19:23 2006
+++ groff/src/devices/grops/grops.man   Sat Mar 18 17:30:20 2006
@@ -58,8 +58,8 @@
 .B grops
 .
 .de OP
-.ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\%\\$2" "\ ]"
-.el .RB "[\ " "\\$1" "\ ]"
+.  ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\%\\$2" "\ ]"
+.  el .RB "[\ " "\\$1" "\ ]"
 ..
 .
 .OP \-glmv
@@ -112,8 +112,8 @@
 .B groff
 options can be passed to
 .B grops
-using the
-.B groff
+using
+.BR groff 's
 .B \-P
 option.
 .
@@ -126,6 +126,11 @@
 To print such concatenated output it is necessary to deactivate DSC
 handling in the printing program or previewer.
 .
+See section
+.B FONT INSTALLATION
+below for a guide how to install fonts for
+.BR grops .
+.
 .
 .SH OPTIONS
 .TP
@@ -249,9 +254,12 @@
 and
 .B \eX'ps: file'
 escapes.
+.
 The current directory is always searched first.
+.
 This option may be specified more than once;
 the directories are searched in the order specified.
+.
 No directory search is performed for files specified using an absolute path.
 .
 .TP
@@ -296,6 +304,7 @@
 Lines should be drawn using a thickness of
 .IR n \~\c
 thousandths of an em.
+.
 If this option is not given, the line thickness defaults to 0.04\~em.
 .
 .TP
@@ -555,6 +564,7 @@
 .BR setcmykcolor ,
 and for `gray'
 .BR setgray .
+.
 Note that
 .B setcmykcolor
 is a PostScript LanguageLevel\~2 command and thus not available on some
@@ -810,7 +820,7 @@
 prints the
 .B \[rs](em
 character
-and ignore the line (this code is already in file
+and ignores the line (this code is already in file
 .B Xps.tmac
 which is loaded if a document intended for
 .B grops
@@ -829,14 +839,7 @@
 .
 .LP
 In addition, the device and font description files for the device used
-must meet certain requirements.
-.
-The device and font description files supplied for
-.B ps
-device meet all these requirements.
-.
-.BR afmtodit (@MAN1EXT@)
-can be used to create font files from AFM files.
+must meet certain requirements:
 .
 The resolution must be an integer multiple of\~72 times the
 .BR sizescale .
@@ -919,10 +922,13 @@
 .B grops
 can automatically include the downloadable fonts necessary
 to print the document.
+.
 Such fonts must be in PFA format.
+.
 Use
-.BR pfbtops (@MAN1EXT@)
+.BR \%pfbtops (@MAN1EXT@)
 to convert a Type\~1 font in PFB format.
+.
 Any downloadable fonts which should, when required, be included by
 .B grops
 must be listed in the file
@@ -1035,8 +1041,8 @@
 .B grops
 itself doesn't emit bounding box information.
 .
-With the help of GhostScript the following simple script
-.B groff2eps
+With the help of GhostScript the following simple script,
+.BR groff2eps ,
 produces an encapsulated PS file.
 .
 .RS
@@ -1068,27 +1074,32 @@
 .BR foo.eps .
 .
 .
-.SS TrueType fonts
+.SS TrueType and other font formats
 TrueType fonts can be used with 
 .B grops 
 if converted first to 
-.B "Type 42"
+.B "Type\~42"
 format, an especial PostScript wrapper equivalent to the
 PFA format mentioned in
-.BR pfbtops (@MAN1EXT@).
+.BR \%pfbtops (@MAN1EXT@).
+.
 There are several different methods to generate a type42 
 wrapper and most of them involve the use of a PostScript
 interpreter such as Ghostscript \(em see
 .BR gs (1).
+.
+.LP
 Yet, the easiest method involves the use of the application 
-.BR ttftot42 .
+.BR ttftot42 (1).
+.
 This program uses
 .BR freetype (3)
 (version 1.3.1) to generate type42
 font wrappers and well-formed AFM files that can be fed to
 the
-.BR afmtodit (@MAN1EXT@)
+.BR \%afmtodit (@MAN1EXT@)
 script to create appropriate metric files.
+.
 The resulting font wrappers should be added to the
 .B download
 file.
@@ -1097,6 +1108,136 @@
 .URL ftp://\:www.giga.or.at/\:pub/\:nih/\:ttftot42/ \
      ftp://\:www.giga.or.at/\:pub/\:nih/\:ttftot42/ .
 .
+.LP
+Another solution for creating type42 wrappers is to use FontForge,
+available from
+.URL http://\:fontforge.sf.net \
+     http://\:fontforge.sf.net .
+This font editor can convert most outline font formats.
+.
+.
+.SH FONT INSTALLATION
+.
+This section gives a summary of the above explanations; it can serve
+as a step-by-step font installation guide for
+.BR grops .
+.
+.IP \(bu 4
+Convert your font to something groff understands.
+.
+This is either a PostScript Type\~1 font in PFA format or a
+PostScript Type\~42 font, together with an AFM file.
+.
+.IP
+The very first characters in a PFA file look like this:
+.
+.RS
+.IP
+.B %!PS-AdobeFont-1.0:
+.RE
+.
+.IP
+A PFB file has this also in the first line, but the string is
+preceded with some binary bytes.
+.
+.IP
+The very first characters in a Type\~42 font file look like this:
+.
+.RS
+.IP
+.B %!PS-TrueTypeFont
+.RE
+.
+.IP
+This is a wrapper format for TrueType fonts.
+.
+Old PS printers might not support it (this is, they don't have a
+built-in TrueType font interpreter).
+.
+.IP
+If your font is in PFB format (such fonts normally have `.pfb' as
+the file extension), you might use groff's
+.BR \%pfbtops (@MAN1EXT@)
+program to convert it to PFA.
+.
+For TrueType fonts, try
+.B ttftot42
+or
+.BR fontforge .
+For all other font formats use
+.B fontforge
+which can convert most outline font formats.
+.
+.IP \(bu 4
+Convert the AFM file to a groff font description file with the
+.BR \%afmtodit (@MAN1EXT@)
+program.
+.
+An example call is
+.
+.RS
+.IP
+afmtodit Foo-Bar-Bold.afm textmap FBB
+.RE
+.
+.IP
+which converts the metric file `Foo-Bar-Bold.afm' to the groff
+font `FBB'.
+.
+If you have a font family which comes with normal, bold, italic,
+and bold italic faces, it is recommended to use the letters
+.BR R ,
+.BR B ,
+.BR I ,
+and
+.BR BI ,
+respectively, as postfixes in the groff font names to make groff's
+`.fam' request work.
+.
+An example is groff's built-in Times-Roman font: The font family name
+is
+.BR T ,
+and the groff font names are
+.BR TR ,
+.BR TB ,
+.BR TI ,
+and
+.BR TBI .
+.
+.IP \(bu 4
+Install both the groff font description files and the fonts in a
+`devps' subdirectory of the font path which groff finds.
+.
+See the
+.B ENVIRONMENT
+section in the
+.BR troff (@MAN1EXT@)
+man page which lists the actual value of the font path.
+.
+Note that groff doesn't use the AFM files (but it is a good idea to
+store them anyway).
+.
+.IP \(bu 4
+Register all fonts which must be downloaded to the printer in the
+`devps/download' file.
+.
+Only the first occurrence of this file in the font path is read.
+.
+This means that you should copy the default `download' file to the
+first directory in your font path and add your fonts there.
+.
+To continue the above example we assume that the PS font name for
+Foo-Bar-Bold.pfa is `XYFoo-Bar-Bold' (the PS font name is stored in the
+.B internalname
+field in the `FBB' file), thus the following line should be added to
+`download'.
+.
+.RS
+.IP
+.B XY-Foo-Bar-Bold Foo-Bar-Bold.pfa
+.
+.RE
+.
 .
 .SH ENVIRONMENT
 .TP
@@ -1152,7 +1293,7 @@
 .TP
 .B @MACRODIR@/psold.tmac
 Macros to disable use of characters not present in older
-PostScript printers (e.g. `eth' or `thorn').
+PostScript printers (e.g., `eth' or `thorn').
 .
 .TP
 .BI /tmp/grops XXXXXX
@@ -1160,14 +1301,14 @@
 .
 .
 .SH "SEE ALSO"
-.BR afmtodit (@MAN1EXT@),
+.BR \%afmtodit (@MAN1EXT@),
 .BR groff (@MAN1EXT@),
 .BR @address@hidden (@MAN1EXT@),
-.BR pfbtops (@MAN1EXT@),
-.BR groff_out (@MAN5EXT@),
-.BR groff_font (@MAN5EXT@),
-.BR groff_char (@MAN7EXT@),
-.BR groff_tmac (@MAN5EXT@)
+.BR \%pfbtops (@MAN1EXT@),
+.BR \%groff_out (@MAN5EXT@),
+.BR \%groff_font (@MAN5EXT@),
+.BR \%groff_char (@MAN7EXT@),
+.BR \%groff_tmac (@MAN5EXT@)
 .
 .PP
 .URL 
"http://\:partners.adobe.com/\:public/\:developer/\:en/\:ps/\:5001.DSC_Spec.pdf";
 \