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

FreeBSD Manual Pages

  
 
  

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

NAME
       mkfontscale - create an index of	scalable font files for	X

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

DESCRIPTION
       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.

OPTIONS
       -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
	      bitmap fonts are not being read, and fonts.dir if	they are.   If
	      filename	is  relative,  it  is  created	in the directory being
	      processed.  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
	      re-encode	legacy fonts (BDF and PCF).  By	default, it is assumed
	      that  the	 implementation	 can  re-encode	Unicode-encoded	legacy
	      fonts.

       -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.

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

NOTES
       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
       hand-edited.

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

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

X Version 11		       mkfontscale 1.2.3		MKFONTSCALE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mkfontscale&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help