HPUX nlsinfo[1]






 nlsinfo(1)                                                       nlsinfo(1)





 NAME
      nlsinfo - display native language support information

 SYNOPSIS
      nlsinfo [-acfhilmnstC] [-d n] [-e n] [-o n] [-r n1 n2] [-L language]

    Remarks:
      nlsinfo is provided for historical reasons only.  Use locale instead
      (see locale(1)).

 DESCRIPTION
      nlsinfo displays a list of installed Native Language Support (NLS)
      international environment languages, and displays information
      contained within the runtime locale associated with these languages
      (see setlocale(3C)).  Commands and routines modified for NLS operation
      (see EXTERNAL INFLUENCES section in applicable manual entries) use the
      information contained within locales to process and display data
      according to the local language and customs of a user (see hpnls(5)).
      Unless overridden by the -L option, the runtime locale is determined
      by the locale category environment variables (those that begin with
      LC_) and the LANG environment variable.

      By default, non-printable characters are displayed as 2-digit
      hexadecimal numbers unless they are included within strings, in which
      case the hexadecimal numbers are preceded by \x.

    Options
      The following options are recognized:

           -l             Display the list of installed international
                          environment languages.

           -a             Display the LC_ALL locale category which contains
                          all parts of the selected locale.  Equivalent to
                          specifying options -csntmh.

           -c             Display the LC_CTYPE locale category that contains
                          character classification and conversion
                          information (see ctype(3C), conv(3C), and
                          nl_tools_16(3C)).

           -s             Display the LC_COLLATE locale category that
                          contains collating (sorting) information (see
                          strcoll(3C) and strxfrm(3C)).

           -n             Display the LC_NUMERIC locale category which
                          contains information regarding the radix character
                          and thousands separator.

           -t             Display the LC_TIME locale category which contains
                          such information as the format of the date and



 Hewlett-Packard Company            - 1 -     HP-UX Release 9.0: August 1992






 nlsinfo(1)                                                       nlsinfo(1)





                          time and the names of the days of the week (see
                          strftime(3C)).

           -m             Display the LC_MONETARY locale category which
                          contains information for the formatting of
                          monetary quantities.

           -h             Display all other local custom information not
                          included in the LC_NUMERIC, LC_TIME, and
                          LC_MONETARY locale categories.

           -i             Display a list of abbreviated "from" and "to" code
                          set names used by iconv the code set conversion
                          utility (see iconv(1)).  Each "from" and "to" code
                          set name pair represents a conversion supported by
                          iconv.

           -C             Display all the characters defined in the selected
                          NLS environment's code set.  The list of
                          characters may be quite long for some Asian NLS
                          environments.

           If none of the options l, a, c, s, n, t, m, h, i, or C is
           specified, -l is used as a default.

           -f             Place a form feed character before all category
                          display headings.

           -o n           Display non-printable characters as numbers using
                          the base specified by n.  If n is o, display non-
                          printable characters as 3-digit octal numbers.  If
                          n is x, display non-printable characters as 2-
                          digit hex numbers.  If non-printable characters
                          are included within strings, the octal or hex
                          numbers are preceded by a backslash (\).

           -e n           Display all characters (including printable
                          characters) as hexadecimal or octal numbers.  If n
                          is o, display characters as 3-digit octal numbers.
                          If n is x, display characters as 2-digit hex
                          numbers.  If characters are included within
                          strings, the octal or hex numbers are preceded by
                          a backslash (\).

           -d n           Display n lines between headings.  By default 16
                          lines are displayed between headings.

           -r n1 n2       Display information only about element number n1
                          through element number n2 of the requested
                          table(s), rather than all elements of each table.
                          The parameters n1 and n2 can be hexadecimal



 Hewlett-Packard Company            - 2 -     HP-UX Release 9.0: August 1992






 nlsinfo(1)                                                       nlsinfo(1)





                          (preceded by 0x), octal (preceded by 0), or
                          decimal numbers.  These parameters can also be
                          characters, in which case each character is mapped
                          to its value in the code set of the user's current
                          locale (not the locale, if any, specified via the
                          -L option).  Characters that are digits should be
                          quoted with the backslash character (\) to prevent
                          them from being interpreted as numbers.

           -L language    Display information about the locale associated
                          with language instead of the locale specified by
                          the setlocale category and LANG environment
                          variables.  The parameter language should be one
                          of the language names from the output of nlsinfo
                          -l (ell) (the valid language names are also given
                          in lang(5)).

 EXTERNAL INFLUENCES
    Environment Variables
      The LC_CTYPE environment variable determines how option argument
      characters are mapped to a value in the code set.

      The LANG environment variable determines the language in which
      messages and headings are displayed.

    International Code Set Support
      Single- and multi-byte-character code sets are supported with the
      exception of multi-byte-character file names.

 WARNINGS
      The format and content of the display of a particular table may change
      if the underlying NLS implementation is changed to support new
      features.  Applications should not use the information displayed by
      nlsinfo as the basis for their operation, but rather should use the
      interface routines provided in LIBC (see conv(3C), ctype(3C),
      langinfo(3C), nl_tools_16(3C), setlocale(3C), string(3C) and
      buildlang(1M)).

 AUTHOR
      nlsinfo was developed by HP.

 FILES
      /usr/lib/nls/config
      /usr/lib/nls/$LANG/locale.def

 SEE ALSO
      buildlang(1M), iconv(1), conv(3C), ctype(3C), langinfo(3C),
      nl_tools_16(3C), setlocale(3C), string(3C), environ(5), hpnls(5),
      lang(5).





 Hewlett-Packard Company            - 3 -     HP-UX Release 9.0: August 1992