added manpage (#928684)

ttmkfdir.1

@@ -0,0 +1,68 @@
+.TH TTMKFDIR 1 "March 28, 2013"
+.SH NAME
+\fBttmkfdir\fR\ - Utility to create fonts.scale files for truetype fonts 
+.SH SYNOPSIS
+.B ttmkfdir
+.RB [OPTION]
+.SH DESCRIPTION
+.PP
+    Originally written by Joerg Pommnitz, ttmkfdir is a tool to create valid and complete fonts.scale file from TrueType fonts. It is very useful when you plan to use a TrueType enabled font server that is based on the X11R6 sample implementation (xfsft for instance). Great care has been taken to correctly identify the encodings that a given TrueType font supports.
+
+The ttmkfdir comes with Red Hat Linux has experienced quite some modifications or improvements, include:
+
+\fR\- migration to FreeType 2 library
+.TP
+\fR\- more accurate checking for big font files
+.TP
+\fR\- support for both two X core font backends, Freetype and XTT
+.TP
+\fR\- Truetype collection(ttc) font file support
+.TP
+\fR\- additional CJK friendly features
+.TP
+\fR\- bug fixes
+
+ 
+.SH OPTIONS
+Here is the detailed usage of Red Hat version of ttmkfdir.
+.TP
+.B -h, --help 
+It shows the menus and combo box in iok UI
+.TP
+.B -e, --encoding <encodings.dir>
+ttmkfdir is doing its job by checking each TrueType font file against fontenc layer, please refer www.xfree86.org/current/fonts.html for details. Default encodings.dir file is /usr/X11R6/lib/X11/fonts/encodings/encodings.dir
+.TP
+.B -o, --output
+Specify output, default is fonts.scale in the current directory
+.TP
+.B -d, --font-dir
+Specify TrueType font directory, default is the current directory
+.TP
+.B -f, --default-foundry
+Specify name of the default font foundry, default is "misc"
+.TP
+.B -m, --max-missing
+Specify the maximum number of missing characters per encoding, default is 5. This option applies to the encoding that has less than 256 codepoint definitions.
+.TP
+.B -a,  --max-missing-percentage
+Specify the maximum percentage of missing characters per encoding, default is 2. This option applies to the encoding that has more than 256 codepoint definitions.
+.TP
+.B -b, --font-backend
+For X FreeType backend, use value "1", for XTT backend use value "2", default value is 1. When you have TrueType Collection font(.ttc), you need to use this option.
+.TP
+.B -x, --additional-entries
+Additional entries mean those extra TTCaps stuff for XTT backend, mainly for bold and italic font support. Or for FreeType backend, because FreeType still doesn't support bold and italic font, ttmkfdir can generate extra "dummy" XLFDs, so applications who asking those fonts won't complain.
+
+Default value is "0" means off,otherwise use "1" to switch it on.
+.TP
+.B -c, --completeness
+use less strict completeness tests for encoding tables
+.TP
+.B -p, --panose
+use panose information
+
+.SH AUTHOR
+Yu Shao <yshao@redhat.com> and Pravin Satpute <psatpute@redhat.com>
+.PP
+.SH LICENSE
+GNU Library General Public License

ttmkfdir.spec

@@ -1,7 +1,7 @@
 Summary: Utility to create fonts.scale files for truetype fonts
 Name: ttmkfdir
 Version: 3.0.9
-Release: 38%{?dist}
+Release: 39%{?dist}
 # This is a Red Hat maintained package which is specific to
 # our distribution.  Thus the source is only available from
 # within this srpm.
@@ -16,6 +16,7 @@ Patch6: ttmkfdir-3.0.9-segfaults.patch
 Patch7: ttmkfdir-3.0.9-encoding-dir.patch
 Patch8: ttmkfdir-3.0.9-font-scale.patch
 Patch9: ttmkfdir-3.0.9-bug434301.patch
+Source10: ttmkfdir.1
 # Only licensing attribution is in README, no version.
 License: LGPLv2+
 Group: Applications/System
@@ -50,12 +51,18 @@ make %{?_smp_mflags} OPTFLAGS="$RPM_OPT_FLAGS"
 
 %install
 make DESTDIR=$RPM_BUILD_ROOT install INSTALL="install -p"
+mkdir -p %{buildroot}%{_mandir}/man1/
+cp -p %{SOURCE10} %{buildroot}%{_mandir}/man1/
 
 %files
 %doc README
 %{_bindir}/ttmkfdir
+%{_mandir}/man1/ttmkfdir.1.gz
 
 %changelog
+* Thu Mar 28 2013 Pravin Satpute <psatpute@redhat.com> - 3.0.9-39
+- added manpage (#928684)
+
 * Fri Feb 15 2013 Fedora Release Engineering <rel-eng@lists.fedoraproject.org> - 3.0.9-38
 - Rebuilt for https://fedoraproject.org/wiki/Fedora_19_Mass_Rebuild