.\" Hey Emacs, this is -*- nroff -*-
.\"
.\" This file is part of locale(1) which displays the settings of the
.\" current locale.
.\" Copyright (C) 1994  Jochen Hein (Hein@Student.TU-Clausthal.de)
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.\" Translated 17 Dec 1997 by Gerardo.Aburruzaga@uca.es
.\" Translation revised Tue Aug 18 1998 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH locale 5 "17 Dic 1997" "Soporte de Lengua Nacional" "Manual del Usuario"
.SH NOMBRE
locale \- Describe un fichero de definicin de localizacin
.SH
DESCRIPCIN
Los ficheros de definicin de localizacin o
.B locale
contienen toda la informacin que la orden
.B localedef(1) 
necesita para convertirlos a la base de datos binaria de localizacin.

Los ficheros de definicin constan de secciones, cada una de las
cuales describe en detalle una categora de localizacin.
.SH SINTAXIS
El fichero de definicin de localizacin comienza con una cabecera,
que puede constar de las siguientes palabras reservadas:
.TP
.I <escape_char>
seguido por un carcter que debe emplearse como el carcter de escape
para el resto del fichero para sealar caracteres que deban
interpretarse de un modo especial. Si no se dice otra cosa, es la
barra invertida (
.B \\\\  
).
.TP
.I <comment_char>
seguido por un carcter que se emplear como el de comentario en el
resto del fichero. Por omisin es el sostenido (
.B #
).

.PP
Las definiciones de localizacin se dividen en una parte para cada
categora de localizacin. Cada parte puede copiarse de otra
localizacin existente, o puede definirse desde cero. Si la categora
ha de copiarse, la nica palabra reservada permitida en la definicin es
.B copy
seguida por el nombre de la localizacin que debe ser copiada.

.SS LC_CTYPE
La definicin para la categora
.B LC_CTYPE
copienza por la cadena
.I LC_CTYPE 
en la primera columna.

Se permiten las siguientes palabras reservadas:

.TP
.I upper
seguido por una lista de letras maysculas. Las letras desde la
.B A
hasta la
.B Z
se incluyen automticamente. Los caracteres tambin especificados como
.B cntrl, digit, punct
o
.B space
no se permiten.

.TP
.I lower
seguido por una lista de letras minsculas. Las letras desde la
.B a
hasta la
.B z
se incluyen automticamente. Los caracteres tambin especificados como
.B cntrl, digit, punct
o
.B space
no se permiten.

.TP
.I alpha
seguido por una lista de letras. Todos los caracteres especificados como
.B upper
o 
.B lower
se incluyen automticamente. Los caracteres tambin especificados como
.B cntrl, digit, punct
o
.B space
no se permiten.

.TP
.I digit
seguidos por los caracteres clasificados como dgitos
numricos. Solamente se permiten los guarismos desde el
.B 0 
hasta el 
.B 9 .
Se incluyen de forma predeterminada en esta clase.

.TP
.I space
seguido por una lista de caracteres definidos como blancos. Los
caractares tambin especificados como
.B upper, lower, alpha, digit, graph
o
.B xdigit
no se permiten. Los caracteres
.B <space>, <form-feed>, <newline>, <carriage-return>, <tab>,
y
.B <vertical-tab>
se incluyen automticamente.

.TP
.I cntrl
seguido por una lista de caracteres de control.
Los caracteres tambin especificados como
.B upper, lower, alpha, digit, punct, graph, print
o
.B xdigit
no se permiten.
.TP
.I punct
seguido por una lista de caracteres de puntuacin. Los caracteres
tambin especificados como
.B upper, lower, alpha, digit, cntrl, xdigit
o el carcter de espacio
.B <space>
no son permitidos.

.TP
.I graph
seguido por una lista de caracteres imprimibles, sin incluir el carcter
.B <space>.
Los caracteres definidos como
.B upper, lower, alpha, digit, xdigit
y
.B punct 
se incluyen automticamente.
Los caracteres tambin especificados como
.B cntrl
no se permiten.

.TP
.I print
seguido por una  lista de caracteres imprimibles, incluyendo el
.B <space>.
Los caracteres definidos como
.B upper, lower, alpha, digit, xdigit, punct
y el
.B <space>
se incluyen automticamente. Los caracteres tambin especificados como
.B cntrl
no se permiten.

