From e9411184f7a5db406f06509d88e20e88557702ff Mon Sep 17 00:00:00 2001 From: Kevin E Martin Date: Tue, 8 Feb 2005 00:44:27 +0000 Subject: Update formatted docs. --- hw/xfree86/doc/README.fonts | 64 ++++++++++++++++++++++----------------------- 1 file changed, 32 insertions(+), 32 deletions(-) diff --git a/hw/xfree86/doc/README.fonts b/hw/xfree86/doc/README.fonts index 8818b293e..a5be31442 100644 --- a/hw/xfree86/doc/README.fonts +++ b/hw/xfree86/doc/README.fonts @@ -1,4 +1,4 @@ - Fonts in X11R6.8.1 + Fonts in X11R6.8.2 Juliusz Chroboczek, @@ -6,9 +6,9 @@ 1. Introduction -This document describes the support for fonts in X11R6.8.1. Installing fonts +This document describes the support for fonts in X11R6.8.2. Installing fonts (section 2., page 1) is aimed at the casual user wishing to install fonts in -X11R6.8.1 the rest of the document describes the font support in more detail. +X11R6.8.2 the rest of the document describes the font support in more detail. We assume some familiarity with digital fonts. If anything is not clear to you, please consult Appendix: Background (section 5., page 1) at the end of @@ -19,7 +19,7 @@ this document for background information. X includes two font systems: the original core X11 fonts system, which is present in all implementations of X11, and the Xft fonts system, which may not be distributed with implementations of X11 that are not based on -X11R6.8.1 but will hopefully be included by them in the future +X11R6.8.2 but will hopefully be included by them in the future The core X11 fonts system is directly derived from the fonts system included with X11R1 in 1987, which could only use monochrome bitmap fonts. Over the @@ -48,13 +48,13 @@ access newly-installed fonts. Xft has no configuration mechanism itself, rather it relies upon the fontcon- fig library to configure and customize fonts. That library is not specific -to X11R6.8.1 or indeed on any particular font output mechanism. This discus- +to X11R6.8.2 or indeed on any particular font output mechanism. This discus- sion describes how fontconfig, rather than Xft, works. 2.1.1 Installing fonts in Xft Fontconfig looks for fonts in a set of well-known directories that include -all of X11R6.8.1's standard font directories +all of X11R6.8.2's standard font directories (`/usr/X11R6/lib/X11/lib/fonts/*') by default) as well as a directory called `.fonts/' in the user's home directory. Installing a font for use by Xft applications is as simple as copying a font file into one of these directo- @@ -115,7 +115,7 @@ Anti-aliasing can be disabled for all fonts by the following incantation: -Xft supports sub-pixel rasterisation on LCD displays. X11R6.8.1 should auto- +Xft supports sub-pixel rasterisation on LCD displays. X11R6.8.2 should auto- matically enable this feature on laptops and when using an LCD monitor con- nected with a DVI cable; you can check whether this was done by typing @@ -186,8 +186,8 @@ of this new directory by including it in the font path. 2.2.1 Installing bitmap fonts -The X11R6.8.1 server can use bitmap fonts in both the cross-platform BDF for- -mat and the somewhat more efficient binary PCF format. (X11R6.8.1 also sup- +The X11R6.8.2 server can use bitmap fonts in both the cross-platform BDF for- +mat and the somewhat more efficient binary PCF format. (X11R6.8.2 also sup- ports the obsolete SNF format.) Bitmap fonts are normally distributed in the BDF format. Before installing @@ -216,7 +216,7 @@ directory; see Setting the server font path (section 2.2.4, page 1) below. 2.2.2 Installing scalable fonts -The X11R6.8.1 server supports scalable fonts in four formats: Type 1, Speedo, +The X11R6.8.2 server supports scalable fonts in four formats: Type 1, Speedo, TrueType and CIDFont. This section only applies to the former three; for information on CIDFonts, please see Installing CIDFonts (section 2.2.3, page 1) later in this document. @@ -252,7 +252,7 @@ CMap `UniKS-UCS2-H' is called Munhwa-Regular--UniKS-UCS2-H -The CIDFont code in X11R6.8.1 requires a very rigid directory structure. The +The CIDFont code in X11R6.8.2 requires a very rigid directory structure. The main directory must be called `CID' (its location defaults to `/usr/X11R6/lib/X11/fonts/CID' but it may be located anywhere), and it should contain a subdirectory for every CID collection. Every subdirectory must @@ -311,7 +311,7 @@ For best results, scalable fonts should appear in the font path before the bitmap fonts; this way, the server will prefer bitmap fonts to scalable fonts when an exact match is possible, but will avoid scaling bitmap fonts when a scalable font can be used. (The `:unscaled' hack, while still supported, -should no longer be necessary in X11R6.8.1.) +should no longer be necessary in X11R6.8.2.) You may check the font path of the running server by typing the command @@ -354,11 +354,11 @@ mounted font directories). If this doesn't help, it is quite possible that you are trying to use a font in a format that is not supported by your server. -X11R6.8.1 supports the BDF, PCF, SNF, Type 1, Speedo, TrueType, OpenType and -CIDFont font formats. However, not all X11R6.8.1 servers come with all the +X11R6.8.2 supports the BDF, PCF, SNF, Type 1, Speedo, TrueType, OpenType and +CIDFont font formats. However, not all X11R6.8.2 servers come with all the font backends configured in. -On most platforms, the X11R6.8.1 servers are modular: the font backends are +On most platforms, the X11R6.8.2 servers are modular: the font backends are included in modules that are loaded at runtime. The modules to be loaded are specified in the `xorg.conf' file using the `Load' directive: @@ -366,7 +366,7 @@ specified in the `xorg.conf' file using the `Load' directive: If you have trouble installing fonts in a specific format, you may want to check the server's log file in order to see whether the relevant modules are -properly loaded. The list of font modules distributed with X11R6.8.1 is as +properly loaded. The list of font modules distributed with X11R6.8.2 is as follows: o "bitmap": bitmap fonts (`*.bdf', `*.pcf' and `*.snf'); @@ -383,7 +383,7 @@ follows: Please note that the argument of the `Load' directive is case-sensitive. -3. Fonts included with X11R6.8.1 +3. Fonts included with X11R6.8.2 3.1 Standard bitmap fonts @@ -392,7 +392,7 @@ fonts, including the `fixed' family, and bitmap versions of Courier, Times, Helvetica and some members of the Lucida family. In the SI, these fonts are provided in the ISO 8859-1 encoding (ISO Latin Western-European). -In X11R6.8.1, a number of these fonts are provided in Unicode-encoded font +In X11R6.8.2, a number of these fonts are provided in Unicode-encoded font files instead. At build time, these fonts are split into font files encoded according to legacy encodings, a process which allows us to provide the stan- dard fonts in a number of regional encodings with no duplication of work. @@ -470,7 +470,7 @@ for improved presentation of text. 3.3 Standard scalable fonts -X11R6.8.1 includes all the scalable fonts distributed with X11R6. +X11R6.8.2 includes all the scalable fonts distributed with X11R6. 3.3.1 Standard Type 1 fonts @@ -492,7 +492,7 @@ and reside in the font files /usr/X11R6/lib/X11/fonts/Type1/UT*.pfa -Finally, X11R6.8.1 also comes with Type 1 versions of Bitstream Courier and +Finally, X11R6.8.2 also comes with Type 1 versions of Bitstream Courier and Charter. These fonts have XLFD -bitstream-courier-*-*-normal--0-0-0-0-m-0-iso8859-1 @@ -504,7 +504,7 @@ and reside in the font files 3.3.2 Standard Speedo fonts -X11R6.8.1 includes Speedo versions of the Bitstream Courier and Charter +X11R6.8.2 includes Speedo versions of the Bitstream Courier and Charter fonts. In order to use these fonts, you should ensure that your X server is loading the `Speedo' font backend; see Troubleshooting (section 2.2.5, page 1). @@ -521,7 +521,7 @@ and reside in the font files 3.4 The Bigelow & Holmes Luxi family -X11R6.8.1 includes the Luxi family of scalable fonts, in both TrueType and +X11R6.8.2 includes the Luxi family of scalable fonts, in both TrueType and Type 1 format. This family consists of the fonts Luxi Serif, with XLFD -b&h-luxi serif-medium-*-normal--*-*-*-*-p-*-*-* @@ -567,11 +567,11 @@ For more information, please contact or An earlier version of the Luxi fonts was made available under the name Lucidux. This name should no longer be used due to trademark uncertainties, -and all traces of the Lucidux name have been removed from X11R6.8.1. +and all traces of the Lucidux name have been removed from X11R6.8.2. 4. More about core fonts -This section describes X11R6.8.1-specific enhancements to the core X11 fonts +This section describes X11R6.8.2-specific enhancements to the core X11 fonts system. 4.1 Core fonts and internationalisation @@ -594,7 +594,7 @@ backend) use a common fontenc layer for font re-encoding. This allows these backends to share their encoding data, and allows simple configuration of new locales independently of font type. -Please note: the X-TrueType (X-TT) backend is not included in X11R6.8.1. +Please note: the X-TrueType (X-TT) backend is not included in X11R6.8.2. That functionality has been merged into the FreeType backend.> In the fontenc layer, an encoding is defined by a name (such as iso8859-1), @@ -654,7 +654,7 @@ option followed by the name of a directory containing encoding files, can be used to automatically build `encodings.dir' files. Please see the mkfont- dir(1) manual page for more details. -A number of encoding files for common encodings are included with X11R6.8.1. +A number of encoding files for common encodings are included with X11R6.8.2. Information on writing new encoding files can be found in Format of encodings directory files (section 4.1.3, page 1) and Format of encoding files (section 4.1.4, page 1) later in this document. @@ -974,8 +974,8 @@ options are indispensable in CJKV. For example, bw=0.5:ds=y:ai=0.2:mincho.ttc -misc-mincho-bold-i-normal--0-0-0-0-c-0-jisx0201.1976-0 setup the complete combination of jisx0208 and jisx0201 using mincho.ttc -only. More information on the TTCap syntax is found on the After X-TT Pro- -ject page . +only. More information on the TTCap syntax is found on the After X-TT +Project page . The FreeType backend uses the fontenc layer in order to support recoding of fonts; this was described in The fontenc layer (section 4.1.1, page 1) and @@ -990,7 +990,7 @@ ings, but instead uses its own database of encodings. Since the functionalities for CJKV support introduced by X-TT have been merged into the new FreeType backend, the X-TT backend will be removed from -X11R6.8.1's tree near the future. Therefore, the use of FreeType backend is +X11R6.8.2's tree near the future. Therefore, the use of FreeType backend is preferred over the X-TT backend. General information on X-TrueType may be found at the After X-TT Project page @@ -1137,15 +1137,15 @@ last two fields of their XLFD set to `iso10646-1'. 6. References -X11R6.8.1 comes with extensive documentation in the form of manual pages and +X11R6.8.2 comes with extensive documentation in the form of manual pages and typeset documents. Before installing fonts, you really should read the font- config(3) and mkfontdir(1) manual pages; other manual pages of interest include X(7), Xserver(1), xset(1), Xft(3), xlsfonts(1) and showfont(1). In addition, you may want to read the X Logical Font Description document, by Jim Flowers, which is provided in the file `xc/doc/xlfd.PS.Z'. -The latest released version of the X11R6.8.1 documentation (including this -document and all manual pages) can be found from current X11R6.8.1 documenta- +The latest released version of the X11R6.8.2 documentation (including this +document and all manual pages) can be found from current X11R6.8.2 documenta- tion . The comp.fonts FAQ , which is -- cgit v1.2.3