Annotation of researchv9/X11/src/X.V11R1/clients/xfd/xfd.man, revision 1.1.1.1

1.1       root        1: .TH XFD 1 "12 June 1987" "X Version 11"
                      2: .SH NAME
                      3: xfd - X window system font displayer
                      4: .SH SYNOPSIS
                      5: .B xfd
                      6: [ =\fIgeometry\fP ] [ \fIhost\fP:\fInumber\fP ] [ options ] [ fontname ]
                      7: .SH DESCRIPTION
                      8: .I Xfd
                      9: creates a window which displays the characters in the named font.  The
                     10: characters are displayed in increasing order from left to right and top to
                     11: bottom.  The first character displayed at the top left will be character
                     12: number 0 unless the -start option has been supplied in which case the
                     13: character with the number given in the -start option will be used.
                     14: .PP
                     15: The characters are displayed in a grid of boxes, each large enough to hold any
                     16: character of the font.
                     17: If the -gray option has been supplied, the characters will be displayed using
                     18: XDrawImageString using the foreground and background colors on a
                     19: gray background.  This permits determining exactly how XDrawImageString will
                     20: draw any given character.  If -gray has not been supplied, the characters will
                     21: simply be drawn using the foreground color on the background color.
                     22: .PP
                     23: All the characters in the font may not fit in the window at once.
                     24: To see additional characters, click the right mouse button on the window.
                     25: This will cause the next window full of characters to be displayed.
                     26: Clicking the left mouse button on the window will cause the previous
                     27: window full of characters to be displayed.
                     28: .I Xfd
                     29: will beep if an attempt is made to go back past the 0th character.
                     30: .PP
                     31: Note that if the font is a 8 bit font, the characters 256-511 (0x100-0x1ff),
                     32: 512-767 (0x200-0x2ff), ... 
                     33: will display exactly the same as the characters 0-255 (0x00-0xff).
                     34: .I Xfd
                     35: by default creates a window of size sufficient to display the first 256
                     36: characters using a 16 by 16 grid.  In this case, there is no need to scroll
                     37: forward or backward window fulls in order to see the entire contents of a 8 bit
                     38: font.  Of course, this window may very well not fit on the screen...
                     39: .PP
                     40: Clicking the middle button on a character will cause that character's
                     41: number to be displayed in both decimal and hexidecimal at the bottom of the
                     42: window.  If verbose mode is selected, additional information about that
                     43: particular character will be displayed as well.  The displayed information
                     44: includes the width of the character, its left bearing, right bearing, ascent,
                     45: and its descent.  If verbose mode is selected, typing '<' or '>' into the
                     46: window will display the minimum or maximum values respectively 
                     47: taken on by each of these fields over the entire font.
                     48: .PP
                     49: The font name is interpreted by the X server.
                     50: To obtain a list of all the fonts available, use xlsfonts.
                     51: On a VAX, if the name
                     52: does not begin with ``/'', the X server adds the suffix ``.snf'' to it and
                     53: looks up the font file in the directory \fI/usr/new/lib/X/font/\fP.  If
                     54: the name does begin with ``/'', the X server treats it as an absolute
                     55: pathname of a file containing a font.
                     56: .PP
                     57: If no font name is given on the command line, 
                     58: .I Xfd
                     59: displays the font ``fixed''.
                     60: .PP
                     61: The window stays around until the xfd process is killed
                     62: or one of 'q', 'Q', ' ', or ctrl-c is typed into the
                     63: .I Xfd
                     64: window.
                     65: .SH "OPTIONS"
                     66: .PP
                     67: .TP 8
                     68: .B \fIhost\fP:\fIdisplay\fP
                     69: Normally,
                     70: .I xfd
                     71: gets the host and display number to use from the environment
                     72: variable ``DISPLAY''.  One can, however specify them explicitly.
                     73: The
                     74: .I host
                     75: specifies which machine to create the window on, and
                     76: the
                     77: .I number
                     78: argument specifies the display number.
                     79: For example,
                     80: ``orpheus:1'' creates a shell window on display one on the machine
                     81: orpheus.
                     82: .PP
                     83: .TP 8
                     84: .B \-bw \fIborderwidth\fP
                     85: Allows you to specify the width of the window border in pixels.
                     86: .PP
                     87: .TP 8
                     88: .B \-rv
                     89: The foreground and background colors will be switched.  The default colors
                     90: are black on white.
                     91: .PP
                     92: .TP 8
                     93: .B \-fw
                     94: Overrides a previous choice of reverse video, say in a .Xdefaults file.  The
                     95: foreground and background colors will not be switched.
                     96: .PP
                     97: .TP 8
                     98: .B \-fg \fIcolor\fP
                     99: On color displays, determines the foreground color.  (the color of the text)
                    100: .PP
                    101: .TP 8
                    102: .B \-bg \fIcolor\fP
                    103: On color displays, determines the background color.
                    104: .PP
                    105: .TP 8
                    106: .B \-bd \fIcolor\fP
                    107: On color displays, determines the color of the border.
                    108: .PP
                    109: .TP 8
                    110: .B \-bf \fIfontname\fP
                    111: Specifies the font to be used for the messages at the bottom of the window.
                    112: .PP
                    113: .TP 8
                    114: .B \-tl \fItitle\fP
                    115: Specifies that the title of the displayed window should be \fItitle\fP.
                    116: .PP
                    117: .TP 8
                    118: .B \-in \fIiconname\fP
                    119: Specifies that the name of the icon should be \fIiconname\fP.
                    120: .PP
                    121: .TP 8
                    122: .B \-icon \fIfilename\fP
                    123: Specifies that the bitmap in file \fIfilename\fP should be used for the icon.
                    124: .PP
                    125: .TP 8
                    126: .B \-verbose
                    127: Specifies that verbose mode should be used.
                    128: .PP
                    129: .TP 8
                    130: .B \-gray
                    131: Specifies that a gray background should be used.
                    132: .PP
                    133: .TP 8
                    134: .B \-start \fIcharnum\fP
                    135: Specifies that character number \fIcharnum\fP should be the first character
                    136: displayed.
                    137: .PP
                    138: .TP 8
                    139: .B \=\fIgeometry\fP
                    140: .I Xfd
                    141: will also take a standard geometry specification (see X(1)).
                    142: .SH "X DEFAULTS"
                    143: .I Xfd
                    144: uses a number of standard default values.
                    145: .PP
                    146: .TP 8
                    147: .B BorderWidth
                    148: Set the border width of the window.
                    149: .PP
                    150: .TP 8
                    151: .B BorderColor
                    152: Set the border color of the window.
                    153: .PP
                    154: .TP 8
                    155: .B ReverseVideo
                    156: If ``on'', reverse the definition of foreground and background color.
                    157: .PP
                    158: .TP 8
                    159: .B Foreground
                    160: Set the foreground color.
                    161: .PP
                    162: .TP 8
                    163: .B Background
                    164: Set the background color.
                    165: .PP
                    166: .TP 8
                    167: .B Border
                    168: Set the color of the border.
                    169: .PP
                    170: .TP 8
                    171: .B BodyFont
                    172: Set the font to be used in the body of the window.  (I.e., for messages, etc.)
                    173: This is not the font that \fIXfd\fP displays, just the font it uses
                    174: to display information about the font being displayed.
                    175: .PP
                    176: .TP 8
                    177: .B IconName
                    178: Set the name of the icon.
                    179: .PP
                    180: .TP 8
                    181: .B IconBitmap
                    182: Set the file we should look in to get the bitmap for the icon.
                    183: .PP
                    184: .TP 8
                    185: .B Title
                    186: Set the title to be used.
                    187: .SH FILES
                    188: /usr/new/lib/X/font/*.snf
                    189: .SH "SEE ALSO"
                    190: X(1), X(8C), xterm(1), xlsfonts(1)
                    191: .SH ENVIRONMENT
                    192: DISPLAY        -       To find out which display you are using.
                    193: .SH BUGS
                    194: It should display the name of the font somewhere.
                    195: .SH AUTHOR
                    196: Mark Lillibridge, MIT Project Athena
                    197: .br
                    198: Copyright (c) 1987 by Massachusetts Institute of Technology.
                    199: .br
                    200: See X(1) for a complete copyright notice.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.