.TP
.I xdigit
seguido por una lista de caracteres clasificados como dgitos
hexadecimales. Los dgitos en base diez deben incluirse seguidos por
uno o ms conjuntos de seis caracteres en orden ascendente. Por
omisin se incluyen los siguientes caracteres:
del
.B 0
al
.B 9,
de la
.B a
a la
.B f,
de la
.B A
a la
.B F.

.TP
.I blank
seguido por una lista de caracteres clasificados como
.B blancos.
Los caracteres
.B <space>
y 
.B <tab>
se incluyen automticamente.

.TP
.I toupper
seguido por una lista de correspondencias de letras minsculas a
maysculas. Cada correspondencia es una pareja de letra minscula y su
correspondiente mayscula separadas por una coma
.B ,
y encerradas entre parntesis. Los miembros de la lista se separan por
punto y coma.
.TP
.I tolower
seguido por una lista de correspondencias de letras maysculas a
minsculas. Si esta palabra reservada est ausente, se emplea el
inverso de la lista \fBtoupper\fP.

.PP
La definicin 
.B LC_CTYPE
acaba con la cadena
.I END LC_CTYPE.

.SS LC_COLLATE
La categora 
.B LC_COLLATE
define las reglas para clasificar caracteres. Debido a limitaciones de
la biblioteca de C (\fIlibc\fP) no todas las opciones POSIX estn implementadas.

La definicin empieza con la cadeda
.B LC_COLLATE
en la primera columna.

Se permiten las siguientes palabras reservadas:

.TP
.I collating-element

.TP
.I collating-symbol

.PP
La definicin de orden empieza con una lnea:
.TP
.I order_start
.PP
seguido por una lista de palabras reservadas de entre
.B forward,
.B backward
o
.B position.
La definicin de orden consiste en lneas que describen el orden y
acaba con la palabra reservada
.TP
.I order_end.
.PP

Para ms detalles consulte los fuentes en
.B /usr/lib/nls/src
sobre todo los ejemplos
.B POSIX,
.B Example
y 
.B Example2

.PP
La definicin 
.B LC_COLLATE
acaba con la cadena
.I END LC_COLLATE.

.SS LC_MONETARY
La definicin empieza con la cadena
.B LC_MONETARY
en la primera columna.

Se permiten las siguientes palabras reservadas:

.TP
.I int_curr_symbol
seguido por el smbolo monetario internacional. ste debe ser una
cadena de cuatro caracteres que contenga el smbolo monetario
internacional como lo define el estndar ISO 4217 (tres caracteres)
seguido por un separador.
.TP
.I currency_symbol
seguido por el smbolo monetario local.
.TP
.I mon_decimal_point
seguido por la cadena que se emplear como delimitador de decimales
cuando se formateen cantidades monetarias.
.TP
.I mon_thousands_sep
seguido por la cadena que se emplear como separador de grupo cuando
se formateen cantidades monetarias.
.TP
.I mon_grouping
seguido por una cadena que describa el formateo de cantidades numricas.
.TP
.I positive_sign
seguido por una cadena que se emplee para indicar un signo positivo en
cantidades monetarias.
.TP
.I negative_sign
seguido por una cadena que se emplee para indicar un signo negativo en
cantidades monetarias.
.TP
.I int_frac_digits
seguido por el nmero de decimales que deben emplearse cuando se
fromatee con el 
.B int_curr_symbol.
.TP
.I frac_digits
seguido por el nmero de decimales que deben emplearse cuando se
formatee con el
.B currency_symbol.
.TP
.I p_cs_precedes
seguido por un entero puesto a
.B 1 
si el
.I currency_symbol
o el
.I int_curr_symbol
deben preceder a la cantidad monetaria formateada, o puesto a
.B 0
si el smbolo debe estar tras el valor.
.TP
.I p_sep_by_space
seguido por un entero
.RS
.TP
.B 0
significa que no debe mostrarse ningn espacio entre el smbolo y el valor.
.TP
.B 1
significa que debe mostrarse un espacio entre el smbolo y el valor.
.TP
.B 2 
significa que debe mostrarse un espacio entre el smbolo y la cadena
del signo, si es adyacente.
.RE
.TP
.I n_cs_precedes
.RS
.TP
.B 0 
- el smbolo va tras el valor
.TP
.B 1
- el smbolo va antes del valor
.RE
.TP
.I n_sep_by_space
Un entero que vale
.B 0
si no se separa con ningn espacio 
.I currency_symbol
o 
.I int_curr_symbol
del valor para una cantidad monetaria negativa; que vale
.B 1
si un espacio separa el smbolo del valor, y que vale
.B 2
si un espacio separa el smbolo de la cadena de signo, si fueran adyacentes.
.TP
.I p_sign_posn
.RS
.TP
.B 0
La cantidad y
.I currency_symbol
o
.I int_curr_symbol
van entre parntesis.
.TP
.B 1
La cadena del signo va antes de la cantidad y de
.I currency_symbol
o de
.I int_curr_symbol.
.TP
.B 2
La cadena del signo va tras la cantidad y tras
.I currency_symbol
o tras
.I int_curr_symbol.
.TP
.B 3
La cadena del signo va antes de
.I currency_symbol
o de
.I int_curr_symbol.
.TP
.B 4
La cadena de signo va tras
.I currency_symbol
o tras
.I int_curr_symbol.
.RE
.TP
.I n_sign_posn
.RS
.TP
.B 0
La cantidad y
.I currency_symbol
o
.I int_curr_symbol
van entre parntesis.
.TP
.B 1
La cadena de signo va antes de la cantidad y de
.I currency_symbol
o de
.I int_curr_symbol.
.TP
.B 2
La cadena de signo va tras la cantidad y tras
.I currency_symbol
o tras
.I int_curr_symbol.
.TP
.B 3
La cadena de signo va antes de
.I currency_symbol
o de
.I int_curr_symbol.
.TP
.B 4
La cadena de signo va tras
.I currency_symbol
o tras
.I int_curr_symbol.
.RE
.PP
La definicin
.B LC_MONETARY
acaba con la cadena
.I END LC_MONETARY.

