icuSources/tools/gennorm/gennorm.8.in

   1 .\" Hey, Emacs! This is -*-nroff-*- you know...
   2 .\"
   3 .\" gennorm.8: manual page for the gennorm utility
   4 .\"
   5 .\" Copyright (C) 2000-2001 IBM, Inc. and others.
   6 .\"
   7 .TH GENNORM 8 "16 January 2001" "ICU MANPAGE" "ICU @VERSION@ Manual"
   8 .SH NAME
   9 .B gennorm
  10 \- compile normalization data from the Unicode Character Database
  11 .SH SYNOPSIS
  12 .B gennorm
  13 [
  14 .BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
  15 ]
  16 [
  17 .BR "\-v\fP, \fB\-\-verbose"
  18 ]
  19 [
  20 .BI "\-u\fP, \fB\-\-unicode" " version"
  21 ]
  22 [
  23 .BI "\-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 suffix
  33 ]
  34 .SH DESCRIPTION
  35 .B gennorm
  36 reads some of the Unicode Character Database files and compiles their
  37 normalization information into a binary form.
  38 The resulting file,
  39 .BR unorm.dat ,
  40 can then be read directly by ICU, or used by
  41 .BR pkgdata (8)
  42 for incorporation into a larger archive or library.
  43 .LP
  44 The files read by
  45 .B gennorm
  46 are described in the
  47 .B FILES
  48 section. If
  49 .I suffix
  50 is passed on the command line, the names of these files will actually
  51 be changed to include a dash followed by
  52 .I suffix
  53 in their basename. For example, the file
  54 .B UnicodeData.txt
  55 would be looked for under the name
  56 .BR UnicodeData\-\fIsuffix\fP.txt .
  57 .SH OPTIONS
  58 .TP
  59 .BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
  60 Print help about usage and exit.
  61 .TP
  62 .BR "\-v\fP, \fB\-\-verbose"
  63 Display extra informative messages during execution.
  64 .TP
  65 .BI "\-u\fP, \fB\-\-unicode" " version"
  66 Specify which
  67 .I  version
  68 of Unicode the Unicode Character Database refers to.
  69 Defaults to
  70 .BR  3.0.0 .
  71 .TP
  72 .BI "\-c\fP, \fB\-\-copyright"
  73 Include a copyright notice into the binary data.
  74 .TP
  75 .BI "\-s\fP, \fB\-\-sourcedir" " source"
  76 Set the source directory to
  77 .IR source .
  78 The default source directory is specified by the environment variable
  79 .BR ICU_DATA .
  80 .TP
  81 .BI "\-d\fP, \fB\-\-destdir" " destination"
  82 Set the destination directory to
  83 .IR destination .
  84 The default destination directory is specified by the environment variable
  85 .BR ICU_DATA .
  86 .SH ENVIRONMENT
  87 .TP 10
  88 .B ICU_DATA
  89 Specifies the directory containing ICU data. Defaults to
  90 .BR @thepkgicudatadir@/@PACKAGE@/@VERSION@/ .
  91 Some tools in ICU depend on the presence of the trailing slash. It is thus
  92 important to make sure that it is present if
  93 .B ICU_DATA
  94 is set.
  95 .SH FILES
  96 The following files are read by
  97 .B gennorm
  98 and are looked for in the
  99 .I source
 100 directory.
 101 .TP 20
 102 .B UnicodeData.txt
 103 The main file in the Unicode Character Database. Contains character
 104 properties, combining classes information, decompositions, names,
 105 etc.\|.\|..
 106 .TP
 107 .B DerivedNormalizationProperties.txt
 108 Derived properties useful in dealing with normalization forms.
 109 .SH VERSION
 110 @VERSION@
 111 .SH COPYRIGHT
 112 Copyright (C) 2000-2002 IBM, Inc. and others.
 113 .SH SEE ALSO
 114 .BR pkgdata (8)