README revision 1.1.1.2 1 1.1 mrg libXfont provides the core of the legacy X11 font system, handling the
2 1.1 mrg index files (fonts.dir, fonts.alias, fonts.scale), the various font file
3 1.1 mrg formats, and rasterizing them. It is used by the X servers, the
4 1.1 mrg X Font Server (xfs), and some font utilities (bdftopcf for instance),
5 1.1 mrg but should not be used by normal X11 clients. X11 clients access fonts
6 1.1 mrg via either the new API's in libXft, or the legacy API's in libX11.
7 1.1 mrg
8 1.1.1.2 mrg libXfont supports a number of compression and font formats, and the
9 1.1.1.2 mrg configure script takes various options to enable or disable them:
10 1.1.1.2 mrg
11 1.1.1.2 mrg -- Compression types:
12 1.1.1.2 mrg
13 1.1.1.2 mrg gzip - always enabled, no option to disable, requires libz
14 1.1.1.2 mrg
15 1.1.1.2 mrg bzip2 - disabled by default, enable via --with-bzip2, requires libbz2
16 1.1.1.2 mrg
17 1.1.1.2 mrg -- Font formats:
18 1.1.1.2 mrg
19 1.1.1.2 mrg builtins - copies of the "fixed" & "cursor" fonts required by the
20 1.1.1.2 mrg X protocol are built into the library so the X server always
21 1.1.1.2 mrg has the fonts it requires to start up. Accessed via the
22 1.1.1.2 mrg special 'built-ins' entry in the X server font path.
23 1.1.1.2 mrg Enabled by default, disable via --disable-builtins.
24 1.1.1.2 mrg
25 1.1.1.2 mrg freetype - handles scalable font formats including OpenType, FreeType,
26 1.1.1.2 mrg and PostScript formats. Requires FreeType2 library.
27 1.1.1.2 mrg Can also be used to handle bdf & bitmap pcf font formats.
28 1.1.1.2 mrg Enabled by default, disable via --disable-freetype.
29 1.1.1.2 mrg
30 1.1.1.2 mrg bdf bitmap fonts - text file format for distributing fonts, described
31 1.1.1.2 mrg in http://www.x.org/docs/BDF/bdf.pdf specification. Normally
32 1.1.1.2 mrg not used by the X server at runtime, as the fonts distributed
33 1.1.1.2 mrg by X.Org in bdf format are compiled with bdftopcf when
34 1.1.1.2 mrg installing/packaging them.
35 1.1.1.2 mrg Enabled by default, disable via --disable-bdfformat.
36 1.1.1.2 mrg
37 1.1.1.2 mrg pcf bitmap fonts - standard bitmap font format since X11R5 in 1991,
38 1.1.1.2 mrg used for all bitmap fonts installed from X.Org packages.
39 1.1.1.2 mrg Compiled format is architecture independent.
40 1.1.1.2 mrg As noted above, usually produced by bdftopcf.
41 1.1.1.2 mrg Enabled by default, disable via --disable-pcfformat.
42 1.1.1.2 mrg
43 1.1.1.2 mrg snf bitmap fonts - standard bitmap font format prior to X11R5 in 1991,
44 1.1.1.2 mrg remains only for backwards compatibility. Unlike pcf, snf files
45 1.1.1.2 mrg are architecture specific, and contain less font information
46 1.1.1.2 mrg than pcf files. snf fonts are deprecated and may be disabled
47 1.1.1.2 mrg by default in future libXfont releases.
48 1.1.1.2 mrg Enabled by default, disable via --disable-snfformat.
49 1.1.1.2 mrg
50 1.1.1.2 mrg -- Font services:
51 1.1.1.2 mrg
52 1.1.1.2 mrg xfs font servers - allows retreiving fonts as a client of an xfs server.
53 1.1.1.2 mrg Enabled by default, disable via --disable-fc (font client).
54 1.1.1.2 mrg
55 1.1.1.2 mrg If enabled, you can also use the standard libxtrans flags to
56 1.1.1.2 mrg configure which transports can be used to connect to xfs:
57 1.1.1.2 mrg --enable-unix-transport Enable UNIX domain socket transport
58 1.1.1.2 mrg --enable-tcp-transport Enable TCP socket transport (IPv4)
59 1.1.1.2 mrg --enable-ipv6 Enable IPv6 support for tcp-transport
60 1.1.1.2 mrg --enable-local-transport Enable os-specific local transport
61 1.1.1.2 mrg (Change --enable to --disable to force disabling support.)
62 1.1.1.2 mrg The default setting is to enable all of the transports the
63 1.1.1.2 mrg configure script can find OS support for.
64 1.1.1.2 mrg
65 1.1.1.2 mrg --------------------------------------------------------------------------
66 1.1.1.2 mrg
67 1.1 mrg Please submit bugs & patches to the Xorg bugzilla:
68 1.1 mrg
69 1.1 mrg https://bugs.freedesktop.org/enter_bug.cgi?product=xorg
70 1.1 mrg
71 1.1 mrg All questions regarding this software should be directed at the
72 1.1 mrg Xorg mailing list:
73 1.1 mrg
74 1.1 mrg http://lists.freedesktop.org/mailman/listinfo/xorg
75 1.1 mrg
76 1.1 mrg The master development code repository can be found at:
77 1.1 mrg
78 1.1 mrg git://anongit.freedesktop.org/git/xorg/lib/libXfont
79 1.1 mrg
80 1.1 mrg http://cgit.freedesktop.org/xorg/lib/libXfont
81 1.1 mrg
82 1.1 mrg For more information on the git code manager, see:
83 1.1 mrg
84 1.1 mrg http://wiki.x.org/wiki/GitPage
85