FMCATOPEN(3A)                                       FMCATOPEN(3A)



  NAME
       FmCatOpen, FmCatClose - open and close a message catalog for
       reading by XFaceMaker 2


  SYNOPSIS
       #include <nl_types.h>

       nl_catd FmCatOpen (name, 0)
       char *name;

       FmCatClose (cat)
       nl_catd cat;

  DESCRIPTION
       Open an internationalized message catalog.  As required by
       catopen(3), the second argument to FmCatOpen is always zero.
       Although the catalog descriptor is returned, FaceMaker
       remembers all catalogs opened with FmCatOpen and uses them
       to find messages when FmCatGetS is called.  The catalogs
       opened by FmCatOpen are checked in reverse order, so more
       specific catalogs should be opened after more general ones.

       FmCatClose closes a catalog descriptor previously opened by
       FmCatOpen and removes it from the list of message catalogs
       searched by FmCatGetS.

  NOTES
       AtariLibInit(3A) calls FmCatOpen twice, first with the name
       of the Atari Library catalog file, ""AtariLib"", then with
       the application program name.

  SEE ALSO
       catopen(3), catgets(3), AtariLibInit(3A), FmCatGetS(3A)








  Page 1                                           (printed 9/3/91)