XSetFontPath, XGetFontPath, XFreeFontPath - set, get, or
       free the font search path


SYNTAX

       XSetFontPath(display, directories, ndirs)
             Display *display;
             char **directories;
             int ndirs;

       char **XGetFontPath(display, npaths_return)
             Display *display;
             int *npaths_return;


       XFreeFontPath(list)
             char **list;



ARGUMENTS

       directories
                 Specifies the directory path used to look for a
                 font.  Setting the path to the empty list
                 restores the default path defined for the X
                 server.

       display   Specifies the connection to the X server.

       list      Specifies the array of strings you want to free.

       ndirs     Specifies the number of directories in the path.

       npaths_return
                 Returns the number of strings in the font path
                 array.


DESCRIPTION

       The XSetFontPath function defines the directory search
       path for font lookup.  There is only one search path per X
       server, not one per client.  The encoding and interpreta-
       tion of the strings are implementation-dependent, but typ-
       ically they specify directories or font servers to be
       searched in the order listed.  An X server is permitted to
       cache font information internally; for example, it might
       cache an entire font from a file and not check on subse-
       quent opens of that font to see if the underlying font
       file has changed.  However, when the font path is changed,
       the X server is guaranteed to flush all cached information
       about fonts for which there currently are no explicit
       resource IDs allocated.  The meaning of an error from this
       request is implementation-dependent.

       XSetFontPath can generate a BadValue error.
                 cific range is specified for an argument, the
                 full range defined by the argument's type is
                 accepted.  Any argument defined as a set of
                 alternatives can generate this error.


SEE ALSO

       XListFont(3X11), XLoadFonts(3X11)
       Xlib - C Language X Interface



X Version 11               Release 6.4                          1