diff --git a/icu4c/source/tools/gennorm/Makefile.in b/icu4c/source/tools/gennorm/Makefile.in index d0d69bcb54..b9a356a580 100644 --- a/icu4c/source/tools/gennorm/Makefile.in +++ b/icu4c/source/tools/gennorm/Makefile.in @@ -16,6 +16,10 @@ include @platform_make_fragment@ ## +SECTION = 8 + +MAN_FILES = $(TARGET).$(SECTION) + ## Build directory information subdir = tools/gennorm @@ -23,7 +27,7 @@ ICUDATADIR=$(top_builddir)/data UNICODEDATADIR=$(top_srcdir)/../data/unidata ## Extra files to remove for 'make clean' -CLEANFILES = *~ $(DEPS) $(RES_FILES) $(TEST_FILES) +CLEANFILES = *~ $(DEPS) $(RES_FILES) $(TEST_FILES) $(MANUAL_FILES) ## Target information TARGET = gennorm @@ -46,7 +50,7 @@ DEPS = $(OBJECTS:.o=.d) ## List of phony targets .PHONY : all all-local install install-local clean clean-local \ distclean distclean-local dist dist-local check \ -check-local build-data +check-local build-data install-man ## Clear suffix list .SUFFIXES : @@ -59,12 +63,28 @@ distclean : distclean-local dist: dist-local check: all check-local -all-local: $(TARGET) build-data +all-local: $(TARGET) build-data $(MAN_FILES) -install-local: all-local +install-local: all-local install-man $(MKINSTALLDIRS) $(DESTDIR)$(sbindir) $(INSTALL) $(TARGET) $(DESTDIR)$(sbindir)/$(TARGET) +# man page +install-man: $(MAN_FILES) + $(MKINSTALLDIRS) $(DESTDIR)$(mandir)/man$(SECTION) + $(INSTALL_DATA) $< $(DESTDIR)$(mandir)/man$(SECTION) + +$(TARGET).$(SECTION): $(srcdir)/$(TARGET).$(SECTION).in + cd $(top_builddir) \ + && CONFIG_FILES=$(subdir)/$@ CONFIG_HEADERS= $(SHELL) ./config.status + +# build postscript and pdf formats +$(TARGET).ps: $(TARGET).$(SECTION) + groff -man < $< > $@ + +$(TARGET).pdf: $(TARGET).ps + ps2pdf $< $@ + dist-local: clean-local: diff --git a/icu4c/source/tools/gennorm/gennorm.8.in b/icu4c/source/tools/gennorm/gennorm.8.in new file mode 100644 index 0000000000..4c66357ffa --- /dev/null +++ b/icu4c/source/tools/gennorm/gennorm.8.in @@ -0,0 +1,115 @@ +.\" Hey, Emacs! This is -*-nroff-*- you know... +.\" +.\" gennorm.8: manual page for the gennorm utility +.\" +.\" Copyright (C) 2000-2001 IBM, Inc. and others. +.\" +.TH GENNORM 8 "16 January 2001" "ICU MANPAGE" "ICU @VERSION@ Manual" +.SH NAME +.B gennorm +\- compile normalization data from the Unicode Character Database +.SH SYNOPSIS +.B gennorm +[ +.BR "\-V\fP, \fB\-\-version" +] +[ +.BR "\-h\fP, \fB\-?\fP, \fB\-\-help" +] +[ +.BR "\-v\fP, \fB\-\-verbose" +] +[ +.BI "\-u\fP, \fB\-\-unicode" " version" +] +[ +.BI "\-c\fP, \fB\-\-copyright" +] +[ +.BI "\-s\fP, \fB\-\-sourcedir" " source" +] +[ +.BI "\-d\fP, \fB\-\-destdir" " destination" +] +[ +.I suffix +] +.SH DESCRIPTION +.B gennorm +reads some of the Unicode Character Database files and compiles their +normalization information into a binary form. +The resulting file, +.BR unorm.dat , +can then be read directly by ICU, or used by +.BR pkgdata (8) +for incorporation into a larger archive or library. +.LP +The files read by +.B gennorm +are described in the +.B FILES +section. If +.I suffix +is passed on the command line, the names of these files will actually +be changed to include a dash followed by +.I suffix +in their basename. For example, the file +.B UnicodeData.txt +would be looked for under the name +.BR UnicodeData\-\fIsuffix\fP.txt . +.SH OPTIONS +.TP +.BR \-V\fP, \fB\-\-version +Print the version of +.B genuca +and exit. +.TP +.BR \-h\fP, \fB\-?\fP, \fB\-\-help +Print help about usage and exit. +.TP +.BR \-v\fP, \fB\-\-verbose +Display extra informative messages during execution. +.TP +.BI "\-c\fP, \fB\-\-copyright" +Include a copyright notice into 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 +The following files are read by +.B gennorm +and are looked for in the +.I source +directory. +.TP 20 +.B UnicodeData.txt +The main file in the Unicode Character Database. Contains character +properties, combining classes information, decompositions, names, +etc.\|.\|.. +.TP +.B DerivedNormalizationProperties.txt +Derived properties useful in dealing with normalization forms. +.SH VERSION +@VERSION@ +.SH COPYRIGHT +Copyright (C) 2000-2002 IBM, Inc. and others. +.SH SEE ALSO +.BR pkgdata (8) diff --git a/icu4c/source/tools/gennorm/gennorm.c b/icu4c/source/tools/gennorm/gennorm.c index 792d45f184..999764c337 100644 --- a/icu4c/source/tools/gennorm/gennorm.c +++ b/icu4c/source/tools/gennorm/gennorm.c @@ -90,7 +90,7 @@ main(int argc, char* argv[]) { "Usage: %s [-options] [suffix]\n" "\n" "Read the UnicodeData.txt file and other Unicode properties files and\n" - "create a binary file " DATA_NAME "." DATA_TYPE " with the character properties\n" + "create a binary file " DATA_NAME "." DATA_TYPE " with the normalization data\n" "\n", argv[0]); fprintf(stderr, diff --git a/icu4c/source/tools/genprops/Makefile.in b/icu4c/source/tools/genprops/Makefile.in index f2a639a3af..eec885a0d4 100644 --- a/icu4c/source/tools/genprops/Makefile.in +++ b/icu4c/source/tools/genprops/Makefile.in @@ -27,7 +27,7 @@ ICUDATADIR=$(top_builddir)/data UNICODEDATADIR=$(top_srcdir)/../data/unidata ## Extra files to remove for 'make clean' -CLEANFILES = *~ $(DEPS) $(RES_FILES) $(TEST_FILES) +CLEANFILES = *~ $(DEPS) $(RES_FILES) $(TEST_FILES) $(MANUAL_FILES) ## Target information TARGET = genprops diff --git a/icu4c/source/tools/genprops/genprops.8.in b/icu4c/source/tools/genprops/genprops.8.in index 5b2b5c4deb..7c5a9b6ec3 100644 --- a/icu4c/source/tools/genprops/genprops.8.in +++ b/icu4c/source/tools/genprops/genprops.8.in @@ -7,7 +7,7 @@ .TH GENPROPS 8 "16 January 2001" "ICU MANPAGE" "ICU @VERSION@ Manual" .SH NAME .B genprops -\- compile the Unicode Character Database (UCD) +\- compile properties from the Unicode Character Database .SH SYNOPSIS .B genprops [ @@ -36,7 +36,8 @@ ] .SH DESCRIPTION .B genprops -compiles Unicode Character Database files into a binary form. +reads some of the Unicode Character Database files and compiles their +information information into a binary form. The resulting file, .BR icudata.dat , can then be read directly by ICU, or used by