From 8b4e7628e1d8baca4f55fcdd76101b8b3e015044 Mon Sep 17 00:00:00 2001 From: Patrick Lam Date: Thu, 6 Apr 2006 05:15:08 +0000 Subject: [PATCH] Update documentation for fc-match (SGML-ize it). (reported by Ilya Konstantinov) --- ChangeLog | 8 ++ fc-match/.cvsignore | 1 + fc-match/Makefile.am | 27 ++++++- fc-match/fc-match.1 | 37 --------- fc-match/fc-match.sgml | 169 +++++++++++++++++++++++++++++++++++++++++ 5 files changed, 203 insertions(+), 39 deletions(-) delete mode 100644 fc-match/fc-match.1 create mode 100644 fc-match/fc-match.sgml diff --git a/ChangeLog b/ChangeLog index ff6b2d9..7f67250 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +2006-04-06 Patrick Lam + * fc-match/.cvsignore: + * fc-match/Makefile.am: + * fc-match/fc-match.sgml: + + Update documentation for fc-match (SGML-ize it). + (reported by Ilya Konstantinov) + 2006-04-06 Diego Pettenò reviewed by: plam * src/fcdefault.c: diff --git a/fc-match/.cvsignore b/fc-match/.cvsignore index 3c5091d..5c153e9 100644 --- a/fc-match/.cvsignore +++ b/fc-match/.cvsignore @@ -3,3 +3,4 @@ Makefile Makefile.in fc-match +fc-match.1 diff --git a/fc-match/Makefile.am b/fc-match/Makefile.am index 71dc164..00d3330 100644 --- a/fc-match/Makefile.am +++ b/fc-match/Makefile.am @@ -23,10 +23,33 @@ bin_PROGRAMS=fc-match -man_MANS=fc-match.1 +DOC2MAN = docbook2man + +FC_MATCH_SRC=${top_srcdir}/fc-match + +SGML = ${FC_MATCH_SRC}/fc-match.sgml INCLUDES=-I${top_srcdir} $(FREETYPE_CFLAGS) $(WARN_CFLAGS) -EXTRA_DIST=$(man_MANS) +EXTRA_DIST=fc-match.sgml fc_match_LDADD = ${top_builddir}/src/libfontconfig.la + +if USEDOCBOOK + +man_MANS=fc-match.1 + +${man_MANS}: ${SGML} + $(RM) $@ + $(DOC2MAN) ${SGML} + $(RM) manpage.refs manpage.links + +all-local: $(man_MANS) + +clean-local: + $(RM) $(man_MANS) + +else +all-local: +clean-local: +endif diff --git a/fc-match/fc-match.1 b/fc-match/fc-match.1 deleted file mode 100644 index fd4d394..0000000 --- a/fc-match/fc-match.1 +++ /dev/null @@ -1,37 +0,0 @@ -.\" -.\" Copyright © 2003 Keith Packard -.\" -.\" Permission to use, copy, modify, distribute, and sell this software and its -.\" documentation for any purpose is hereby granted without fee, provided that -.\" the above copyright notice appear in all copies and that both that -.\" copyright notice and this permission notice appear in supporting -.\" documentation, and that the name of Keith Packard not be used in -.\" advertising or publicity pertaining to distribution of the software without -.\" specific, written prior permission. Keith Packard makes no -.\" representations about the suitability of this software for any purpose. It -.\" is provided "as is" without express or implied warranty. -.\" -.\" KEITH PACKARD DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, -.\" INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO -.\" EVENT SHALL KEITH PACKARD BE LIABLE FOR ANY SPECIAL, INDIRECT OR -.\" CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, -.\" DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER -.\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR -.\" PERFORMANCE OF THIS SOFTWARE. -.\" -.\" -.\" $RCSId: xc/programs/fc-match/fc-match.man,v 1.3 2001/02/09 03:47:56 tsi Exp $ -.\" -.TH FC-MATCH 1 __vendorversion__ -.SH NAME -fc-match \- match available fonts -.SH SYNOPSIS -.B "fc-match" -.RI [-svV?] [--sort] [--verbose] [--version] [ font-pattern ] -.SH DESCRIPTION -.I fc-match -matches font-pattern (empty pattern by default) using the normal fontconfig -matching rules to find the best font available. If --sort is given, the -sorted list of best matching fonts is displayed. With --verbose, the whole -font pattern for each match is printed, otherwise only the file, family and -style are printed. diff --git a/fc-match/fc-match.sgml b/fc-match/fc-match.sgml new file mode 100644 index 0000000..d68cc22 --- /dev/null +++ b/fc-match/fc-match.sgml @@ -0,0 +1,169 @@ + manpage.1'. You may view + the manual page with: `docbook-to-man manpage.sgml | nroff -man | + less'. A typical entry in a Makefile or Makefile.am is: + +manpage.1: manpage.sgml + docbook-to-man $< > $@ + + + The docbook-to-man binary is found in the docbook-to-man package. + Please remember that if you create the nroff version in one of the + debian/rules file targets (such as build), you will need to include + docbook-to-man in your Build-Depends control field. + + --> + + + Patrick"> + Lam"> + + Apr 6, 2006"> + + 1"> + plam@csail.mit.edu"> + + fc-match"> + + + Debian"> + GNU"> + GPL"> +]> + + + +
+ &dhemail; +
+ + &dhfirstname; + &dhsurname; + + + 2003 + &dhusername; + + &dhdate; + + + &dhucpackage; + + &dhsection; + + + &dhpackage; + + match available fonts + + + + &dhpackage; + + + + + + + + + + + + DESCRIPTION + + &dhpackage; matches font-pattern (empty +pattern by default) using the normal fontconfig matching rules to find +the best font available. If --sort is given, the sorted list of best +matching fonts is displayed. With --verbose, the whole font pattern +for each match is printed, otherwise only the file, family and style +are printed.. + + + + OPTIONS + + This program follows the usual &gnu; command line syntax, + with long options starting with two dashes (`-'). A summary of + options is included below. + + + + + + + + Print whole font pattern for each match. + + + + + + + + Show summary of options. + + + + + + + + Show version of the program and exit. + + + + + + + + Displays sorted list of best matching fonts. + + + + + + + Displays fonts matching + font-pattern (uses empty pattern by default). + + + + + + + SEE ALSO + + fc-list (1). + + The fontconfig user's guide, in HTML format: + /usr/share/doc/fontconfig/fontconfig-user.html. + + + + AUTHOR + + This manual page was updated by &dhusername; &dhemail;. + + + + + -- 2.39.5