montbl(1M)                                                       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 monetary 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 */
               };



   9/91                                                                 Page 1

   montbl(1M)                                                       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:

               value

         The line number, ignoring comment lines, in the file designates the
         field. For example, the first 7 non-comments lines will designate the
         fields intcurrsymbol though to negativesign.  All 15 lines must be
         present.

         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, a blank
         line, then the default 'C' locale value for that member is used (see
         the values in comments in the struct lconv definition above).

         Given below is an example of what the specification file for Italy
         would look like:

         # Italy
         ITL.
         L.

         .
         \3

         -
         0
         0
         1
         0
         1
         0
         1
         1

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

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



   Page 2                                                                 9/91

   montbl(1M)                                                       montbl(1M)























































   9/91                                                                 Page 3