Ship more manpages.

This commit is contained in:
Tim Waugh 2014-08-21 16:04:35 +01:00
parent 91b147ab51
commit f5355f7a50
2 changed files with 339 additions and 1 deletions

322
foomatic-manpages.patch Normal file
View File

@ -0,0 +1,322 @@
diff -up foomatic-db-engine-4.0.11/foomatic-cleanupdrivers.1.in.manpages foomatic-db-engine-4.0.11/foomatic-cleanupdrivers.1.in
--- foomatic-db-engine-4.0.11/foomatic-cleanupdrivers.1.in.manpages 2014-08-21 16:36:05.930418901 +0100
+++ foomatic-db-engine-4.0.11/foomatic-cleanupdrivers.1.in 2014-08-21 16:36:05.930418901 +0100
@@ -0,0 +1,16 @@
+.\" This -*- nroff -*- source file is part of foomatic.
+.\"
+.TH FOOMATIC-CLEANUPDRIVERS 1 "2014-08-21" "Foomatic Project"
+.SH NAME
+foomatic-cleanupdrivers \- Remove driver entries with no command line
+.SH SYNOPSIS
+.HP \w'\fBfoomatic-cleanupdrivers\fR\ 'u
+\fBfoomatic-cleanupdrivers\fR [\fIDBDIR\fR]
+
+.SH DESCRIPTION
+.PP
+The \fBfoomatic\-cleanupdrivers\fR command removes all driver XML
+files which have an empty command line.
+
+.PP
+It is not intended to be called directly by the user.
diff -up foomatic-db-engine-4.0.11/foomatic-datafile.1.manpages foomatic-db-engine-4.0.11/foomatic-datafile.1
--- foomatic-db-engine-4.0.11/foomatic-datafile.1.manpages 2014-08-21 16:36:05.931418908 +0100
+++ foomatic-db-engine-4.0.11/foomatic-datafile.1 2014-08-21 16:36:05.930418901 +0100
@@ -0,0 +1 @@
+.so man1/foomatic-ppdfile.1
diff -up foomatic-db-engine-4.0.11/foomatic-extract-text.1.in.manpages foomatic-db-engine-4.0.11/foomatic-extract-text.1.in
--- foomatic-db-engine-4.0.11/foomatic-extract-text.1.in.manpages 2014-08-21 16:36:05.931418908 +0100
+++ foomatic-db-engine-4.0.11/foomatic-extract-text.1.in 2014-08-21 16:36:05.931418908 +0100
@@ -0,0 +1,16 @@
+.\" This -*- nroff -*- source file is part of foomatic.
+.\"
+.TH FOOMATIC-EXTRACT-TEXT 1 "2014-08-21" "Foomatic Project"
+.SH NAME
+foomatic-extract-text \- Generate .po files from Foomatic UI strings
+.SH SYNOPSIS
+.HP \w'\fBfoomatic-extract-text\fR\ 'u
+\fBfoomatic-extract-text\fR
+
+.SH DESCRIPTION
+.PP
+The \fBfoomatic\-extract\-text\fR command generates .po files from the
+UI strings in the currently installed Foomatic database.
+
+.PP
+It is not intended to be called directly by the user.
diff -up foomatic-db-engine-4.0.11/foomatic-fix-xml.1.in.manpages foomatic-db-engine-4.0.11/foomatic-fix-xml.1.in
--- foomatic-db-engine-4.0.11/foomatic-fix-xml.1.in.manpages 2014-08-21 16:36:05.931418908 +0100
+++ foomatic-db-engine-4.0.11/foomatic-fix-xml.1.in 2014-08-21 16:36:05.931418908 +0100
@@ -0,0 +1,14 @@
+.\" This -*- nroff -*- source file is part of foomatic.
+.\"
+.TH FOOMATIC-FIX-XML 1 "2014-08-21" "Foomatic Project"
+.SH NAME
+foomatic-fix-xml \- Remove leading blank lines from Foomatic database
+.SH SYNOPSIS
+.HP \w'\fBfoomatic-fix-xml\fR\ 'u
+\fBfoomatic-fix-xml\fR [\fIDBDIR\fR]
+
+.SH DESCRIPTION
+.PP
+Use the \fBfoomatic\-fix\-xml\fR command if you have compiled
+foomatic-perl-data against libxml 1.x and you have old database
+entries with a leading blank line.
diff -up foomatic-db-engine-4.0.11/foomatic-nonumericalids.1.in.manpages foomatic-db-engine-4.0.11/foomatic-nonumericalids.1.in
--- foomatic-db-engine-4.0.11/foomatic-nonumericalids.1.in.manpages 2014-08-21 16:36:05.931418908 +0100
+++ foomatic-db-engine-4.0.11/foomatic-nonumericalids.1.in 2014-08-21 16:36:05.931418908 +0100
@@ -0,0 +1,17 @@
+.\" This -*- nroff -*- source file is part of foomatic.
+.\"
+.TH FOOMATIC-NONUMERICALIDS 1 "2014-08-21" "Foomatic Project"
+.SH NAME
+foomatic-nonumericalids \- Convert numerical printer IDS to clear-text IDs
+.SH SYNOPSIS
+.HP \w'\fBfoomatic-nonumericalids\fR\ 'u
+\fBfoomatic-nonumericalids\fR
+
+.SH DESCRIPTION
+.PP
+This script changes all old cryptic numerical printer IDs from the old
+PostGreSQL time to clear-text printer IDs in the installed Foomatic
+database.
+
+.PP
+It is very unlikely you need to do this.
diff -up foomatic-db-engine-4.0.11/foomatic-ppd-to-xml.1.in.manpages foomatic-db-engine-4.0.11/foomatic-ppd-to-xml.1.in
--- foomatic-db-engine-4.0.11/foomatic-ppd-to-xml.1.in.manpages 2014-08-21 16:36:05.931418908 +0100
+++ foomatic-db-engine-4.0.11/foomatic-ppd-to-xml.1.in 2014-08-21 16:36:05.931418908 +0100
@@ -0,0 +1,104 @@
+.\" This -*- nroff -*- source file is part of foomatic.
+.\"
+.TH FOOMATIC-PPD-TO-XML 1 "2014-08-21" "Foomatic Project"
+.SH NAME
+foomatic-ppd-to-xml \- Generate Foomatic printer XML from a PPD
+.SH SYNOPSIS
+.HP \w'\fBfoomatic-ppd-to-xml\fR\ 'u
+\fBfoomatic-ppd-to-xml\fR \fIOPTIONS\FR [\fIDRIVER\fR:]\fIPPD\fR [[\fIDRIVER\fR:]\fIPPD\fR ...]
+.HP \w'\fBfoomatic-ppd-to-xml\fR\ 'u
+\fBfoomatic-ppd-to-xml\fR \-h
+
+.SH DESCRIPTION
+The first form of the
+.B foomatic-ppd-to-xml
+command creates Foomatic printer XML corresponding to a given PPD
+file.
+
+.PP
+If \fIDRIVER\fR is specified, it is the driver to which the PPD file
+should get assigned. If not supplied, the first driver in the driver
+list supplied via the \fB\-d\fR option is used. Note that the PPD files
+have to be supplied to different drivers, so drivers need to be
+specified if using more than one PPD.
+
+.PP
+The second form prints a help message and exits.
+
+.SS Options
+.TP 5
+\fB\-d\fR \fIDRIVERS\fR
+Comma-separated list of drivers with which the printer works. First
+driver is the one for which the PPD file is. If not otherwise stated
+by the \fB\-r\fR option, this is also the recommended driver. Drivers
+already specified together with PPDs do not need to be specified with
+this option again. The option is not needed if drivers are specified
+for all PPDs.
+
+.TP 5
+\fB\-r\fR \fIDRIVER\fR
+Recommended driver.
+
+.TP 5
+\fB\-p\fR \fIPDLS\fR
+Comma-separated list of known Page Description Languages (PDLs) which
+the printer supports. This will add all suitable drivers to the XML
+entry. Currently supported are: Postscript, PCLXL, PCL6, PCL5e, PCL5c,
+PCL5, and PCL4.
+
+.TP 5
+\fB\-l\fR
+Add a link to the PPD file to the driver entry in the XML file.
+
+.TP 5
+\fB\-b\fR \fIDIRECTORY\fR
+Base directory for a relative link to the PPD. If the base directory
+is given, the link set via the \fB\-l\fR option is relative to this
+directory (and not relative to the current directory). With a base
+directory given the \fIPPD\fR can also be given relative to this
+directory.
+
+.TP 5
+\fB\-D\fR
+Add only the driver requested by \fB\-d\fR and \fB\-r\fR to the driver
+list in the XML file, do not add drivers based on PDLs, not even on
+the PDLs supplied by the \fB\-p\fR option.
+
+.TP 5
+\fB\-c\fR \fICOMMENT\fR
+Add the given comment to the comment field of the XML file. Comments
+are in HTML.
+
+.TP 5
+\fB\-C\fR
+Suppress any default comments (max paper width, pages per minute,
+automatically generated XML, ...). Does not suppress the comment
+supplied with \fB\-c\fR.
+
+.TP 5
+\fB\-f\fR \fIDIRECTORY\fR
+Directory in which to write the resulting XML file. The name of the
+file will be the printer ID with the ".xml" extension.
+
+.TP 5
+\fB\-n\fR
+Do not write modified versions of existing XML files, only create XML
+files for printers for which there is no XML file yet.
+
+.TP 5
+\fB\-x\fR
+Create XML files independent of whether or not there are already XML
+files for the printers covered by the PPD. This makes the process
+vastly faster if you have PPD files for printers which are definitely
+not yet in the Foomatic database.
+
+.SH EXIT STATUS
+\fBfoomatic-ppd-to-xml\fR returns 0 on success, 1 otherwise.
+
+.SH BUGS
+None so far.
+
+Please post bug reports on
+
+http://lists.freestandards.org/mailman/listinfo/printing-foomatic
+
diff -up foomatic-db-engine-4.0.11/foomatic-printermap-to-gutenprint-xml.1.in.manpages foomatic-db-engine-4.0.11/foomatic-printermap-to-gutenprint-xml.1.in
--- foomatic-db-engine-4.0.11/foomatic-printermap-to-gutenprint-xml.1.in.manpages 2014-08-21 16:36:05.931418908 +0100
+++ foomatic-db-engine-4.0.11/foomatic-printermap-to-gutenprint-xml.1.in 2014-08-21 16:36:05.931418908 +0100
@@ -0,0 +1,18 @@
+.\" This -*- nroff -*- source file is part of foomatic.
+.\"
+.TH FOOMATIC-PRINTERMAP-TO-GUTENPRINT-XML 1 "2014-08-21" "Foomatic Project"
+.SH NAME
+foomatic-printermap-to-gutenprint-xml \- Updates Gutenprint driver XML file
+.SH SYNOPSIS
+.HP \w'\fBfoomatic-printermap-to-gutenprint-xml\fR\ 'u
+\fBfoomatic-printermap-to-gutenprint-xml\fR
+
+.SH DESCRIPTION
+.PP
+This command updates the driver XML file for the Gutenprint driver to
+the state of the foomatic-printermap file in the Gutenprint source
+tree. Used to update the driver XML file for Gutenprint in the
+OpenPrinting database.
+
+.PP
+It is very unlikely you need to do this.
diff -up foomatic-db-engine-4.0.11/foomatic-replaceoldprinterids.1.in.manpages foomatic-db-engine-4.0.11/foomatic-replaceoldprinterids.1.in
--- foomatic-db-engine-4.0.11/foomatic-replaceoldprinterids.1.in.manpages 2014-08-21 16:36:33.311603350 +0100
+++ foomatic-db-engine-4.0.11/foomatic-replaceoldprinterids.1.in 2014-08-21 16:38:33.113410376 +0100
@@ -0,0 +1,18 @@
+.\" This -*- nroff -*- source file is part of foomatic.
+.\"
+.TH FOOMATIC-REPLACEOLDPRINTERIDS 1 "2014-08-21" "Foomatic Project"
+.SH NAME
+foomatic-replaceoldprinterids \- Replace references to old printer IDs
+.SH SYNOPSIS
+.HP \w'\fBfoomatic-replaceoldprinterids\fR\ 'u
+\fBfoomatic-replaceoldprinterids\fR
+
+.SH DESCRIPTION
+.PP
+Replaces references to old numerical or otherwise obsolete printer IDs
+in arbitrary file. By default it uses the db/oldprinterids file of the
+current Foomatic database as translation table, but you can use
+arbitrary translation tables.
+
+.PP
+It is very unlikely you need to use this.
diff -up foomatic-db-engine-4.0.11/foomatic-searchprinter.1.in.manpages foomatic-db-engine-4.0.11/foomatic-searchprinter.1.in
--- foomatic-db-engine-4.0.11/foomatic-searchprinter.1.in.manpages 2014-08-21 16:36:05.932418915 +0100
+++ foomatic-db-engine-4.0.11/foomatic-searchprinter.1.in 2014-08-21 16:36:05.932418915 +0100
@@ -0,0 +1,82 @@
+.\" This -*- nroff -*- source file is part of foomatic.
+.\"
+.TH FOOMATIC-SEARCHPRINTER 1 "2014-08-21" "Foomatic Project"
+.SH NAME
+foomatic-searchprinter \- Search Foomatic database
+.SH SYNOPSIS
+.HP \w'\fBfoomatic-searchprinter\fR\ 'u
+\fBfoomatic-searchprinter\fR [\-m\fIM\fR] [\-d\FID\fR] \fISEARCHTERM\fR
+.HP \w'\fBfoomatic-searchprinter\fR\ 'u
+\fBfoomatic-searchprinter\fR \-h
+
+.SH DESCRIPTION
+This command displays Foomatic database entries matching \fISEARCHTERM\fR.
+
+.SS Options
+.PP
+\fB\-m\fR\fIM\fR
+.RS 4
+Search mode:
+.PP
+\fIM\fR = 0
+.RS 4
+Match everything (default)
+.RE
+.PP
+\fIM\fR = 1
+.RS 4
+No matches on only the manufacturer
+.RE
+.PP
+\fIM\fR = 2
+.RS 4
+No matches on only the manufacturer or only the model
+.RE
+.PP
+\fIM\fR = 3
+.RS 4
+Exact matches of device ID, make/model, or Foomatic ID plus matches of
+the page description language in the device ID to appropriate
+"Generic" printers
+.RE
+.PP
+\fIM\fR = 4
+.RS 4
+Exact matches of device ID, make/model, or Foomatic ID only
+.RE
+.RE
+
+.PP
+\fB\-d\fR\fID\fR
+.RS 4
+Display results:
+.PP
+\fID\fR = 0
+.RS 4
+Everything
+.RE
+.PP
+\fID\fR = 1
+.RS 4
+Only best match class (default)
+.RE
+.PP
+\fID\fR = 2
+.RS 4
+Only best match
+.RE
+.RE
+
+.PP
+\fB\-h\fR
+.RS 4
+Show help message and exit.
+.RE
+
+.SH BUGS
+None so far.
+
+Please post bug reports on
+
+http://lists.freestandards.org/mailman/listinfo/printing-foomatic
+

View File

@ -1,7 +1,7 @@
Summary: Tools for using the foomatic database of printers and printer drivers Summary: Tools for using the foomatic database of printers and printer drivers
Name: foomatic Name: foomatic
Version: 4.0.11 Version: 4.0.11
Release: 3%{?dist} Release: 4%{?dist}
License: GPLv2+ License: GPLv2+
# printer-filters package has gone (bug #967316, bug #1035450). # printer-filters package has gone (bug #967316, bug #1035450).
@ -12,6 +12,7 @@ Provides: printer-filters = 1.1-8
Source0: http://www.openprinting.org/download/foomatic/foomatic-db-engine-%{version}.tar.gz Source0: http://www.openprinting.org/download/foomatic/foomatic-db-engine-%{version}.tar.gz
## PATCHES FOR FOOMATIC-DB-ENGINE (PATCHES 101 TO 200) ## PATCHES FOR FOOMATIC-DB-ENGINE (PATCHES 101 TO 200)
Patch101: foomatic-manpages.patch
## PATCHES FOR FOOMATIC-DB-HPIJS (PATCHES 201 TO 300) ## PATCHES FOR FOOMATIC-DB-HPIJS (PATCHES 201 TO 300)
@ -59,6 +60,9 @@ The site http://www.linuxprinting.org/ is based on this database.
%prep %prep
%setup -q -n foomatic-db-engine-%{version} %setup -q -n foomatic-db-engine-%{version}
# Ship more manpages.
%patch101 -p1 -b .manpages
chmod a+x mkinstalldirs chmod a+x mkinstalldirs
%build %build
@ -114,17 +118,29 @@ exit 0
%{_sbindir}/* %{_sbindir}/*
%{perl_vendorlib}/Foomatic %{perl_vendorlib}/Foomatic
%{_cups_serverbin}/driver/* %{_cups_serverbin}/driver/*
%{_mandir}/man1/foomatic-cleanupdrivers.1*
%{_mandir}/man1/foomatic-combo-xml.1* %{_mandir}/man1/foomatic-combo-xml.1*
%{_mandir}/man1/foomatic-compiledb.1* %{_mandir}/man1/foomatic-compiledb.1*
%{_mandir}/man1/foomatic-configure.1* %{_mandir}/man1/foomatic-configure.1*
%{_mandir}/man1/foomatic-datafile.1*
%{_mandir}/man1/foomatic-extract-text.1*
%{_mandir}/man1/foomatic-fix-xml.1*
%{_mandir}/man1/foomatic-nonumericalids.1*
%{_mandir}/man1/foomatic-perl-data.1* %{_mandir}/man1/foomatic-perl-data.1*
%{_mandir}/man1/foomatic-ppd-options.1* %{_mandir}/man1/foomatic-ppd-options.1*
%{_mandir}/man1/foomatic-ppd-to-xml.1*
%{_mandir}/man1/foomatic-ppdfile.1* %{_mandir}/man1/foomatic-ppdfile.1*
%{_mandir}/man1/foomatic-printermap-to-gutenprint-xml.1*
%{_mandir}/man1/foomatic-printjob.1* %{_mandir}/man1/foomatic-printjob.1*
%{_mandir}/man1/foomatic-replaceoldprinterids.1*
%{_mandir}/man1/foomatic-searchprinter.1*
%{_mandir}/man8/* %{_mandir}/man8/*
%{_var}/cache/foomatic %{_var}/cache/foomatic
%changelog %changelog
* Thu Aug 21 2014 Tim Waugh <twaugh@redhat.com> - 4.0.11-4
- Ship more manpages.
* Sat Aug 16 2014 Fedora Release Engineering <rel-eng@lists.fedoraproject.org> - 4.0.11-3 * Sat Aug 16 2014 Fedora Release Engineering <rel-eng@lists.fedoraproject.org> - 4.0.11-3
- Rebuilt for https://fedoraproject.org/wiki/Fedora_21_22_Mass_Rebuild - Rebuilt for https://fedoraproject.org/wiki/Fedora_21_22_Mass_Rebuild