.SS LC_NUMERIC
La definicin empieza con la cadena
.B LC_NUMERIC
en la 1 columna.

Se permiten las siguientes palabras reservadas:

.TP
.I decimal_point
seguido por la cadena que se emplear como el delimitador de decimales
cuando se formateen cantidades numricas.
.TP
.I thousands_sep
seguido por la cadena que se emplear como separador de grupo cuando
se formateen cantidades numricas.
.TP
.I grouping
seguido por una cadena que describa el formateo de cantidades numricas.
.PP
La definicin
.B LC_NUMERIC
acaba con la cadena
.I END LC_NUMERIC.

.SS LC_TIME
La definicin empieza con la cadena
.B LC_TIME
en la 1 columna.

Se permiten las siguientes palabras reservadas:

.TP
.I abday
seguido por una lista de nombres de das de la semana abreviados. La
lista comienza con \fISunday\fP (domingo) o su traduccin.
.TP
.I day
seguido por una lista de nombres de das de la semana; esta lista
comienza en el domingo, como antes.
.TP
.I abmon
seguido por una lista de nombres abreviados de meses.
.TP
.I mon
seguido por una lista de nombres de meses.
.TP
.I am_pm
La representacin apropiada de las cadenas
.B A.M.
y
.B P.M.
.TP
.I d_t_fmt
El formato apropiado de fecha y hora.
.TP
.I d_fmt
El formato apropiado de fecha.
.TP
.I t_fmt
El formato apropiado de hora.
.TP
.I t_fmt_ampm
El formato apropiado de hora empleando el formato de 12 h.
.PP
La definicin
.B LC_TIME
acaba con la cadena
.I END LC_TIME.

.SS LC_MESSAGES
La definicin empieza con la cadena
.B LC_MESSAGES
en la 1 columna.

Se permiten las siguientes palabras reservadas:

.TP
.I yesexpr
seguido por una expresin regular que describa posibles respuestas afirmativas.
.TP
.I noexpr
seguido por una expresin regular que describa posibles respuestas negativas.

.PP
La definicin
.B LC_MESSAGES
acaba con la cadena
.I END LC_MESSAGES.

Consulte el estndar POSIX.2 para ms detalles.
.SH FICHEROS
/usr/lib/locale/ \- base de datos para la configuracin de localizacin actual de una categora
/usr/lib/nls/charmap/* \- archivos mapcar (mapas de caracteres)
.SH FALLOS
La pgina de Manual no est completa.
.\" Pues menos mal! :-p   (N. del T. :-)
.SH AUTOR
Jochen Hein (Hein@Student.TU-Clausthal.de)
.SH CONFORME A
POSIX.2
.SH "VASE TAMBIN"
.BR setlocale (3),
.BR localeconv (3),
.BR charmap (5),
.BR locale (1),
.BR localedef (1)