montbl(1M)        MISC. REFERENCE MANUAL PAGES         montbl(1M)



NAME
     montbl - create monetary database

SYNOPSIS
     montbl [ -o outfile] infile

DESCRIPTION
     The montbl command takes  as  input  a  specification  file,
     infile,  that describes the formatting conventions for mone-
     tary quantities for a specific locale.

     -o outfile  Write the output on  outfile;  otherwise,  write
                 the output on a file named LCMONETARY.

     The output of montbl is suitable for use by the localeconv()
     function  (see  localeconv(3C)).  Before outfile can be used
     by   localeconv(),   it   must   be   installed    in    the
     /usr/lib/locale/locale  directory  with the name LCMONETARY
     by someone who is super-user  or  a  member  of  group  bin.
     locale  is  the locale whose monetary formatting conventions
     are described in infile.  This  file  must  be  readable  by
     user,  group, and other; no other permissions should be set.
     To  use  formatting  conventions  for  monetary   quantities
     described  in  this  file,  use  setlocale(3C) to change the
     locale   for   category   LCMONETARY   to    locale    [see
     setlocale(3C)].

     Once installed, this file will be used by  the  localeconv()
     function  to  initialize  the  monetary specific fields of a
     structure of type struct lconv.  For a description  of  each
     field in this structure, see localeconv(3C).

          struct    lconv     {
               char *decimalpoint;          /* "." */
               char *thousandssep;          /* "" (zero length string) */
               char *grouping;               /* "" */
               char *intcurrsymbol;   /* "" */
               char *currencysymbol;   /* "" */
               char *mondecimalpoint; /* "" */
               char *monthousandssep; /* "" */
               char *mongrouping;      /* "" */
               char *positivesign;          /* "" */
               char *negativesign;          /* "" */
               char intfracdigits;         /* CHARMAX */
               char fracdigits;        /* CHARMAX */
               char pcsprecedes;      /* CHARMAX */
               char psepbyspace;          /* CHARMAX */
               char ncsprecedes;      /* CHARMAX */
               char nsepbyspace;          /* CHARMAX */
               char psignposn;        /* CHARMAX */
               char nsignposn;        /* CHARMAX */
          };



          Last change: System Administration Utilities          1

montbl(1M)        MISC. REFERENCE MANUAL PAGES         montbl(1M)



     The specification file specifies the value  of  each  struct
     lconv   member,   except   for   the  first  three  members,
     decimal_point, thousands_sep, and grouping which are set  by
     the  LCNUMERIC  category  of  setlocale(3C).  Each member's
     value is given on a line with the following format:

          keyword <white space> value

     where keyword is identical to the struct  lconv  field  name
     and  value  is  a  quoted string for those fields that are a
     char * and an integer for those fields that are an int.  For
     example,

          intcurrsymbol          "ITL."
          intfracdigits          0


     will set the international currency symbol and the number of
     fractional digits to be displayed in an internationally for-
     matted monetary quantity to ITL. and 0, respectively.  Blank
     lines  and  lines starting with a # are taken to be comments
     and are ignored.  A character in a string may be in octal or
     hex representation.  For example, \141 or \x61 could be used
     to represent the letter 'a'.  If there is  no  specification
     line  for  a  given  structure  member, then the default 'C'
     locale value for that member is used (see the values in com-
     ments in the struct lconv definition above).  Given below is
     an example of what the specification file  for  Italy  would
     look like:

          # Italy

          intcurrsymbol          "ITL."
          currencysymbol          "L."
          mondecimalpoint   ""
          monthousandssep   "."
          mongrouping        "\3"
          positivesign       ""
          negativesign       "-"
          intfracdigits          0
          fracdigits         0
          pcsprecedes       1
          psepbyspace      0
          ncsprecedes       1
          nsepbyspace      0
          psignposn         1
          nsignposn         1

FILES
     /usr/lib/locale/locale/LCMONETARY
                     LCMONETARY database for locale




          Last change: System Administration Utilities          2

montbl(1M)        MISC. REFERENCE MANUAL PAGES         montbl(1M)



     /usr/lib/locale/C/montblC
                     input file used to construct LCMONETARY  in
                     the default locale.

SEE ALSO
     localeconv(3C), setlocale(3C) in the Programmer's  Reference
     Manual.
















































          Last change: System Administration Utilities          3