usr.sbin/chrtbl/chrtbl.8

   1 .\"     $NetBSD: chrtbl.8,v 1.7 2003/03/15 22:30:37 wiz Exp $
   2 .\"
   3 .\" Copyright (c) 1997 Christos Zoulas
   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 ``AS IS'' AND ANY EXPRESS OR
  16 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  17 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  18 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  19 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  20 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  21 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  22 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  23 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  24 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  25 .\"
  26 .Dd May 12, 1997
  27 .Dt CHRTBL 8
  28 .Os
  29 .Sh NAME
  30 .Nm chrtbl
  31 .Nd create character classification and upper \*[Lt]-\*[Gt] lower conversion tables
  32 .Sh SYNOPSIS
  33 .Nm
  34 .Op Fl o Ar ofile
  35 .Ar ifile
  36 .Sh DESCRIPTION
  37 .Nm
  38 creates character classification and upper \*[Lt]-\*[Gt] lower conversion tables for
  39 single byte files. The
  40 .Nm
  41 command is modelled after the Solaris/SVR4 command. The input file is similar
  42 and contains a keyword per line followed by characters or ranges. Valid
  43 keywords are:
  44 .Bl -tag -width indent
  45 .It Nm LC_CTYPE Ar filename
  46 Set the filename for the character classification output.
  47 .It Nm LC_NUMERIC Ar filename
  48 Set the filename for the numeric formatting output.
  49 .It Nm isupper Ar begin-char Op - Ar end-char
  50 Set the attribute of the specified characters range(s) to be upper case.
  51 .It Nm islower Ar begin-char Op - Ar end-char
  52 Set the attribute of the specified characters range(s) to be lower case.
  53 .It Nm isdigit Ar begin-char Op - Ar end-char
  54 Set the attribute of the specified characters range(s) to be numeric.
  55 .It Nm isspace Ar begin-char Op - Ar end-char
  56 Set the attribute of the specified characters range(s) to be space.
  57 .It Nm ispunct Ar begin-char Op - Ar end-char
  58 Set the attribute of the specified characters range(s) to be punctuation.
  59 .It Nm iscntrl Ar begin-char Op - Ar end-char
  60 Set the attribute of the specified characters range(s) to be control.
  61 .It Nm isxdigit Ar begin-char Op - Ar end-char
  62 Set the attribute of the specified characters range(s) to be hexadecimal digits.
  63 .It Nm isblank Ar begin-char Op - Ar end-char
  64 Set the attribute of the specified characters range(s) to be blank.
  65 .It Nm ul Ar \*[Lt]upper-char lower-char\*[Gt] ...
  66 Specify a case correspondence between upper and lower char.
  67 .It Nm cswidth Ar n1,s1:n2,s2:n3,s3
  68 Specify the character set byte width (n1,n2,n3) and the screen width(s1,s2,s3)
  69 for the 3 character sets.
  70 .It Nm decimal_point Ar char
  71 Specify the decimal point numeric formatting character.
  72 .It Nm thousands_sep Ar char
  73 Specify the thousands separator numeric formatting character.
  74 .El
  75 .Ss Available options
  76 .Bl -tag -width indent
  77 .It Fl o Ar ofile
  78 Print the conversion tables in a human readable (C source) form.
  79 .El
  80 .Sh SEE ALSO
  81 .Xr setlocale 3
  82 .Sh BUGS
  83 Preliminary support of LC_NUMERIC is present, but not currently fully
  84 implemented. No support for wide character locales. Support for alternate
  85 localized character sets and numeric formatting is currently not implemented.