freebsd-dev/usr.sbin/lpr/lp/lp.1

.\"
.\" Copyright (c) 1995 Joerg Wunsch
.\"
.\" All rights reserved.
.\"
.\" This program is free software.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by Joerg Wunsch
.\" 4. The name of the developer may not be used to endorse or promote
.\"    products derived from this software without specific prior written
.\"    permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\" $FreeBSD$
.\"
.Dd January 22, 1995
.Dt LP 1
.Os
.Sh NAME
.Nm lp
.Nd front-end to the print spooler
.Sh SYNOPSIS
.Nm
.Op Fl cs
.Op Fl o Ar option
.Op Fl d Ar printer
.Op Fl n Ar num
.Op Ar name ...
.Sh DESCRIPTION
.Nm \&Lp
is a front-end to the print spooler as required by the
.St -p1003.2
specification.  It effectively invokes
.Xr lpr 1
with the proper set of arguments.
.Pp
It generally prints the named files on the destination printer.
.Pp
The following options are available:
.Bl -tag -width indent
.It Fl c
Make the
.Nm
command exit only after further access to any of the input files is no
longer required.  The application can then safely delete or modify the
files without affecting the output operation.
.It Fl d Ar dest
Specify a particular printer.
If no
.Fl d
is provided on the command line, the contents of the environment
variables
.Ev LPDEST
or
.Ev PRINTER
(with this precedence)
are taken as the destination printer.
.It Fl n Ar num
Specify that
.Ar num
copies of each of the named files shall be printed.
.It Fl o Ar option
Printer specific options.
Not supported, provided only as a compatibility
option for SVR.
.It Fl s
Silent operation.
Not supported,
provided only as a compatibility option for
.St -susv2 .
.El
.Sh ENVIRONMENT
As described above, the variables
.Ev LPDEST
and
.Ev PRINTER
are examined to select the destination printer.
.Sh SEE ALSO
.Xr lpr 1
.Sh STANDARDS
The
.Nm
command is expected to comply with the
.St -p1003.2
specification.
.Sh AUTHORS
This implementation of the
.Nm
command has been written by
.An J\(:org Wunsch .
.Sh BUGS
The
.St -p1003.2
specification does not provide any means to print non-text files.  It
rather requires the files to be printed to be text files limited to
reasonable line lengths and printable characters.
Implementing the "lp" command. This command is required to exist in terms of compatibility with the Posix 1003.2 specification. It actually invokes the lpr service with the proper options. 1995-01-23 19:22:43 +00:00			`.\"`
			`.\" Copyright (c) 1995 Joerg Wunsch`
			`.\"`
			`.\" All rights reserved.`
			`.\"`
			`.\" This program is free software.`
			`.\"`
			`.\" Redistribution and use in source and binary forms, with or without`
			`.\" modification, are permitted provided that the following conditions`
			`.\" are met:`
			`.\" 1. Redistributions of source code must retain the above copyright`
			`.\" notice, this list of conditions and the following disclaimer.`
			`.\" 2. Redistributions in binary form must reproduce the above copyright`
			`.\" notice, this list of conditions and the following disclaimer in the`
			`.\" documentation and/or other materials provided with the distribution.`
			`.\" 3. All advertising materials mentioning features or use of this software`
			`.\" must display the following acknowledgement:`
			`.\" This product includes software developed by Joerg Wunsch`
			`.\" 4. The name of the developer may not be used to endorse or promote`
			`.\" products derived from this software without specific prior written`
			`.\" permission.`
			`.\"`
			.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR
			`.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES`
			`.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.`
			`.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT,`
			`.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT`
			`.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,`
			`.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY`
			`.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT`
			`.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF`
			`.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.`
			`.\"`
$Id$ -> $FreeBSD$ 1999-08-28 01:35:59 +00:00			`.\" $FreeBSD$`
Implementing the "lp" command. This command is required to exist in terms of compatibility with the Posix 1003.2 specification. It actually invokes the lpr service with the proper options. 1995-01-23 19:22:43 +00:00			`.\"`
			`.Dd January 22, 1995`
			`.Dt LP 1`
			`.Os`
			`.Sh NAME`
			`.Nm lp`
			`.Nd front-end to the print spooler`
			`.Sh SYNOPSIS`
mdoc(7) police: use the new features of the Nm macro. 2000-11-20 20:10:44 +00:00			`.Nm`
Add a dummy -s option for SUSv2 compatibility. PR: 17256 Reported by: Brooks Davis <brooks@one-eyed-alien.net> Approved by: jkh (release engineer) 2000-03-08 10:02:11 +00:00			`.Op Fl cs`
Add missing description for the dummy -o option. 2000-03-08 10:06:27 +00:00			`.Op Fl o Ar option`
Use err(3). Add usage(). Various fixes in man pages. 1997-09-24 06:48:24 +00:00			`.Op Fl d Ar printer`
Implementing the "lp" command. This command is required to exist in terms of compatibility with the Posix 1003.2 specification. It actually invokes the lpr service with the proper options. 1995-01-23 19:22:43 +00:00			`.Op Fl n Ar num`
			`.Op Ar name ...`
			`.Sh DESCRIPTION`
Prepare for mdoc(7)NG. 2000-12-27 15:30:30 +00:00			`.Nm \&Lp`
Implementing the "lp" command. This command is required to exist in terms of compatibility with the Posix 1003.2 specification. It actually invokes the lpr service with the proper options. 1995-01-23 19:22:43 +00:00			`is a front-end to the print spooler as required by the`
			`.St -p1003.2`
			`specification. It effectively invokes`
			`.Xr lpr 1`
			`with the proper set of arguments.`
Remove blanks lines, replacing them with Pp macros where appropriate. 2000-03-08 10:13:50 +00:00			`.Pp`
Implementing the "lp" command. This command is required to exist in terms of compatibility with the Posix 1003.2 specification. It actually invokes the lpr service with the proper options. 1995-01-23 19:22:43 +00:00			`It generally prints the named files on the destination printer.`
			`.Pp`
Use err(3). Add usage(). Various fixes in man pages. 1997-09-24 06:48:24 +00:00			`The following options are available:`
			`.Bl -tag -width indent`
			`.It Fl c`
			`Make the`
Implementing the "lp" command. This command is required to exist in terms of compatibility with the Posix 1003.2 specification. It actually invokes the lpr service with the proper options. 1995-01-23 19:22:43 +00:00			`.Nm`
			`command exit only after further access to any of the input files is no`
			`longer required. The application can then safely delete or modify the`
			`files without affecting the output operation.`
Use err(3). Add usage(). Various fixes in man pages. 1997-09-24 06:48:24 +00:00			`.It Fl d Ar dest`
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc. 2000-03-01 14:09:25 +00:00			`Specify a particular printer.`
			`If no`
Implementing the "lp" command. This command is required to exist in terms of compatibility with the Posix 1003.2 specification. It actually invokes the lpr service with the proper options. 1995-01-23 19:22:43 +00:00			`.Fl d`
environmental -> environment. 1997-09-18 06:55:21 +00:00			`is provided on the command line, the contents of the environment`
Implementing the "lp" command. This command is required to exist in terms of compatibility with the Posix 1003.2 specification. It actually invokes the lpr service with the proper options. 1995-01-23 19:22:43 +00:00			`variables`
			`.Ev LPDEST`
			`or`
			`.Ev PRINTER`
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block. 2001-08-07 15:48:51 +00:00			`(with this precedence)`
Implementing the "lp" command. This command is required to exist in terms of compatibility with the Posix 1003.2 specification. It actually invokes the lpr service with the proper options. 1995-01-23 19:22:43 +00:00			`are taken as the destination printer.`
Use err(3). Add usage(). Various fixes in man pages. 1997-09-24 06:48:24 +00:00			`.It Fl n Ar num`
			`Specify that`
Implementing the "lp" command. This command is required to exist in terms of compatibility with the Posix 1003.2 specification. It actually invokes the lpr service with the proper options. 1995-01-23 19:22:43 +00:00			`.Ar num`
			`copies of each of the named files shall be printed.`
Add missing description for the dummy -o option. 2000-03-08 10:06:27 +00:00			`.It Fl o Ar option`
			`Printer specific options.`
			`Not supported, provided only as a compatibility`
			`option for SVR.`
Add a dummy -s option for SUSv2 compatibility. PR: 17256 Reported by: Brooks Davis <brooks@one-eyed-alien.net> Approved by: jkh (release engineer) 2000-03-08 10:02:11 +00:00			`.It Fl s`
			`Silent operation.`
			`Not supported,`
			`provided only as a compatibility option for`
			`.St -susv2 .`
Use err(3). Add usage(). Various fixes in man pages. 1997-09-24 06:48:24 +00:00			`.El`
Implementing the "lp" command. This command is required to exist in terms of compatibility with the Posix 1003.2 specification. It actually invokes the lpr service with the proper options. 1995-01-23 19:22:43 +00:00			`.Sh ENVIRONMENT`
			`As described above, the variables`
			`.Ev LPDEST`
			`and`
			`.Ev PRINTER`
			`are examined to select the destination printer.`
			`.Sh SEE ALSO`
			`.Xr lpr 1`
			`.Sh STANDARDS`
			`The`
Use err(3). Add usage(). Various fixes in man pages. 1997-09-24 06:48:24 +00:00			`.Nm`
Implementing the "lp" command. This command is required to exist in terms of compatibility with the Posix 1003.2 specification. It actually invokes the lpr service with the proper options. 1995-01-23 19:22:43 +00:00			`command is expected to comply with the`
			`.St -p1003.2`
			`specification.`
.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq. 1998-03-23 08:31:20 +00:00			`.Sh AUTHORS`
Implementing the "lp" command. This command is required to exist in terms of compatibility with the Posix 1003.2 specification. It actually invokes the lpr service with the proper options. 1995-01-23 19:22:43 +00:00			`This implementation of the`
			`.Nm`
			`command has been written by`
Avoid use of direct troff requests in mdoc(7) manual pages. 2000-11-10 17:46:15 +00:00			`.An J\(:org Wunsch .`
Implementing the "lp" command. This command is required to exist in terms of compatibility with the Posix 1003.2 specification. It actually invokes the lpr service with the proper options. 1995-01-23 19:22:43 +00:00			`.Sh BUGS`
			`The`
			`.St -p1003.2`
			`specification does not provide any means to print non-text files. It`
			`rather requires the files to be printed to be text files limited to`
			`reasonable line lengths and printable characters.`