[xfonts-traditional] / update-xfonts-traditional.8

.\" Hey, Emacs!  This is an -*- nroff -*- source file.
.TH UPDATE\-XFONTS\-TRADITIONAL 8 "2012" "Greenend" "chiark utilities"
.SH NAME
update\-xfonts\-traditional \- generate traditional ASCII fixed-with fonts
.SH SYNOPSIS
.B update\-xfonts\-traditional --bdf-filter
.LP
.B update\-xfonts\-traditional --process-pcf \fIin.pcf.gz\fP \fIout.pcf.gz\fP
.LP
.B update\-xfonts\-traditional --process-fontdirs \fIfontdir\fR ...
.LP
.B update\-xfonts\-traditional --process-fonttrees \fIfonttree\fR ...
.SH DESCRIPTION
.B update\-xfonts\-traditional
generates versions of X11 PCF fonts which have been edited to restore
compatibility with traditional versions of US-ASCII, and to restore
some of the glyphs to more traditional appearance.
.SH MODES
.TP
.BI --bdf-filter
Takes a BDF on standard input and tries to generate an edited BDF on
standard output.
.TP
.BI --process-pcf
Takes to PCF filename arguments; the input PCF is uncompressed,
decompiled to a BDF, processed, recompiled to a PCF and recompressed.
.TP
.BI --process-fontdirs
In each
.I fontdir
all files
.IB font .pcf.gz
are processed, to generate where applicable corresponding
.BI trad-- font .pcf.gz
files.  The mtime, ctime and inode number of the input files are
recorded so that reprocessing the same directory later will be fast.
.TP
.BI --process-fonttrees
Each
.I fonttree
is searched for font directories which are processed as above.
.TP
.BI --update
Each built in font tree location is searched for font directories
which are processed as above.
.SH OPTIONS
.TP
\fB-R\fP|\fB--rules-path\fP \fIrulespath\fP
Prepend
.I rulespath
to the path of directories from which to load glyph editing rules.
.TP
\fB--share-dir\fP \fIshare-dir\fP
Use
.I share-dir
instead of
.BR "/usr[/local]/share/xfonts-traditional" .
.SH FILES
.TP
.B xfonts-traditional.done
In each font directory, records information about processed fonts, so
as to optimise away unnecessary reprocessing.
.TP
.B xfonts-traditional.log
In each font directory, records a lot of which fonts were processed
and to a certain extent if not why not.
.TP
.B /usr/share/fonts/X11 /usr/local/share/fonts/X11
Default font tree paths for --update.
.TP
.BI trad-- font .pcf.gz
In any font directory, our output files.  Any other files matching
this pattern may be overwritten or deleted.
.SH EXIT STATUS
.TP
.B 0
All went well and there were no warnings.
.TP
.B 2
With
.B --bdf-filter
and
.B --process-pcf
only, indicates that the input font did not need to
be edited, or was not suitable for editing, and has
.B not
been written out, so the output is incomplete, but this is not an
error.
.TP
any other
There were problems.
.SH BUGS
Only the 6x13 font conventionally called \"fixed\" is currently
supported.  This package comes too late to rescue Unix from an
incompatible change to its character set.
Commit	Line	Data
a0ceefde IJ	1	.\" Hey, Emacs! This is an -- nroff -- source file.
	2	.TH UPDATE\-XFONTS\-TRADITIONAL 8 "2012" "Greenend" "chiark utilities"
	3	.SH NAME
	4	update\-xfonts\-traditional \- generate traditional ASCII fixed-with fonts
	5	.SH SYNOPSIS
	6	.B update\-xfonts\-traditional --bdf-filter
	7	.LP
	8	.B update\-xfonts\-traditional --process-pcf \fIin.pcf.gz\fP \fIout.pcf.gz\fP
	9	.LP
	10	.B update\-xfonts\-traditional --process-fontdirs \fIfontdir\fR ...
	11	.LP
	12	.B update\-xfonts\-traditional --process-fonttrees \fIfonttree\fR ...
	13	.SH DESCRIPTION
	14	.B update\-xfonts\-traditional
	15	generates versions of X11 PCF fonts which have been edited to restore
	16	compatibility with traditional versions of US-ASCII, and to restore
	17	some of the glyphs to more traditional appearance.
	18	.SH MODES
	19	.TP
	20	.BI --bdf-filter
	21	Takes a BDF on standard input and tries to generate an edited BDF on
	22	standard output.
	23	.TP
	24	.BI --process-pcf
	25	Takes to PCF filename arguments; the input PCF is uncompressed,
	26	decompiled to a BDF, processed, recompiled to a PCF and recompressed.
	27	.TP
	28	.BI --process-fontdirs
	29	In each
	30	.I fontdir
	31	all files
	32	.IB font .pcf.gz
	33	are processed, to generate where applicable corresponding
	34	.BI trad-- font .pcf.gz
	35	files. The mtime, ctime and inode number of the input files are
	36	recorded so that reprocessing the same directory later will be fast.
	37	.TP
	38	.BI --process-fonttrees
	39	Each
	40	.I fonttree
	41	is searched for font directories which are processed as above.
	42	.TP
	43	.BI --update
	44	Each built in font tree location is searched for font directories
	45	which are processed as above.
	46	.SH OPTIONS
	47	.TP
	48	\fB-R\fP\|\fB--rules-path\fP \fIrulespath\fP
	49	Prepend
	50	.I rulespath
	51	to the path of directories from which to load glyph editing rules.
	52	.TP
	53	\fB--share-dir\fP \fIshare-dir\fP
	54	Use
	55	.I share-dir
	56	instead of
	57	.BR "/usr[/local]/share/xfonts-traditional" .
	58	.SH FILES
	59	.TP
	60	.B xfonts-traditional.done
	61	In each font directory, records information about processed fonts, so
	62	as to optimise away unnecessary reprocessing.
	63	.TP
	64	.B xfonts-traditional.log
65	In each font directory, records a lot of which fonts were processed
66	and to a certain extent if not why not.
67	.TP
68	.B /usr/share/fonts/X11 /usr/local/share/fonts/X11
69	Default font tree paths for --update.
70	.TP
71	.BI trad-- font .pcf.gz
72	In any font directory, our output files. Any other files matching
73	this pattern may be overwritten or deleted.
74	.SH EXIT STATUS
75	.TP
76	.B 0
77	All went well and there were no warnings.
78	.TP
79	.B 2
80	With
81	.B --bdf-filter
82	and
83	.B --process-pcf
84	only, indicates that the input font did not need to
85	be edited, or was not suitable for editing, and has
86	.B not
87	been written out, so the output is incomplete, but this is not an
88	error.
89	.TP
90	any other
91	There were problems.
92	.SH BUGS
93	Only the 6x13 font conventionally called \"fixed\" is currently
94	supported. This package comes too late to rescue Unix from an
95	incompatible change to its character set.