From owner-freebsd-doc@FreeBSD.ORG Mon Sep 15 13:50:21 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C4E6816A4BF for ; Mon, 15 Sep 2003 13:50:21 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 016CB43FA3 for ; Mon, 15 Sep 2003 13:50:19 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h8FKoJUp003284 for ; Mon, 15 Sep 2003 13:50:19 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h8FKoJe4003283; Mon, 15 Sep 2003 13:50:19 -0700 (PDT) Resent-Date: Mon, 15 Sep 2003 13:50:19 -0700 (PDT) Resent-Message-Id: <200309152050.h8FKoJe4003283@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Josef El-Rayes Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 38D0716A4BF for ; Mon, 15 Sep 2003 13:42:32 -0700 (PDT) Received: from octopussy.utanet.at (octopussy.utanet.at [213.90.36.45]) by mx1.FreeBSD.org (Postfix) with ESMTP id D674F43FD7 for ; Mon, 15 Sep 2003 13:42:30 -0700 (PDT) (envelope-from shammer@daemon.li) Received: from patricia.utanet.at ([213.90.36.8]) by octopussy.utanet.at with esmtp (Exim 4.12) id 19z0B3-0004U4-00 for FreeBSD-gnats-submit@freebsd.org; Mon, 15 Sep 2003 22:42:29 +0200 Received: from dsl-242-127.utaonline.at ([212.152.242.127] helo=gina.at) by patricia.utanet.at with esmtp (Exim 4.12) id 19z0Ay-0004Ii-00 for FreeBSD-gnats-submit@freebsd.org; Mon, 15 Sep 2003 22:42:24 +0200 Received: by gina.at (Postfix, from userid 1001) id 1ABD660F2; Mon, 15 Sep 2003 22:42:17 +0200 (CEST) Message-Id: <20030915204217.1ABD660F2@gina.at> Date: Mon, 15 Sep 2003 22:42:17 +0200 (CEST) From: Josef El-Rayes To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/56903: [patch] articles/fonts: add application tags X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Josef El-Rayes List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 15 Sep 2003 20:50:21 -0000 >Number: 56903 >Category: docs >Synopsis: [patch] articles/fonts: add application tags >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Mon Sep 15 13:50:19 PDT 2003 >Closed-Date: >Last-Modified: >Originator: Josef El-Rayes >Release: FreeBSD 5.1-CURRENT i386 >Organization: >Environment: System: FreeBSD gina.at 5.1-CURRENT FreeBSD 5.1-CURRENT #1: Sat Sep 13 13:22:16 CEST 2003 root@gina.at:/usr/obj/usr/src/sys/GINA i386 >Description: doc/en_US.ISO8859-1/articles/fonts/article.sgml: o add application tags >How-To-Repeat: >Fix: --- article.sgml.diff begins here --- --- article.sgml.orig Mon Sep 15 19:27:24 2003 +++ article.sgml Mon Sep 15 20:05:34 2003 @@ -66,7 +66,8 @@ This document contains a description of the various font files that may be used with FreeBSD and the syscons driver, - X11, Ghostscript and Groff. Cookbook examples are provided + X11, Ghostscript + and Groff. Cookbook examples are provided for switching the syscons display to 80x60 mode, and for using type 1 fonts with the above application programs. @@ -184,7 +185,7 @@ - Ghostscript + Ghostscript .pfa, @@ -194,7 +195,7 @@ - X11 + X11 .pfa, @@ -203,7 +204,7 @@ - Groff + Groff .pfa, @@ -212,7 +213,7 @@ - Povray + Povray .ttf @@ -274,13 +275,13 @@ - Using type 1 fonts with X11 + Using type 1 fonts with <application>X11</application> - X11 can use either the .pfa or the - .pfb format fonts. The X11 fonts are + X11 can use either the .pfa or the + .pfb format fonts. The X11 fonts are located in various subdirectories under /usr/X11R6/lib/X11/fonts. Each font file - is cross referenced to its X11 name by the contents of the + is cross referenced to its X11 name by the contents of the fonts.dir file in each directory. There is already a directory named Type1. The @@ -306,8 +307,8 @@ &prompt.user; echo showboat - InfoMagic CICA, Dec 1994, /fonts/atm/showboat >>INDEX - Now, to use a new font with X11, one must make the font file - available and update the font name files. The X11 font names + Now, to use a new font with X11, one must make the font file + available and update the font name files. The X11 font names look like: @@ -439,7 +440,7 @@ All of these names are arbitrary, but one should strive to be compatible with the existing conventions. A font is - referenced by name with possible wild cards by an X11 program, + referenced by name with possible wild cards by an X11 program, so the name chosen should make some sense. One might begin by simply using @@ -492,12 +493,12 @@ Using type 1 fonts with Ghostscript - Ghostscript references a font via its Fontmap - file. This must be modified in a similar way to the X11 - fonts.dir file. Ghostscript can use either + Ghostscript references a font via its Fontmap + file. This must be modified in a similar way to the X11 + fonts.dir file. Ghostscript can use either the .pfa or the .pfb format fonts. Using the font from the previous example, here is - how to use it with Ghostscript: + how to use it with Ghostscript: Put the font in Ghostscript's font directory @@ -530,22 +531,23 @@ References: fonts.txt in the - Ghostscript 4.01 distribution + Ghostscript 4.01 distribution Using type 1 fonts with Groff - Now that the new font can be used by both X11 and - Ghostscript, how can one use the new font with groff? First of + Now that the new font can be used by both X11 and + Ghostscript, how can one use the new font + with groff? First of all, since we are dealing with type 1 &postscript; fonts, the - groff device that is applicable is the ps - device. A font file must be created for each font that groff - can use. A groff font name is just a file in + groff device that is applicable is the ps + device. A font file must be created for each font that groff + can use. A groff font name is just a file in /usr/share/groff_font/devps. With our example, the font file could be /usr/share/groff_font/devps/SHOWBOAT. The - file must be created using tools provided by groff. + file must be created using tools provided by groff. The first tool is afmtodit. This is not normally installed, so it must be retrieved from the source @@ -561,7 +563,7 @@ :wq - This tool will create the groff font file from the metrics + This tool will create the groff font file from the metrics file (.afm suffix.) Continuing with our example: @@ -580,8 +582,8 @@ The font can now be referenced with the name SHOWBOAT. - If ghostscript is used to drive the printers on the system, - then nothing more needs to be done. However, if true PostScript + If Ghostscript is used to drive the printers on the system, + then nothing more needs to be done. However, if true &postscript; printers are used, then the font must be down loaded to the printer in order for the font to be used (unless the printer happens to have the showboat font built in or on an accessible @@ -705,7 +707,7 @@ upper case, so any renaming must be consistent with this. (Actually, GS_TTF.PS and PFS2AFM.PS are supposedly part of the - ghostscript distribution, but it is just as easy to use + Ghostscript distribution, but it is just as easy to use these as an isolated utility. FreeBSD does not seem to include the latter.) You also may want to have these installed to @@ -717,7 +719,7 @@ afmtodit - Creates font files for use with groff from ascii font + Creates font files for use with groff from ascii font metrics file. This usually resides in the directory, /usr/src/contrib/groff/afmtodit, and requires some work to get going. @@ -793,7 +795,7 @@ - Create the groff PostScript file: + Create the groff PostScript file: Change directories to /usr/share/groff_font/devps so as to @@ -849,10 +851,11 @@ fonts available in this format. Unfortunately, there are few applications that I am aware of - that can use this format: Ghostscript and Povray come to mind. - Ghostscript's support, according to the documentation, is + that can use this format: Ghostscript + and Povray come to mind. + Ghostscript's support, according to the documentation, is rudimentary and the results are likely to be inferior to type 1 - fonts. Povray version 3 also has the ability to use TrueType + fonts. Povray version 3 also has the ability to use TrueType fonts, but I rather doubt many people will be creating documents as a series of raytraced pages :-). @@ -871,7 +874,7 @@ - The xfsft font server for X11 can + The xfsft font server for X11 can serve TrueType fonts in addition to regular fonts. Though currently in beta, it is said to be quite usable. See - xfstt is another font server for X11, + xfstt is another font server for + X11, available under . @@ -965,7 +969,7 @@ - How to generate the groff character mapping files for + How to generate the groff character mapping files for PostScript fonts with non-standard character names? @@ -976,7 +980,7 @@ It would be good to have examples of using TrueType - fonts with povray and ghostscript. + fonts with Povray and Ghostscript. --- article.sgml.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: