Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
MKFONTSCALE(1)		    General Commands Manual		MKFONTSCALE(1)

       mkfontscale - create an index of	scalable font files for	X

       mkfontscale [ -b	] [ -s ] [ -o filename ] [ -x suffix ] [ -a encoding ]
       ... [ -f	fuzz ] [ -l ] [	-e directory ] [ -p prefix ] [ -r prefix  ]  [
       -n prefix ] [ -u	| -U ] [ -v ] [	-- ] [ directory ] ...

       For each	directory argument, mkfontscale	reads all of the scalable font
       files in	the directory.	For every font file found, an  X11  font  name
       (XLFD)  is  generated,  and is written together with the	file name to a
       file fonts.scale	in the directory.

       The resulting fonts.scale file should be	checked	and possibly  manually
       edited before being used	as input for the mkfontdir(1) program.

       -b     read bitmap fonts.  By default, bitmap fonts are ignored.

       -s     ignore scalable fonts.  By default, scalable fonts are read.  If
	      -b is set, this flag has the side	effect of enabling the reading
	      of fonts.scale files.

       -o filename
	      send  program output to filename;	default	is fonts.scale if bit-
	      map fonts	are not	being read, and	fonts.dir  if  they  are.   If
	      filename	is relative, it	is created in the directory being pro-
	      cessed.  If it is	the special value  -,  output  is  written  to
	      standard output.

       -x suffix
	      exclude all files	with the specified suffix.

       -a encoding
	      add encoding to the list of encodings searched for.

       -f fuzz
	      set  the fraction	of characters that may be missing in large en-
	      codings to fuzz percent.	Defaults to 2%.

       -l     Write fonts.dir files suitable for implementations  that	cannot
	      reencode	legacy fonts (BDF and PCF).  By	default, it is assumed
	      that the	implementation	can  reencode  Unicode-encoded	legacy

       -e     specifies	a directory with encoding files.  Every	such directory
	      is scanned for encoding files, the list of which is then written
	      to an "encodings.dir" file in every font directory.

       -p     Specifies	 a  prefix that	is prepended to	the encoding file path
	      names when they are written to the  "encodings.dir"  file.   The
	      prefix  is prepended literally: if a `/' is required between the
	      prefix and the path names, it must  be  supplied	explicitly  as
	      part of the prefix.

       -r     Keep  non-absolute  encoding  directories	in their relative form
	      when writing the "encodings.dir" file.  The default is  to  con-
	      vert  relative  encoding	directories to absolute	directories by
	      prepending the current directory.	 The positioning of  this  op-
	      tions  is	significant, as	this option only applies to subsequent
	      -e options.

       -n     do not scan for fonts, do	not write font directory files.	  This
	      option is	useful when generating encoding	directories only.

       -u, -U disable  (-u) or enable (-U) indexing of ISO 10646:1 font	encod-
	      ings (default: enabled).

       -v     print program version and	exit.

       --     end of options.

       X(7), Xserver(1), mkfontdir(1), ttmkfdir(1), xfs(1), xset(1)

       The format of the fonts.scale, fonts.dir	 and  encodings.dir  files  is
       documented in the mkfontdir(1) manual page.

       Mkfontscale  will  overwrite  any  fonts.scale file even	if it has been

       mkfontscale -b -s -l is equivalent to mkfontdir.

       The version of mkfontscale included in this  X.Org  Foundation  release
       was  originally written by Juliusz Chroboczek <> for
       the XFree86 project.  The functionality of this program was inspired by
       the ttmkfdir utility by Joerg Pommnitz.

X Version 11		       mkfontscale 1.1.2		MKFONTSCALE(1)


Want to link to this manual page? Use this URL:

home | help