summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorGaetan Nadon <memsize@videotron.ca>2011-01-19 10:06:55 -0500
committerGaetan Nadon <memsize@videotron.ca>2011-01-19 10:06:55 -0500
commit6d842fb19b4c85fd1bc69db604034667c0bb7b43 (patch)
treea9426b32ef14be9db6decc1a400365c0eff49f60 /man
parentf474c8a243d89162b596376193f802916428b89f (diff)
config: move man pages into their own directory
Use services provided by XORG_MANPAGE_SECTIONS. Use standard Makefile for man pages. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
Diffstat (limited to 'man')
-rw-r--r--man/Makefile.am12
-rw-r--r--man/bdftopcf.man112
2 files changed, 124 insertions, 0 deletions
diff --git a/man/Makefile.am b/man/Makefile.am
new file mode 100644
index 0000000..e90b491
--- /dev/null
+++ b/man/Makefile.am
@@ -0,0 +1,12 @@
+
+appmandir = $(APP_MAN_DIR)
+appman_PRE = bdftopcf.man
+appman_DATA = $(appman_PRE:man=$(APP_MAN_SUFFIX))
+
+EXTRA_DIST = $(appman_PRE)
+CLEANFILES = $(appman_DATA)
+SUFFIXES = .$(APP_MAN_SUFFIX) .man
+
+# 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/man/bdftopcf.man b/man/bdftopcf.man
new file mode 100644
index 0000000..cd8f8cc
--- /dev/null
+++ b/man/bdftopcf.man
@@ -0,0 +1,112 @@
+.\" Copyright 1993, 1994, 1998 The Open Group
+.\"
+.\" Permission to use, copy, modify, distribute, and sell this software and its
+.\" documentation for any purpose is hereby granted without fee, provided that
+.\" the above copyright notice appear in all copies and that both that
+.\" copyright notice and this permission notice appear in supporting
+.\" documentation.
+.\"
+.\" The above copyright notice and this permission notice 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 OPEN GROUP 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.
+.\"
+.\" Except as contained in this notice, the name of The Open Group shall
+.\" not be used in advertising or otherwise to promote the sale, use or
+.\" other dealings in this Software without prior written authorization
+.\" from The Open Group.
+.\"
+.TH BDFTOPCF 1 __xorgversion__
+.SH NAME
+bdftopcf \- convert X font from Bitmap Distribution Format to Portable
+Compiled Format
+.SH SYNOPSIS
+.B bdftopcf
+[
+.BI \-p n
+] [
+.BI \-u n
+] [
+.B \-m
+] [
+.B \-l
+] [
+.B \-M
+] [
+.B \-L
+] [
+.B \-t
+] [
+.B \-i
+] [
+.B \-o
+.I outputfile
+] fontfile.bdf
+.SH DESCRIPTION
+.I Bdftopcf
+is a font compiler for the X server and font server.
+Fonts in Portable Compiled Format can be
+read by any architecture, although the file is structured to allow one
+particular architecture to read them directly without reformatting. This
+allows fast reading on the appropriate machine, but the files are still
+portable (but read more slowly) on other machines.
+.SH OPTIONS
+.TP 8
+.B \-p\fIn\fP
+Sets the font glyph padding. Each glyph in the font will have each scanline
+padded in to a multiple of \fIn\fP bytes, where \fIn\fP is 1, 2, 4 or 8.
+.TP 8
+.B \-u\fIn\fP
+Sets the font scanline unit. When the font bit order is different from the
+font byte order, the scanline unit \fIn\fP describes what unit of data (in
+bytes) are to be swapped; the unit \fIi\fP can be 1, 2 or 4 bytes.
+.TP 8
+.B \-m
+Sets the font bit order to MSB (most significant bit) first. Bits for each
+glyph will be placed in this order; i.e., the left most bit on the screen
+will be in the highest valued bit in each unit.
+.TP 8
+.B \-l
+Sets the font bit order to LSB (least significant bit) first. The left most
+bit on the screen will be in the lowest valued bit in each unit.
+.TP 8
+.B \-M
+Sets the font byte order to MSB first. All multi-byte data in the file
+(metrics, bitmaps and everything else) will be written most significant byte
+first.
+.TP 8
+.B \-L
+Sets the font byte order to LSB first. All multi-byte data in the file
+(metrics, bitmaps and everything else) will be written least significant
+byte first.
+.TP 8
+.B \-t
+When this option is specified,
+.I bdftopcf
+will convert fonts into "terminal" fonts when possible. A terminal font has
+each glyph image padded to the same size; the X server can usually render
+these types of fonts more quickly.
+.TP 8
+.B \-i
+This option inhibits the normal computation of ink metrics. When a font has
+glyph images which do not fill the bitmap image (i.e., the "on" pixels don't
+extend to the edges of the metrics)
+.I bdftopcf
+computes the actual ink metrics and places them in the .pcf file; the \-t
+option inhibits this behaviour.
+.TP 8
+.BI "\-o " output-file-name
+By default
+.I bdftopcf
+writes the pcf file to standard output; this option gives the name of a file
+to be used instead.
+.SH "SEE ALSO"
+X(__miscmansuffix__)
+.SH AUTHOR
+Keith Packard, MIT X Consortium