blob: eb0278713c346c376c46923a31b4518bd53ef5d6 [file] [log] [blame]
.\" Hey, Emacs! This is -*-nroff-*- you know...
.\"
.\" gencnval.8: manual page for the gencnval utility
.\"
.\" Copyright (C) 2000 IBM, Inc. and others.
.\"
.\" Manual page by Yves Arrouye <yves@realnames.com>.
.\"
.TH GENCNVAL 8 "12 October 2000" "ICU MANPAGE" "ICU @VERSION@ Manual"
.SH NAME
.B gencnval
\- compile the converters aliases file
.SH SYNOPSIS
.B gencnval
[
.BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
]
[
.BR "\-c\fP, \fB\-\-copyright"
]
[
.BI "\-s\fP, \fB\-\-sourcedir" " source"
]
[
.BI "\-d\fP, \fB\-\-destdir" " destination"
]
[
.I converterfile
]
.SH DESCRIPTION
.B gencnval
converts the ICU aliases file
.I converterfile
into the binary file
.BR cnvalias.dat .
This binary file can then be read directly by ICU, or used by
.BR pkgdata (8)
for incorporation into a larger archive or library.
.PP
If
.I converterfile
is not provided, the default ICU
.B convrtrs.txt
file is used.
.SH OPTIONS
.TP
.BR \-h\fP, \fB\-?\fP, \fB\-\-help
Print help about usage and exit.
.TP
.BR \-c\fP, \fB\-\-copyright
Include a copyright notice in the binary data.
.TP
.BI "\-s\fP, \fB\-\-sourcedir" " source"
Set the source directory to
.IR source .
The default source directory is specified by the environment variable
.BR ICU_DATA .
.TP
.BI "\-d\fP, \fB\-\-destdir" " destination"
Set the destination directory to
.IR destination .
The default destination directory is specified by the environment variable
.BR ICU_DATA .
.SH ENVIRONMENT
.TP 10
.B ICU_DATA
Specifies the directory containing ICU data. Defaults to
.BR @thedatadir@/icu/@VERSION@/ .
Some tools in ICU depend on the presence of the trailing slash. It is thus
important to make sure that it is present if
.B ICU_DATA
is set.
.SH FILES
.TP \w'\fB@thedatadir@/icu/@VERSION@/convrtrs.txt'u+3n
.B @thedatadir@/icu/@VERSION@/convrtrs.txt
Description of ICU's converters and their aliases.
.SH VERSION
@VERSION@
.SH COPYRIGHT
Copyright (C) 2000 IBM, Inc. and others.
.SH SEE ALSO
.BR convrtrs.txt (5)
.br
.BR pkgdata (8)