icuSources/tools/gencnval/gencnval.1.in

   1 .\" Hey, Emacs! This is -*-nroff-*- you know...
   2 .\"
   3 .\" gencnval.1: manual page for the gencnval utility
   4 .\"
   5 .\" Copyright (C) 2000-2004 IBM, Inc. and others.
   6 .\"
   7 .\" Manual page by Yves Arrouye <yves@realnames.com>.
   8 .\" Manual page by George Rhoten
   9 .\"
  10 .TH GENCNVAL 1 "11 March 2004" "ICU MANPAGE" "ICU @VERSION@ Manual"
  11 .SH NAME
  12 .B gencnval
  13 \- compile the converters aliases file
  14 .SH SYNOPSIS
  15 .B gencnval
  16 [
  17 .BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
  18 ]
  19 [
  20 .BR "\-v\fP, \fB\-\-verbose"
  21 ]
  22 [
  23 .BR "\-c\fP, \fB\-\-copyright"
  24 ]
  25 [
  26 .BI "\-s\fP, \fB\-\-sourcedir" " source"
  27 ]
  28 [
  29 .BI "\-d\fP, \fB\-\-destdir" " destination"
  30 ]
  31 [
  32 .I converterfile
  33 ]
  34 .SH DESCRIPTION
  35 .B gencnval
  36 converts the ICU aliases file
  37 .I converterfile
  38 into the binary file
  39 .BR cnvalias.icu .
  40 This binary file can then be read directly by ICU, or used by
  41 .BR pkgdata (1)
  42 for incorporation into a larger archive or library.
  43 .PP
  44 If
  45 .I converterfile
  46 is not provided, the default ICU
  47 .B convrtrs.txt
  48 file is used.
  49 .SH OPTIONS
  50 .TP
  51 .BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
  52 Print help about usage and exit.
  53 .TP
  54 .BR "\-v\fP, \fB\-\-verbose"
  55 Display verbose output. This information can include information about
  56 conflicting aliases and the converters the aliases resolve to.
  57 .TP
  58 .BR "\-c\fP, \fB\-\-copyright"
  59 Include a copyright notice in the binary data.
  60 .TP
  61 .BI "\-s\fP, \fB\-\-sourcedir" " source"
  62 Set the source directory to
  63 .IR source .
  64 The default source directory is specified by the environment variable
  65 .BR ICU_DATA .
  66 .TP
  67 .BI "\-d\fP, \fB\-\-destdir" " destination"
  68 Set the destination directory to
  69 .IR destination .
  70 The default destination directory is specified by the environment variable
  71 .BR ICU_DATA .
  72 .SH ENVIRONMENT
  73 .TP 10
  74 .B ICU_DATA
  75 Specifies the directory containing ICU data. Defaults to
  76 .BR @thepkgicudatadir@/@PACKAGE@/@VERSION@/ .
  77 Some tools in ICU depend on the presence of the trailing slash. It is thus
  78 important to make sure that it is present if
  79 .B ICU_DATA
  80 is set.
  81 .SH FILES
  82 .TP \w'\fB@PACKAGE@/source/data/mappings/convrtrs.txt'u+3n
  83 .B @PACKAGE@/source/data/mappings/convrtrs.txt
  84 Description of ICU's converters and their aliases. This data file is not
  85 normally installed, and it is available as a part of ICU source code.
  86 .SH VERSION
  87 @VERSION@
  88 .SH COPYRIGHT
  89 Copyright (C) 2000-2004 IBM, Inc. and others.
  90 .SH SEE ALSO
  91 .BR pkgdata (1)