diff options
Diffstat (limited to 'adv_cmds/localedef/localedef.1')
| -rw-r--r-- | adv_cmds/localedef/localedef.1 | 122 |
1 files changed, 122 insertions, 0 deletions
diff --git a/adv_cmds/localedef/localedef.1 b/adv_cmds/localedef/localedef.1 new file mode 100644 index 0000000..c8f3907 --- /dev/null +++ b/adv_cmds/localedef/localedef.1 @@ -0,0 +1,122 @@ +.\"Modified from man(1) of FreeBSD, the NetBSD mdoc.template, and mdoc.samples. +.Dd September 9, 2004 +.Dt LOCALEDEF 1 +.Os Darwin +.Sh NAME +.Nm localedef +.Nd define locale environment +.Sh SYNOPSIS +.Nm +.Op Fl c +.Op Fl f Ar charmap +.Op Fl i Ar sourcefile +.Ar name +." localedef [-c][-f charmap][-i sourcefile] name +.Sh DESCRIPTION +The +.Nm +utility reads source definitions for one or more locale categories +belonging to the same locale from the file named in the +.Fl i +option (if specified) or from standard input. +.Pp +The +.Ar name +operand identifies the target locale. The +.Nm +utility supports +the creation of public, or generally accessible locales, as well +as private, or restricted-access locales. +.Pp +Each category source definition is identified by the corresponding +environment variable name and terminated by an END category-name +statement. +.Pp +.Bl -tag -width "LC_MONETARY" -compact -offset indent +.It LC_CTYPE +Defines character classification and case conversion. +.It LC_COLLATE +Defines collation rules. +.It LC_MONETARY +Defines the format and symbols used in formatting of monetary information. +.It LC_NUMERIC +Defines the decimal delimiter, grouping, and grouping symbol for non-monetary numeric editing. +.It LC_TIME +Defines the format and content of date and time information. +.It LC_MESSAGES +Defines the format and values of affirmative and negative responses. +.El +.Sh OPTIONS +The following options are supported: +.Pp +.Bl -tag -width -indent +.It Fl c +Create permanent output even if warning messages have been issued. +.It Fl f Ar charmap +Specify the pathname of a file containing a mapping of character symbols and collating element symbols to actual character encodings. +.It Fl i Ar sourcefile +The pathname of a file containing the source definitions. If this option is not present, source definitions will be read from standard input. +.El +.Sh OPERANDS +The following operand is supported: +.Bl -tag -width -indent +.It Ar name +Identifies the locale. +If the name contains one or more slash characters, +.Ar name +will be interpreted as a pathname +where the created locale definitions will be stored. +If +.Ar name +does not contain any slash characters, +the locale will be public. +This capability is restricted to users with appropriate privileges. +(As a consequence of specifying one name, +although several categories can be processed in one execution, +only categories belonging to the same locale can be processed.) +.El +.Sh ENVIRONMENT +The following environment variables affect the execution of +.Nm : +.Bl -tag -width "LC_COLLATE" +.It Ev LANG +Provide a default value for the internationalization variables +that are unset or null. +If LANG is unset or null, +the corresponding value from the implementation-dependent default locale +will be used. +If any of the internationalization variables contains an invalid setting, +the utility will behave as if none of the variables had been defined. +.It Ev LC_ALL +If set to a non-empty string value, override the values of all the other internationalization variables. +.It Ev LC_COLLATE +(This variable has no effect on +.Nm ; +the POSIX locale will be used for this category.) +.It Ev LC_CTYPE +Determine the locale for the interpretation of sequences of bytes +of text data as characters +(for example, single- as opposed to multi-byte characters +in arguments and input files). +This variable has no effect on the processing of +.Nm +input data; +the POSIX locale is used for this purpose, +regardless of the value of this variable. +.It Ev LC_MESSAGES +Determine the locale that should be used to affect the format and contents of diagnostic messages written to standard error. +.It Ev NLSPATH +Determine the location of message catalogues for the processing of LC_MESSAGES. +.El +.Sh EXIT STATUS +The following exit values are returned: +.Bl -tag -width -indent +.It 0 +No errors occurred and the locales were successfully created. +.It 1 +Warnings occurred and the locales were successfully created. +.It 2 +The locale specification exceeded implementation limits or the coded character set or sets used were not supported by the implementation, and no locale was created. +.It >2 +Warnings or errors occurred and no output was created. +.El |