aboutsummaryrefslogtreecommitdiff
path: root/xorg-server/fonts.src/font-util/man
diff options
context:
space:
mode:
Diffstat (limited to 'xorg-server/fonts.src/font-util/man')
-rw-r--r--xorg-server/fonts.src/font-util/man/Makefile.am35
-rw-r--r--xorg-server/fonts.src/font-util/man/bdftruncate.man32
-rw-r--r--xorg-server/fonts.src/font-util/man/ucs2any.man74
3 files changed, 141 insertions, 0 deletions
diff --git a/xorg-server/fonts.src/font-util/man/Makefile.am b/xorg-server/fonts.src/font-util/man/Makefile.am
new file mode 100644
index 000000000..bf8199fc4
--- /dev/null
+++ b/xorg-server/fonts.src/font-util/man/Makefile.am
@@ -0,0 +1,35 @@
+#
+# Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a
+# copy of this software and associated documentation files (the "Software"),
+# to deal in the Software without restriction, including without limitation
+# the rights to use, copy, modify, merge, publish, distribute, sublicense,
+# and/or sell copies of the Software, and to permit persons to whom the
+# Software is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice (including the next
+# paragraph) shall be included in all copies or substantial portions of the
+# Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+# DEALINGS IN THE SOFTWARE.
+#
+
+appmandir = $(APP_MAN_DIR)
+appman_PRE = bdftruncate.man ucs2any.man
+appman_DATA = $(appman_PRE:man=$(APP_MAN_SUFFIX))
+
+EXTRA_DIST = $(appman_PRE)
+CLEANFILES = $(appman_DATA)
+SUFFIXES = .$(APP_MAN_SUFFIX) .man
+MAN_SUBSTS += -e 's|__mapfilesdir__|$(MAPDIR)|g'
+
+# String replacements in MAN_SUBSTS now come from xorg-macros.m4 via configure
+.man.$(APP_MAN_SUFFIX):
+ $(AM_V_GEN)$(SED) $(MAN_SUBSTS) < $< > $@
diff --git a/xorg-server/fonts.src/font-util/man/bdftruncate.man b/xorg-server/fonts.src/font-util/man/bdftruncate.man
new file mode 100644
index 000000000..55cc0b784
--- /dev/null
+++ b/xorg-server/fonts.src/font-util/man/bdftruncate.man
@@ -0,0 +1,32 @@
+.TH bdftruncate __appmansuffix__ __vendorversion__
+.SH NAME
+bdftruncate \- generate truncated BDF font from ISO 10646-1-encoded BDF font
+.SH SYNOPSIS
+.B bdftruncate
+.I threshold
+.B <
+.I source.bdf
+.B >
+.I destination.bdf
+.SH DESCRIPTION
+.B bdftruncate
+allows one to generate from an ISO10646-1 encoded BDF font other ISO10646-1
+BDF fonts in which all characters above a threshold code value are stored
+unencoded. This is often desirable because the Xlib API and X11 protocol
+data structures used for representing font metric information are extremely
+inefficient when handling sparsely populated fonts.
+.SH EXAMPLE
+The command
+.RS
+bdftruncate 0x3200 < 6x13.bdf > 6x13t.bdf
+.RE
+will generate the file 6x13t.bdf in which all glyphs with codes
+>= 0x3200 will only be stored unencoded (i.e., they are encoded at
+codepoint -1).
+.SH "SEE ALSO"
+.BR ucs2any (1)
+.SH AUTHOR
+.B bdftruncate
+was written by Markus Kuhn.
+.PP
+Branden Robinson wrote this manual page, originally for the Debian Project.
diff --git a/xorg-server/fonts.src/font-util/man/ucs2any.man b/xorg-server/fonts.src/font-util/man/ucs2any.man
new file mode 100644
index 000000000..0a619f457
--- /dev/null
+++ b/xorg-server/fonts.src/font-util/man/ucs2any.man
@@ -0,0 +1,74 @@
+.TH ucs2any __appmansuffix__ __vendorversion__
+.SH NAME
+ucs2any \- generate BDF fonts containing subsets of ISO 10646-1 codepoints
+.SH SYNOPSIS
+.B ucs2any
+[
+.B +d
+|
+.B -d
+]
+.I source-name
+{
+.I mapping-file
+.I registry-encoding
+}
+\&.\|.\|.
+.SH DESCRIPTION
+.B ucs2any
+allows one to generate from an ISO 10646-1 encoded BDF font other BDF fonts
+in any possible encoding. This way, one can derive from a single
+ISO 10646-1 master font a whole set of 8-bit fonts in all ISO 8859 and
+various other encodings.
+.SH OPTIONS
+.TP
+.B +d
+puts DEC VT100 graphics characters in the C0 range (default for upright,
+character-cell fonts).
+.TP
+.B \-d
+omits DEC VT100 graphics characters from the C0 range (default for all
+font types except upright, character-cell fonts).
+.SH OPERANDS
+.TP
+.I source-name
+is the name of an ISO 10646-1 encoded BDF file.
+.TP
+.I mapping-file
+is the name of a character set table like those at
+.BR <ftp://ftp.unicode.org/Public/MAPPINGS/> .
+These files can also typically be found installed in the
+.I __mapfilesdir__
+directory.
+.TP
+.I registry-encoding
+are the CHARSET_REGISTRY and CHARSET_ENCODING field values for the font
+name (XLFD) of the target font, separated by a hyphen.
+.PP
+Any number of
+.I mapping-file
+and
+.I registry-encoding
+operand pairs may be specified.
+.SH EXAMPLE
+The command
+.RS
+ucs2any 6x13.bdf 8859-1.TXT iso8859-1 8859-2.TXT iso8859-2
+.RE
+will generate the files
+.I 6x13-iso8859-1.bdf
+and
+.IR 6x13-iso8859-2.bdf .
+.SH FUTURE DIRECTIONS
+Hopefully a future release will have a facility similar to
+.B ucs2any
+built into the server, and reencode ISO 10646-1 on the fly, because
+storing the same fonts in many different encodings is clearly a waste of
+storage capacity.
+.SH "SEE ALSO"
+.BR bdftruncate (1)
+.SH AUTHOR
+.B ucs2any
+was written by Markus Kuhn.
+.PP
+Branden Robinson wrote this manual page, originally for the Debian Project.