michael@0: .\" Hey, Emacs! This is -*-nroff-*- you know... michael@0: .\" michael@0: .\" gencfu.1: manual page for the gencfu utility michael@0: .\" michael@0: .\" Copyright (C) 2012 International Business Machines Corporation and others michael@0: .\" michael@0: .TH GENCFU 1 "24 May 2009" "ICU MANPAGE" "ICU @VERSION@ Manual" michael@0: .SH NAME michael@0: .B gencfu michael@0: \- Generates Unicode Confusable data files michael@0: .SH SYNOPSIS michael@0: .B gencfu michael@0: [ michael@0: .BR "\-h\fP, \fB\-?\fP, \fB\-\-help" michael@0: ] michael@0: [ michael@0: .BR "\-V\fP, \fB\-\-version" michael@0: ] michael@0: [ michael@0: .BR "\-c\fP, \fB\-\-copyright" michael@0: ] michael@0: [ michael@0: .BR "\-v\fP, \fB\-\-verbose" michael@0: ] michael@0: [ michael@0: .BI "\-d\fP, \fB\-\-destdir" " destination" michael@0: ] michael@0: [ michael@0: .BI "\-i\fP, \fB\-\-icudatadir" " directory" michael@0: ] michael@0: .BI "\-r\fP, \fB\-\-rules" " rule\-file" michael@0: .BI "\-w\fP, \fB\-\-wsrules" " whole\-script\-rule\-file" michael@0: .BI "\-o\fP, \fB\-\-out" " output\-file" michael@0: .SH DESCRIPTION michael@0: .B gencfu michael@0: reads confusable character definitions in the input file, which are michael@0: plain text files containing confusable character michael@0: definitions in the input format defined by Unicode UAX39 for the files michael@0: .I confusables.txt michael@0: and michael@0: .I confusablesWholeScript.txt. michael@0: This source (.txt) format is also accepted by ICU spoof detectors. michael@0: The files must be encoded in utf-8 format, with or without a BOM. michael@0: Normally the output data file has the michael@0: .B .cfu michael@0: extension. 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: .BR "\-V\fP, \fB\-\-version" michael@0: Print the version of michael@0: .B gencfu michael@0: and exit. michael@0: .TP michael@0: .BR "\-c\fP, \fB\-\-copyright" michael@0: Embeds the standard ICU copyright into the michael@0: .IR output-file . michael@0: .TP michael@0: .BR "\-v\fP, \fB\-\-verbose" michael@0: Display extra informative messages during execution. michael@0: .TP michael@0: .BI "\-d\fP, \fB\-\-destdir" " destination" michael@0: Set the destination directory of the michael@0: .IR output-file michael@0: to michael@0: .IR destination . michael@0: .TP michael@0: .BI "\-i\fP, \fB\-\-icudatadir" " directory" michael@0: Look for any necessary ICU data files in michael@0: .IR directory . michael@0: For example, the file michael@0: .B pnames.icu michael@0: must be located when ICU's data is not built as a shared library. michael@0: The default ICU data directory is specified by the environment variable michael@0: .BR ICU_DATA . michael@0: Most configurations of ICU do not require this argument. michael@0: .TP michael@0: .BI "\-r\fP, \fB\-\-rules" " rule\-file" michael@0: The source file to read. michael@0: .TP michael@0: .BI "\-w\fP, \fB\-\-wsrules" " whole\-script\-rule\-file" michael@0: The whole script source file to read. michael@0: .TP michael@0: .BI "\-o\fP, \fB\-\-out" " output\-file" michael@0: The output data file to write. michael@0: .SH VERSION michael@0: 1.0 michael@0: .SH COPYRIGHT michael@0: Copyright (C) 2009 International Business Machines Corporation and others