src/utils/xtotroff/xtotroff.man

   1 .TH XTOTROFF @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
   2 .SH NAME
   3 xtotroff \- convert X font metrics into GNU troff font metrics
   4 .
   5 .
   6 .\" --------------------------------------------------------------------
   7 .\" Legal Terms
   8 .\" --------------------------------------------------------------------
   9 .
  10 .de co
  11 Copyright \[co] 2004-2014 Free Software Foundation, Inc.
  12
  13 Permission is granted to make and distribute verbatim copies of
  14 this manual provided the copyright notice and this permission notice
  15 are preserved on all copies.
  16
  17 Permission is granted to copy and distribute modified versions of this
  18 manual under the conditions for verbatim copying, provided that the
  19 entire resulting derived work is distributed under the terms of a
  20 permission notice identical to this one.
  21
  22 Permission is granted to copy and distribute translations of this
  23 manual into another language, under the above conditions for modified
  24 versions, except that this permission notice may be included in
  25 translations approved by the Free Software Foundation instead of in
  26 the original English.
  27 ..
  28 .
  29 .\" --------------------------------------------------------------------
  30 .SH SYNOPSIS
  31 .\" --------------------------------------------------------------------
  32 .
  33 .B xtotroff
  34 [
  35 .BI \-r \%resolution
  36 ]
  37 [
  38 .BI \-s \%point-size
  39 ]
  40 [
  41 .B \-v
  42 ]
  43 .I FontMap
  44 .
  45 .
  46 .\" --------------------------------------------------------------------
  47 .SH DESCRIPTION
  48 .\" --------------------------------------------------------------------
  49 .
  50 .B xtotroff
  51 takes a
  52 .IR FontMap ,
  53 which maps
  54 .B groff
  55 fonts to X11 fonts,
  56 creates GNU
  57 .B troff
  58 metric files for all fonts listed.
  59 .
  60 Each line in
  61 .I FontMap
  62 consists of GNU
  63 .B troff
  64 font name and an X font name (XLFD) pattern, separated by whitespace.
  65 .
  66 Example:
  67 .
  68 .PP
  69 .in +2n
  70 .nf
  71 TB   -adobe-times-bold-r-normal--*-*-*-*-p-*-iso8859-1
  72 .fi
  73 .in
  74 .
  75 .
  76 .PP
  77 The wildcards in the patterns are filled with the arguments to the
  78 .B \-r
  79 and
  80 .B \-s
  81 switches.
  82 .
  83 If a font name is still ambiguous,
  84 .B xtotroff
  85 aborts.
  86 .
  87 .
  88 .\" --------------------------------------------------------------------
  89 .SH OPTIONS
  90 .\" --------------------------------------------------------------------
  91 .
  92 It is possible to have whitespace between a command line option and its
  93 parameter.
  94 .
  95 .TP
  96 .BI \-r resolution
  97 Set the resolution for all font patterns in
  98 .IR FontMap .
  99 .
 100 The value is used for both the horizontal and vertical resolution.
 101 .
 102 If not specified, a resolution of 75dpi is assumed.
 103 .
 104 .TP
 105 .BI \-s point-size
 106 Set the point size for all font patterns in
 107 .IR FontMap .
 108 .
 109 If not specified, a size of 10pt is assumed.
 110 .
 111 .TP
 112 .B \-v
 113 Print the version number.
 114 .
 115 .
 116 .\" --------------------------------------------------------------------
 117 .SH BUGS
 118 .\" --------------------------------------------------------------------
 119 The only supported font encodings are \[oq]iso8859-1\[cq] and
 120 \[cq]adobe-fontspecific\[cq].
 121 .
 122 .
 123 .\" --------------------------------------------------------------------
 124 .SH "SEE ALSO"
 125 .\" --------------------------------------------------------------------
 126 .BR gxditview (@MAN1EXT@)
 127 .
 128 .
 129 .\" --------------------------------------------------------------------
 130 .SH COPYING
 131 .\" --------------------------------------------------------------------
 132 .co
 133 .
 134 .
 135 .\" Local Variables:
 136 .\" mode: nroff
 137 .\" End: