defoma-font(1)							defoma-font(1)



NAME
       defoma-font - register/unregister font(s) to Debian Font Manager

SYNOPSIS
       defoma-font [options] register category font hints...
       defoma-font [options] unregister category font
       defoma-font [options] reregister category font hints...
       defoma-font [options] purge category font
       defoma-font [options] register-all hintfile
       defoma-font [options] unregister-all hintfile
       defoma-font [options] reregister-all hintfile
       defoma-font [options] purge-all hintfile

DESCRIPTION
       defoma-font  is	a  tool  to  register or unregister font(s) to Defoma,
       Debian Font Manager.  Defoma  then  calls  Defoma-configuration-scripts
       provided  by applications to make the font(s) configured for the appli
       cations which can make use of them. It is supposed to  be  called  from
       postinst  and  prerm  scripts,  but may be called from console for not-
       packaged addon fonts.

       There are two methods of registering/unregistering font(s): by specify
       ing  one  font  with its hints, or through a hintfile , which describes
       several fonts with their hints.	Font packages  may  possibly  use  the
       latter  method,	installing a hintfile under /etc/defoma/hints as conf
       file.  The latter method has -all added in the commands.

       category specifies the category of a font like type1, truetype  and  so
       on.   font  specifies  the font itself and is either a full path to the
       font, or a logical font name.  hints specify the  hints	of  the  font,
       which  contain essential information of the font like FontName, Charset
       and Encoding, appearance information of the font representing its  face
       like Weight, Shape, GeneralFamily and Width, and additional information
       of the font like Alias and Priority.

COMMANDS
       register
	      Register the specified font with the specified  hints  into  the
	      specified category unless the font is already registered.

       unregister
	      Unregister  the  specified font which must be already registered
	      in the specified category.  If the font  is  marked  as  use  or
	      exclude  in  an Id cache of a certain application, the marks are
	      left intact.

       reregister
	      If the specified font  is  already  registered,  the  registered
	      hints  and the specified hints are compared. If these hints dif
	      fers, the font first gets unregistered and then newly registered
	      with  the  specified  new hints.	If the font is not registered,
	      following process is the same as register command.

       purge  This command is almost the same as  unregister  command,	except
	      that this command removes the marks in an Id cache.

       register-all

       unregister-all

       reregister-all

       purge-all
	      These  commands  operate	all the fonts written in the specified
	      hintfile.

OPTIONS
       -t     Exit with true value (0) even if error occurs.

       -v     Verbose output.

       -d     More verbose output.

       -q     Quiet output.

EXAMPLES
       defoma-font -vt register type1 /usr/share/fonts/type1/foo.pfa \
	 --FontName Helvetica --Charset ISO8859-1 --Weight Medium \
	 --Shape Upright NoSerif --GeneralFamily SansSerif
       defoma-font reregister-all /etc/defoma/hints/microsoft.hints

SEE ALSO
       defoma(1).



				March  4, 2001			defoma-font(1)