Blame SOURCES/foomatic-manpages.patch

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