From da68fb12b3e32bfefcf24fe2581cfb4a4d80a692 Mon Sep 17 00:00:00 2001 From: Akihiro MOTOKI Date: Tue, 12 Jun 2012 02:24:05 +0900 Subject: [PATCH] cups: Newly add originals from cups-1.5.3. --- manual/cups/original/man1/cancel.1 | 75 +++++++++++ manual/cups/original/man1/lp.1 | 258 +++++++++++++++++++++++++++++++++++++ manual/cups/original/man1/lpq.1 | 72 +++++++++++ manual/cups/original/man1/lpr.1 | 122 ++++++++++++++++++ manual/cups/original/man1/lprm.1 | 65 ++++++++++ manual/cups/original/man1/lpstat.1 | 143 ++++++++++++++++++++ 6 files changed, 735 insertions(+) create mode 100644 manual/cups/original/man1/cancel.1 create mode 100644 manual/cups/original/man1/lp.1 create mode 100644 manual/cups/original/man1/lpq.1 create mode 100644 manual/cups/original/man1/lpr.1 create mode 100644 manual/cups/original/man1/lprm.1 create mode 100644 manual/cups/original/man1/lpstat.1 diff --git a/manual/cups/original/man1/cancel.1 b/manual/cups/original/man1/cancel.1 new file mode 100644 index 00000000..eda61eb1 --- /dev/null +++ b/manual/cups/original/man1/cancel.1 @@ -0,0 +1,75 @@ +.\" +.\" "$Id: cancel.man 9771 2011-05-12 05:21:56Z mike $" +.\" +.\" cancel man page for CUPS. +.\" +.\" Copyright 2007-2011 by Apple Inc. +.\" Copyright 1997-2006 by Easy Software Products. +.\" +.\" These coded instructions, statements, and computer programs are the +.\" property of Apple Inc. and are protected by Federal copyright +.\" law. Distribution and use rights are outlined in the file "LICENSE.txt" +.\" which should have been included with this file. If this file is +.\" file is missing or damaged, see the license at "http://www.cups.org/". +.\" +.TH cancel 1 "CUPS" "20 March 2006" "Apple Inc." +.SH NAME +cancel - cancel jobs +.SH SYNOPSIS +.B cancel +[ -E ] [ -U +.I username +] [ -a ] [ -h +.I hostname[:port] +] [ -u +.I username +] [ +.I id +] [ +.I destination +] [ +.I destination-id +] +.SH DESCRIPTION +\fIcancel\fR cancels existing print jobs. The \fI-a\fR option will remove +all jobs from the specified destination. +.SH OPTIONS +The following options are recognized by \fIcancel\fR: +.TP 5 +-E +.br +Forces encryption when connecting to the server. +.TP 5 +-U username +.br +Specifies the username to use when connecting to the server. +.TP 5 +-a +.br +Cancel all jobs on the named destination, or all jobs on all +destinations if none is provided. +.TP 5 +-h hostname[:port] +.br +Chooses an alternate server. +.TP 5 +-u username +.br +Cancels jobs owned by \fIusername\fR. +.SH COMPATIBILITY +Unlike the System V printing system, CUPS allows printer names to +contain any printable character except SPACE, TAB, "/", or "#". +Also, printer and class names are \fInot\fR case-sensitive. +.SH NOTES +Administrators wishing to prevent unauthorized cancellation of +jobs via the \fI-u\fR option should require authentication for +Cancel-Jobs operations in \fIcupsd.conf(5)\fR. +.SH SEE ALSO +\fIlp(1)\fR, \fIlpmove(8)\fR, \fIlpstat(1)\fR, +.br +http://localhost:631/help +.SH COPYRIGHT +Copyright 2007-2011 by Apple Inc. +.\" +.\" End of "$Id: cancel.man 9771 2011-05-12 05:21:56Z mike $". +.\" diff --git a/manual/cups/original/man1/lp.1 b/manual/cups/original/man1/lp.1 new file mode 100644 index 00000000..b4ebea96 --- /dev/null +++ b/manual/cups/original/man1/lp.1 @@ -0,0 +1,258 @@ +.\" +.\" "$Id: lp.man 10042 2011-10-03 17:32:43Z mike $" +.\" +.\" lp man page for CUPS. +.\" +.\" Copyright 2007-2011 by Apple Inc. +.\" Copyright 1997-2006 by Easy Software Products. +.\" +.\" These coded instructions, statements, and computer programs are the +.\" property of Apple Inc. and are protected by Federal copyright +.\" law. Distribution and use rights are outlined in the file "LICENSE.txt" +.\" which should have been included with this file. If this file is +.\" file is missing or damaged, see the license at "http://www.cups.org/". +.\" +.TH lp 1 "CUPS" "3 October 2011" "Apple Inc." +.SH NAME +lp - print files +.SH SYNOPSIS +.B lp +[ -E ] [ -U +.I username +] [ -c ] [ -d +.I destination[/instance] +] [ -h +.I hostname[:port] +] [ -m ] [ -n +.I num-copies +] [ -o +.I option[=value] +] [ -q +.I priority +] [ -s ] [ -t +.I title +] [ -H +.I handling +] [ -P +.I page-list +] [ -- ] [ +.I file(s) +] +.br +.B lp +[ -E ] [ -U +.I username +] [ -c ] [ -h +.I hostname[:port] +] [ -i +.I job-id +] [ -n +.I num-copies +] [ -o +.I option[=value] +] [ -q +.I priority +] [ -t +.I title +] [ -H +.I handling +] [ -P +.I page-list +] +.SH DESCRIPTION +\fIlp\fR submits files for printing or alters a pending job. Use +a filename of "-" to force printing from the standard input. +.SH THE DEFAULT DESTINATION +CUPS provides many ways to set the default destination. The "LPDEST" and +"PRINTER" environment variables are consulted first. If neither are set, +the current default set using the \fIlpoptions(1)\fR command is used, +followed by the default set using the \fIlpadmin(8)\fR command. +.SH OPTIONS +The following options are recognized by \fIlp\fR: +.TP 5 +-- +.br +Marks the end of options; use this to print a file whose name +begins with a dash (-). +.TP 5 +-E +.br +Forces encryption when connecting to the server. +.TP 5 +-U username +.br +Specifies the username to use when connecting to the server. +.TP 5 +-c +.br +This option is provided for backwards-compatibility only. On +systems that support it, this option forces the print file to be +copied to the spool directory before printing. In CUPS, print +files are always sent to the scheduler via IPP which has the +same effect. +.TP 5 +-d destination +.br +Prints files to the named printer. +.TP 5 +-h hostname[:port] +.br +Chooses an alternate server. +.TP 5 +-i job-id +.br +Specifies an existing job to modify. +.TP 5 +-m +.br +Sends an email when the job is completed. +.TP 5 +-n copies +.br +Sets the number of copies to print from 1 to 100. +.TP 5 +-o "name=value [name=value ...]" +.br +Sets one or more job options. +.TP 5 +-q priority +.br +Sets the job priority from 1 (lowest) to 100 (highest). The +default priority is 50. +.TP 5 +-s +.br +Do not report the resulting job IDs (silent mode.) +.TP 5 +-t "name" +.br +Sets the job name. +.TP 5 +-H hh:mm +.TP 5 +-H hold +.TP 5 +-H immediate +.TP 5 +-H restart +.TP 5 +-H resume +.br +Specifies when the job should be printed. A value of \fIimmediate\fR will print +the file immediately, a value of \fIhold\fR will hold the job indefinitely, and +a UTC time value (HH:MM) will hold the job until the specified UTC (not local) +time. Use a value of \fIresume\fR with the \fI-i\fR option to resume a held job. +Use a value of \fIrestart\fR with the \fI-i\fR option to restart +a completed job. +.TP 5 +-P page-list +.br +Specifies which pages to print in the document. The list can +contain a list of numbers and ranges (#-#) separated by commas +(e.g. 1,3-5,16). The page numbers refer to the output pages and +not the document's original pages - options like "number-up" can +affect the numbering of the pages. +.SH COMMON JOB OPTIONS +Aside from the printer-specific options reported by the +\fIlpoptions(1)\fR command, the following generic options are +available: +.TP 5 +-o media=size +.br +Sets the page size to \fIsize\fR. Most printers support at least +the size names "a4", "letter", and "legal". +.TP 5 +-o landscape +.TP 5 +-o orientation-requested=4 +.br +Prints the job in landscape (rotated 90 degrees). +.TP 5 +-o sides=one-sided +.TP 5 +-o sides=two-sided-long-edge +.TP 5 +-o sides=two-sided-short-edge +.br +Prints on one or two sides of the paper. The value +"two-sided-long-edge" is normally used when printing portrait +(unrotated) pages, while "two-sided-short-edge" is used for +landscape pages. +.TP 5 +-o fitplot +.br +Scales the print file to fit on the page. +.TP 5 +-o number-up=2 +.TP 5 +-o number-up=4 +.TP 5 +-o number-up=6 +.TP 5 +-o number-up=9 +.TP 5 +-o number-up=16 +.br +Prints multiple document pages on each output page. +.TP 5 +-o scaling=number +.br +Scales image files to use up to \fInumber\fR percent of the page. +Values greater than 100 cause the image file to be printed across +multiple pages. +.TP 5 +-o cpi=N +.br +Sets the number of characters per inch to use when printing a +text file. The default is 10. +.TP 5 +-o lpi=N +.br +Sets the number of lines per inch to use when printing a text +file. The default is 6. +.TP 5 +-o page-bottom=N +.TP 5 +-o page-left=N +.TP 5 +-o page-right=N +.TP 5 +-o page-top=N +.br +Sets the page margins when printing text files. The values are in +points - there are 72 points to the inch. +.SH EXAMPLES +Print a double-sided legal document to a printer called "foo": +.nf + lp -d foo -o media=legal -o sides=two-sided-long-edge filename +.fi +.LP +Print an image across 4 pages: +.nf + lp -d bar -o scaling=200 filename +.fi +.LP +Print a text file with 12 characters per inch, 8 lines per inch, and +a 1 inch left margin: +.nf + lp -d bar -o cpi=12 -o lpi=8 -o page-left=72 filename +.fi +.SH COMPATIBILITY +Unlike the System V printing system, CUPS allows printer names to +contain any printable character except SPACE, TAB, "/", or "#". +Also, printer and class names are \fInot\fR case-sensitive. +.LP +The "q" option accepts a different range of values than the +Solaris lp command, matching the IPP job priority values (1-100, +100 is highest priority) instead of the Solaris values (0-39, 0 +is highest priority). +.SH SEE ALSO +\fIcancel(1)\fR, \fIlpadmin(8)\fR, \fIlpmove(8)\fR, \fIlpoptions(1)\fR, +\fIlpstat(1)\fR, +.br +http://localhost:631/help +.SH COPYRIGHT +Copyright 2007-2011 by Apple Inc. +.\" +.\" End of "$Id: lp.man 10042 2011-10-03 17:32:43Z mike $". +.\" diff --git a/manual/cups/original/man1/lpq.1 b/manual/cups/original/man1/lpq.1 new file mode 100644 index 00000000..502d45a0 --- /dev/null +++ b/manual/cups/original/man1/lpq.1 @@ -0,0 +1,72 @@ +.\" +.\" "$Id: lpq.man 9771 2011-05-12 05:21:56Z mike $" +.\" +.\" lpq man page for CUPS. +.\" +.\" Copyright 2007-2011 by Apple Inc. +.\" Copyright 1997-2006 by Easy Software Products. +.\" +.\" These coded instructions, statements, and computer programs are the +.\" property of Apple Inc. and are protected by Federal copyright +.\" law. Distribution and use rights are outlined in the file "LICENSE.txt" +.\" which should have been included with this file. If this file is +.\" file is missing or damaged, see the license at "http://www.cups.org/". +.\" +.TH lpq 1 "CUPS" "16 June 2008" "Apple Inc." +.SH NAME +lpq \- show printer queue status +.SH SYNOPSIS +.B lpq +[ -E ] [ -U +.I username +] [ -h +.I server[:port] +] [ -P +.I destination[/instance] +] [ -a ] [ -l ] [ +.I +interval +] +.SH DESCRIPTION +\fIlpq\fR shows the current print queue status on the named +printer. Jobs queued on the default destination will be shown if +no printer or class is specified on the command-line. +.LP +The \fI+interval\fR option allows you to continuously report the +jobs in the queue until the queue is empty; the list of jobs is +shown once every \fIinterval\fR seconds. +.SH OPTIONS +\fIlpq\fR supports the following options: +.TP 5 +-E +.br +Forces encryption when connecting to the server. +.TP 5 +-P destination[/instance] +.br +Specifies an alternate printer or class name. +.TP 5 +-U username +.br +Specifies an alternate username. +.TP 5 +-a +.br +Reports jobs on all printers. +.TP 5 +-h server[:port] +.br +Specifies an alternate server. +.TP 5 +-l +.br +Requests a more verbose (long) reporting format. +.SH SEE ALSO +\fIcancel(1)\fR, \fIlp(1)\fR, \fIlpr(1)\fR, \fIlprm(1)\fR, +\fIlpstat(1)\fR, +.br +http://localhost:631/help +.SH COPYRIGHT +Copyright 2007-2011 by Apple Inc. +.\" +.\" End of "$Id: lpq.man 9771 2011-05-12 05:21:56Z mike $". +.\" diff --git a/manual/cups/original/man1/lpr.1 b/manual/cups/original/man1/lpr.1 new file mode 100644 index 00000000..b60a265e --- /dev/null +++ b/manual/cups/original/man1/lpr.1 @@ -0,0 +1,122 @@ +.\" +.\" "$Id: lpr.man 9771 2011-05-12 05:21:56Z mike $" +.\" +.\" lpr man page for CUPS. +.\" +.\" Copyright 2007-2011 by Apple Inc. +.\" Copyright 1997-2006 by Easy Software Products. +.\" +.\" These coded instructions, statements, and computer programs are the +.\" property of Apple Inc. and are protected by Federal copyright +.\" law. Distribution and use rights are outlined in the file "LICENSE.txt" +.\" which should have been included with this file. If this file is +.\" file is missing or damaged, see the license at "http://www.cups.org/". +.\" +.TH lpr 1 "CUPS" "29 August 2008" "Apple Inc." +.SH NAME +lpr \- print files +.SH SYNOPSIS +.B lpr +[ -E ] [ -H +.I server[:port] +] [ -U +.I username +] [ -P +.I destination[/instance] +] [ -# +.I num-copies +[ -h ] [ -l ] [ -m ] [ -o +.I option[=value] +] [ -p] [ -q ] [ -r ] [ -C/J/T +.I title +] [ +.I file(s) +] +.SH DESCRIPTION +\fIlpr\fR submits files for printing. Files named on the command +line are sent to the named printer (or the default destination if no +destination is specified). If no files are listed on the command-line, +\fIlpr\fR reads the print file from the standard input. +.SH THE DEFAULT DESTINATION +CUPS provides many ways to set the default destination. The "LPDEST" and +"PRINTER" environment variables are consulted first. If neither are set, +the current default set using the \fIlpoptions(1)\fR command is used, +followed by the default set using the \fIlpadmin(8)\fR command. +.SH OPTIONS +The following options are recognized by \fIlpr\fR: +.TP 5 +-E +.br +Forces encryption when connecting to the server. +.TP 5 +-H server[:port] +.br +Specifies an alternate server. +.TP 5 +-C "name" +.TP 5 +-J "name" +.TP 5 +-T "name" +.br +Sets the job name. +.TP 5 +-P destination[/instance] +.br +Prints files to the named printer. +.TP 5 +-U username +.br +Specifies an alternate username. +.TP 5 +-# \fIcopies\fR +.br +Sets the number of copies to print from 1 to 100. +.TP 5 +-h +.br +Disables banner printing. This option is equivalent to "-o +job-sheets=none". +.TP 5 +-l +.br +Specifies that the print file is already formatted for the +destination and should be sent without filtering. This option is +equivalent to "-o raw". +.TP 5 +-m +.br +Send an email on job completion. +.TP 5 +-o option[=value] +.br +Sets a job option. +.TP 5 +-p +.br +Specifies that the print file should be formatted with a shaded +header with the date, time, job name, and page number. This +option is equivalent to "-o prettyprint" and is only useful when +printing text files. +.TP 5 +-q +.br +Hold job for printing. +.TP 5 +-r +.br +Specifies that the named print files should be deleted after +printing them. +.SH COMPATIBILITY +The "c", "d", "f", "g", "i", "n", "t", "v", and "w" options +are not supported by CUPS and produce a warning message if used. +.SH SEE ALSO +\fIcancel(1)\fR, \fIlp(1)\fR, \fIlpadmin(8)\fR, \fIlpoptions(1)\fR, +\fIlpq(1)\fR, \fIlprm(1)\fR, \fIlpstat(1)\fR, +.br +http://localhost:631/help +.SH COPYRIGHT +Copyright 2007-2011 by Apple Inc. +.\" +.\" End of "$Id: lpr.man 9771 2011-05-12 05:21:56Z mike $". +.\" diff --git a/manual/cups/original/man1/lprm.1 b/manual/cups/original/man1/lprm.1 new file mode 100644 index 00000000..d64ac03d --- /dev/null +++ b/manual/cups/original/man1/lprm.1 @@ -0,0 +1,65 @@ +.\" +.\" "$Id: lprm.man 9771 2011-05-12 05:21:56Z mike $" +.\" +.\" lprm man page for CUPS. +.\" +.\" Copyright 2007-2011 by Apple Inc. +.\" Copyright 1997-2006 by Easy Software Products. +.\" +.\" These coded instructions, statements, and computer programs are the +.\" property of Apple Inc. and are protected by Federal copyright +.\" law. Distribution and use rights are outlined in the file "LICENSE.txt" +.\" which should have been included with this file. If this file is +.\" file is missing or damaged, see the license at "http://www.cups.org/". +.\" +.TH lprm 1 "CUPS" "28 August 2009" "Apple Inc." +.SH NAME +lprm \- cancel print jobs +.SH SYNOPSIS +.B lprm +[ -E ] [ -U +.I username +] [ -h +.I server[:port] +] [ -P +.I destination[/instance] +] [ - ] [ +.I job ID(s) +] +.SH DESCRIPTION +\fIlprm\fR cancels print jobs that have been queued for printing. +If no arguments are supplied, the current job on the default +destination is cancelled. You can specify one or more job ID +numbers to cancel those jobs or use the \fI-\fR option to cancel +all jobs. +.SH OPTIONS +The \fIlprm\fR command supports the following options: +.TP 5 +-E +.br +Forces encryption when connecting to the server. +.TP 5 +-P destination[/instance] +.br +Specifies the destination printer or class. +.TP 5 +-U username +.br +Specifies an alternate username. +.TP 5 +-h server[:port] +.br +Specifies an alternate server. +.SH COMPATIBILITY +The CUPS version of \fIlprm\fR is compatible with the standard +Berkeley \fIlprm\fR command. +.SH SEE ALSO +\fIcancel(1)\fR, \fIlp(1)\fR, \fIlpq(1)\fR, \fIlpr(1)\fR, +\fIlpstat(1)\fR, +.br +http://localhost:631/help +.SH COPYRIGHT +Copyright 2007-2011 by Apple Inc. +.\" +.\" End of "$Id: lprm.man 9771 2011-05-12 05:21:56Z mike $". +.\" diff --git a/manual/cups/original/man1/lpstat.1 b/manual/cups/original/man1/lpstat.1 new file mode 100644 index 00000000..c51c44ad --- /dev/null +++ b/manual/cups/original/man1/lpstat.1 @@ -0,0 +1,143 @@ +.\" +.\" "$Id: lpstat.man 9771 2011-05-12 05:21:56Z mike $" +.\" +.\" lpstat man page for CUPS. +.\" +.\" Copyright 2007-2011 by Apple Inc. +.\" Copyright 1997-2006 by Easy Software Products. +.\" +.\" These coded instructions, statements, and computer programs are the +.\" property of Apple Inc. and are protected by Federal copyright +.\" law. Distribution and use rights are outlined in the file "LICENSE.txt" +.\" which should have been included with this file. If this file is +.\" file is missing or damaged, see the license at "http://www.cups.org/". +.\" +.TH lpstat 1 "CUPS" "10 September 2008" "Apple Inc." +.SH NAME +lpstat \- print cups status information +.SH SYNOPSIS +.B lpstat +[ -E ] [ -H ] [ -U +.I username +] [ -h +.I hostname[:port] +] [ -l ] [ -W +.I which-jobs +] [ -a [ +.I destination(s) +] ] [ -c [ +.I class(es) +] ] [ -d ] [ -o [ +.I destination(s) +] ] [ -p [ +.I printer(s) +] ] [ -r ] [ -R ] [ -s ] [ -t ] [ -u [ +.I user(s) +] ] [ -v [ +.I printer(s) +] ] +.SH DESCRIPTION +\fIlpstat\fR displays status information about the current +classes, jobs, and printers. When run with no arguments, +\fIlpstat\fR will list jobs queued by the current user. +.SH OPTIONS +The \fIlpstat\fR command supports the following options: +.TP 5 +-E +.br +Forces encryption when connecting to the server. +.TP 5 +-H +.br +Shows the server hostname and port. +.TP 5 +-R +.br +Shows the ranking of print jobs. +.TP 5 +-U username +.br +Specifies an alternate username. +.TP 5 +-W which-jobs +.br +Specifies which jobs to show, \fIcompleted\fR or +\fInot-completed\fR (the default). This option \fImust\fR appear +before the \fI-o\fR option and/or any printer names, otherwise +the default (not-completed) value will be used in the request to +the scheduler. +.TP 5 +-a [printer(s)] +.br +Shows the accepting state of printer queues. If no printers are +specified then all printers are listed. +.TP 5 +-c [class(es)] +.br +Shows the printer classes and the printers that belong to them. +If no classes are specified then all classes are listed. +.TP 5 +-d +.br +Shows the current default destination. +.TP 5 +-h server[:port] +.br +Specifies an alternate server. +.TP 5 +-l +.br +Shows a long listing of printers, classes, or jobs. +.TP 5 +-o [destination(s)] +.br +Shows the jobs queue on the specified destinations. If no destinations are +specified all jobs are shown. +.TP 5 +-p [printer(s)] +.br +Shows the printers and whether or not they are enabled for printing. If +no printers are specified then all printers are listed. +.TP 5 +-r +.br +Shows whether the CUPS server is running. +.TP 5 +-s +.br +Shows a status summary, including the default destination, a +list of classes and their member printers, and a list of printers and +their associated devices. This is equivalent to using the "-d", "-c", +and "-v" options. +.TP 5 +-t +.br +Shows all status information. This is equivalent to using the "-r", +"-d", "-c", "-v", "-a", "-p", and "-o" options. +.TP 5 +-u [user(s)] +.br +Shows a list of print jobs queued by the specified users. If no users +are specified, lists the jobs queued by the current user. +.TP 5 +-v [printer(s)] +.br +Shows the printers and what device they are attached to. If no printers +are specified then all printers are listed. +.SH COMPATIBILITY +Unlike the System V printing system, CUPS allows printer names to +contain any printable character except SPACE, TAB, "/", and "#". +Also, printer and class names are \fInot\fR case-sensitive. +.LP +The "-h", "-E", "-U", and "-W" options are unique to CUPS. +.LP +The Solaris "-f", "-P", and "-S" options are silently ignored. +.SH SEE ALSO +\fIcancel(1)\fR, \fIlp(1)\fR, +.br +http://localhost:631/help +.SH COPYRIGHT +Copyright 2007-2011 by Apple Inc. +.\" +.\" End of "$Id: lpstat.man 9771 2011-05-12 05:21:56Z mike $". +.\" -- 2.11.0