share/man/man5/locale.alias.5

   1 .\" $NetBSD: locale.alias.5,v 1.1 2004/07/21 19:49:21 tshiozak Exp $
   2 .\"
   3 .\" Copyright (c)2004 Citrus Project,
   4 .\" All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\"
  15 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  16 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  17 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  18 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  19 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  20 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  21 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  22 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  23 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  24 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  25 .\" SUCH DAMAGE.
  26 .\"
  27 .Dd July 22, 2004
  28 .Dt LOCALE.ALIAS 5
  29 .Os
  30 .Sh NAME
  31 .Nm locale.alias
  32 .Nd locale alias file
  33 .Sh SYNOPSIS
  34 .Nm locale.alias
  35 .Sh DESCRIPTION
  36 The
  37 .Nm locale.alias
  38 file describes locale aliases.
  39 Each line of this file can be described as the following BNF:
  40 .Bd -literal -offset indent
  41 line                    :=      src ws dst
  42 src                     :=      locale_name
  43                         |       locale_category_name
  44 ws                      :=      \*[Lt]white spaces\*[Gt]
  45 dst                     :=      locale_name
  46                         |       "/FORCE"
  47 locale_category_name    :=      locale_name '/' category_name
  48 category_name           :=      "LC_CTYPE"
  49                         |       "LC_COLLATE"
  50                         |       "LC_TIME"
  51                         |       "LC_NUMERIC"
  52                         |       "LC_MONETARY"
  53                         |       "LC_MESSAGES"
  54 locale_name             :=      \*[Lt]locale name\*[Gt]
  55 .Ed
  56 .Sh FILES
  57 .Bl -tag -width /usr/share/locale/locale.alias -compact
  58 .It Pa /usr/share/locale/locale.alias
  59 This file.
  60 .El
  61 .Sh EXAMPLES
  62 .Bd -literal -offset indent
  63 ja_JP.UTF-8/LC_CTYPE            en_US.UTF-8
  64 .Ed
  65 This means that
  66 .Dq Dv ja_JP.UTF-8
  67 for
  68 .Dv LC_CTYPE
  69 category is redirected to
  70 .Dq Dv en_US.UTF-8 .
  71 .Bd -literal -offset indent
  72 Pig                             /FORCE
  73 .Ed
  74 This means that
  75 .Dq Dv Pig
  76 for all categories is forcibly enabled.
  77 .Sh SEE ALSO
  78 .Xr locale 1 ,
  79 .Xr nls 7
  80 .Sh HISTORY
  81 The
  82 .Nm
  83 file appeared in
  84 .Nx 3.0 .