ICU-807 added manual page for gennorm(8).

changed genprops(8) manual page so that the two look very close.
ensured that manual pages are cleaned during make clean.

X-SVN-Rev: 7447

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:

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)

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,

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

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