Seth Woolley's Man Viewer

Manual for locale - man 5 locale

([section] manual, -k keyword, -K [section] search, -f whatis)
man plain no title

LOCALE(5)                      Linux User Manual                     LOCALE(5)



NAME
       locale(3,5,7) - Describes a locale(3,5,7) definition file(1,n)

DESCRIPTION
       The  locale(3,5,7)  definition  files  contains  all  the information that the
       localedef(1) command needs to convert it into the binary  locale(3,5,7)  data-
       base.

       The  definition  files consist of sections which each describe a locale(3,5,7)
       category in(1,8) detail.

SYNTAX
       The locale(3,5,7) definition file(1,n) starts with a header that may consist of the
       following keywords:

       <escape_char>
              is  followed  by  a character that should be used as the escape-
              character for the rest of  the  file(1,n)  to  mark  characters  that
              should be interpreted in(1,8) a special way. It defaults to the back-
              slash ( \ ).

       <comment_char>
              is followed by a character that will be  used  as  the  comment-
              character  for  the  rest of the file. It defaults to the number
              sign (#).


       The locale(3,5,7) definition has one part for each locale(3,5,7) category.  Each part
       can  be  copied  from  another  existing  locale(3,5,7) or can be defined from
       scratch. If the category should be copied, the only  valid  keyword  in(1,8)
       the  definition is copy followed by the name of the locale(3,5,7) which should
       be copied.


   LC_CTYPE
       The definition  for  the  LC_CTYPE  category  starts  with  the  string(3,n)
       LC_CTYPE in(1,8) the first column.

       There are the following keywords allowed:


       upper  followed  by a list of uppercase letters. The letters A trough Z
              are included automatically. Characters also specified as  cntrl,
              digit, punct, or space are not allowed.


       lower  followed  by a list of lowercase letters. The letters a trough z
              are included automatically. Characters also specified as  cntrl,
              digit, punct, or space are not allowed.


       alpha  followed by a list of letters. All character specified as either
              upper or lower are automatically included. Characters also spec-
              ified as cntrl, digit, punct, or space are not allowed.


       digit  followed  by  the  characters classified as numeric digits. Only
              the digits 0 trough 9 are allowed. They are included by  default
              in(1,8) this class.


       space  followed  by a list of characters defined as white-space charac-
              ters. Characters also specified as upper, lower,  alpha,  digit,
              graph, or xdigit are not allowed. The characters <space>, <form-
              feed>, <newline>, <carriage-return>, <tab>,  and  <vertical-tab>
              are automatically included.


       cntrl  followed by a list of control characters.  Characters also spec-
              ified as upper, lower, alpha, digit,  punct,  graph,  print,  or
              xdigit are not allowed.

       punct  followed  by  a  list of punctuation characters. Characters also
              specified as upper, lower, alpha, digit, cntrl, xdigit,  or  the
              <space> character are not allowed.


       graph  followed  by  a  list of printable characters, not including the
              <space> character.  The  characters  defined  as  upper,  lower,
              alpha,  digit,  xdigit,  and  punct  are automatically included.
              Characters also specified as cntrl are not allowed.


       print  followed by  a  list  of  printable  characters,  including  the
              <space>  character.  The  characters  defined  as  upper, lower,
              alpha, digit, xdigit, punct, and the <space> character are auto-
              matically  included.  Characters also specified as cntrl are not
              allowed.


       xdigit followed by a list of characters classified as hexadecimal  dig-
              its. The decimal digits must be included followed by one or more
              set(7,n,1 builtins) of six characters in(1,8) ascending order. The following  charac-
              ters  are  included by default: 0 trough 9, a trough f, A trough
              F.


       blank  followed by a list of characters classified as blank.  The char-
              acters <space> and <tab> are automatically included.


       toupper
              followed  by a list of mappings from lowercase to uppercase let-
              ters. Each mapping is a pair of a  lowercase  and  an  uppercase
              letter  separated with a , and enclosed in(1,8) parentheses. The mem-
              bers of the list are separated with semicolons.

       tolower
              followed by a list of mappings from uppercase to lowercase  let-
              ters.  If the keyword tolower is not present, the reverse of the
              toupper list is used.


       The LC_CTYPE definition ends with the string(3,n) END LC_CYTPE.


   LC_COLLATE
       The LC_COLLATE category defines the rules for collating characters. Due
       to limitations of libc not all POSIX-options are implemented.

       The definition starts with the string(3,n) LC_COLLATE in(1,8) the first column.

       There are the following keywords allowed:


       collating-element


       collating-symbol


       The order-definition starts with a line:

       order_start

       followed  by  a list of keywords out of forward, backward, or position.
       The order definition consists of lines that describe the order  and  is
       terminated with the keyword

       order_end.


       For  more details see the sources in(1,8) /usr/lib/nls/src notably the exam-
       ples POSIX, Example and Example2


       The LC_COLLATE definition ends with the string(3,n) END LC_COLLATE.


   LC_MONETARY
       The definition starts with the string(3,n) LC_MONETARY in(1,8) the first  column.

       There are the following keywords allowed:


       int_curr_symbol
              followed  by  the  international currency symbol. This must be a
              4-character string(3,n) containing the international currency  symbol
              as  defined by the ISO 4217 standard (three characters) followed
              by a separator.

       currency_symbol
              followed by the local currency symbol.

       mon_decimal_point
              followed by the string(3,n) that will be used as the  decimal  delim-
              iter when formatting monetary quantities.

       mon_thousands_sep
              followed  by  the  string(3,n) that will be used as a group separator
              when formatting monetary quantities.

       mon_grouping
              followed by a string(3,n) that describes the  formatting  of  numeric
              quantities.

       positive_sign
              followed  by  a  string(3,n) that is used to indicate a positive sign
              for monetary quantities.

       negative_sign
              followed by a string(3,n) that is used to indicate  a  negative  sign
              for monetary quantities.

       int_frac_digits
              followed  by the number of fractional digits that should be used
              when formatting with the int_curr_symbol.

       frac_digits
              followed by the number of fractional digits that should be  used
              when formatting with the currency_symbol.

       p_cs_precedes
              followed  by  an  integer  set(7,n,1 builtins)  to  1  if(3,n) the currency_symbol or
              int_curr_symbol
               should precede the formatted monetary quantity or set(7,n,1 builtins) to  0  if(3,n)
              the symbol succeeds the value.

       p_sep_by_space
              followed by an integer.

              0      means  that no space should be printed between the symbol
                     and the value.

              1      means that a space should be printed between  the  symbol
                     and the value.

              2      means  that  a space should be printed between the symbol
                     and the sign string(3,n), if(3,n) adjacent.

       n_cs_precedes

              0      - the symbol succeeds the value.

              1      - the symbol precedes the value.

       n_sep_by_space
              An integer set(7,n,1 builtins) to 0 if(3,n) no space separates the currency_symbol or
              int_curr_symbol from the value for a negative monetary quantity,
              set(7,n,1 builtins) to 1 if(3,n) a space separates the symbol from the value and  set(7,n,1 builtins)
              to  2  if(3,n)  a  space separates the symbol and the sign string(3,n), if(3,n)
              adjacent.

       p_sign_posn

              0      Parentheses enclose the quantity and the  currency_symbol
                     or int_curr_symbol.

              1      The  sign  string(3,n)  precedes  the  quantity  and  the cur-
                     rency_symbol or the int_curr_symbol.

              2      The sign  string(3,n)  succeeds  the  quantity  and  the  cur-
                     rency_symbol or the int_curr_symbol.

              3      The  sign  string(3,n)  precedes  the  currency_symbol  or the
                     int_curr_symbol.

              4      The sign  string(3,n)  succeeds  the  currency_symbol  or  the
                     int_curr_symbol.

       n_sign_posn

              0      Parentheses  enclose the quantity and the currency_symbol
                     or int_curr_symbol.

              1      The sign  string(3,n)  precedes  the  quantity  and  the  cur-
                     rency_symbol or the int_curr_symbol.

              2      The  sign  string(3,n)  succeeds  the  quantity  and  the cur-
                     rency_symbol or the int_curr_symbol.

              3      The sign  string(3,n)  precedes  the  currency_symbol  or  the
                     int_curr_symbol.

              4      The  sign  string(3,n)  succeeds  the  currency_symbol  or the
                     int_curr_symbol.

       The LC_MONETARY definition ends with the string(3,n) END LC_MONETARY.


   LC_NUMERIC
       The definition starts with the string(3,n) LC_NUMERIC in(1,8) the first column.

       The following keywords are allowed:


       decimal_point
              followed by the string(3,n) that will be used as the  decimal  delim-
              iter when formatting numeric quantities.

       thousands_sep
              followed  by  the  string(3,n) that will be used as a group separator
              when formatting numeric quantities.

       grouping
              followed by a string(3,n) that describes the  formatting  of  numeric
              quantities.

       The LC_NUMERIC definition ends with the string(3,n) END LC_NUMERIC.


   LC_TIME
       The definition starts with the string(3,n) LC_TIME in(1,8) the first column.

       The following keywords are allowed:


       abday  followed by a list of abbreviated weekday names. The list starts
              with Sunday or its translation.

       day    followed by a list of weekday names. The list starts  with  Sun-
              day.

       abmon  followed by a list of abbreviated month names.

       mon    followed by a list of month names.

       am_pm  The appropriate representation of the am and pm strings.

       d_t_fmt
              The appropriate date and time(1,2,n) format.

       d_fmt  The appropriate date format.

       t_fmt  The appropriate time(1,2,n) format.

       t_fmt_ampm
              The appropriate time(1,2,n) format when using 12h clock(3,n) format.

       The LC_TIME definition ends with the string(3,n) END LC_TIME.


   LC_MESSAGES
       The  definition starts with the string(3,n) LC_MESSAGES in(1,8) the first column.

       The following keywords are allowed:


       yesexpr
              followed by a regular expression that  describes  possible  yes-
              responses.

       noexpr followed  by  a  regular  expression that describes possible no-
              responses.


       The LC_MESSAGES definition ends with the string(3,n) END LC_MESSAGES.

       See the POSIX.2 standard for details.

FILES
       /usr/lib/locale(3,5,7)/ - database for the current locale(3,5,7) setting of that cat-
       egory
       /usr/lib/nls/charmap/* - charmap-files

BUGS
       The manpage isn't complete.

CONFORMING TO
       POSIX.2

SEE ALSO
       locale(3,5,7)(1), localedef(1), localeconv(3), setlocale(3), charmap(5)



National Language Support         1994-11-09                         LOCALE(5)

References for this manual (incoming links)