michael@0: .\" Hey, Emacs! This is -*-nroff-*- you know...
michael@0: .\"
michael@0: .\" genccode.8: manual page for the gennames utility
michael@0: .\"
michael@0: .\" Copyright (C) 2003-2004 IBM, Inc. and others.
michael@0: .\"
michael@0: .TH GENCCODE 8 "11 March 2004" "ICU MANPAGE" "ICU @VERSION@ Manual"
michael@0: .SH NAME
michael@0: .B genccode
michael@0: \- generate C or platform specific assembly code from an ICU data file.
michael@0: .SH SYNOPSIS
michael@0: .B genccode
michael@0: [
michael@0: .BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
michael@0: ]
michael@0: [
michael@0: .BI "\-a\fP, \fB\-\-assembly" " name"
michael@0: ]
michael@0: [
michael@0: .BI "\-d\fP, \fB\-\-destdir" " destination"
michael@0: ]
michael@0: [
michael@0: .BI "\-n\fP, \fB\-\-name" " name"
michael@0: ]
michael@0: [
michael@0: .BI "\-e\fP, \fB\-\-entrypoint" " name"
michael@0: ]
michael@0: [
michael@0: .BI "\-f\fP, \fB\-\-filename" " name"
michael@0: ]
michael@0: [
michael@0: .IR filename " .\|.\|."
michael@0: ]
michael@0: .SH DESCRIPTION
michael@0: .B genccode
michael@0: reads each of the supplied
michael@0: .I filename
michael@0: and writes out a C file containing a compilable definition of the data in
michael@0: the data file.
michael@0: The C file name is made by taking the base name of the data
michael@0: .IR filename ,
michael@0: replacing dots by underscores, and adding a
michael@0: .I .c
michael@0: file extension.
michael@0: .PP
michael@0: If the \fB-a\fP option is used, platform specific assembly
michael@0: code is generated instead of C code.
michael@0: Most C compilers will accept both C and assembly files.
michael@0: Instead of writing a filename with a
michael@0: .I .c
michael@0: file extension, a filename with a
michael@0: .I .s
michael@0: will be written instead.
michael@0: .PP
michael@0: If
michael@0: .B genccode
michael@0: is called with no
michael@0: .I filename
michael@0: it terminates gracefully.
michael@0: .SH OPTIONS
michael@0: .TP
michael@0: .BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
michael@0: Print help about usage and exit.
michael@0: .TP
michael@0: .BI "\-a\fP, \fB\-\-assembly" " name"
michael@0: Output assembly code instead of C code.
michael@0: Use \fB-h\fP to see the list of available types of assembly to generate and
michael@0: to specify for this option.
michael@0: .TP
michael@0: .BI "\-d\fP, \fB\-\-destdir" " destination"
michael@0: Set the destination directory to
michael@0: .IR destination .
michael@0: The default destination directory is the current directory.
michael@0: .TP
michael@0: .BI "\-n\fP, \fB\-\-name" " name"
michael@0: Set the data name to
michael@0: .I name
michael@0: instead of the default. This name is also used as the base name of the
michael@0: output. The default name is made of the
michael@0: .I icudt
michael@0: prefix, followed by a two-digit version number corresponding to
michael@0: the current version of the ICU release, and a single letter indicating
michael@0: the endianness of the data (the letter
michael@0: .I b
michael@0: indicated big endian data, and the letter
michael@0: .I l
michael@0: indicates little endian ones).
michael@0: .TP
michael@0: .BI "\-f\fP, \fB\-\-filename" " name"
michael@0: Normally, an ICU data file such as mydata.icu will be turned into mydata_icu.c and mydata_icu.o.
michael@0: However, if this parameter was set to "somedata", the output files will be somedata.o and 
michael@0: somedata.c, respectively.
michael@0: .TP
michael@0: .BI "\-e\fP, \fB\-\-entrypoint" " name"
michael@0: Set the data entry point (used for linking against the data in a
michael@0: shared library form) to
michael@0: .IR name .
michael@0: The default entry point name is made of the data (set by the
michael@0: .BI "\-n\fP, \fB\-\-name"
michael@0: option) followed by an underscore and the type of the data (set by the
michael@0: .BI "\-t\fP, \fB\-\-type"
michael@0: option).
michael@0: .SH VERSION
michael@0: @VERSION@
michael@0: .SH COPYRIGHT
michael@0: Copyright (C) 2000-2004 IBM, Inc. and others.