.\"
.\" $ApsCVS: src/apsfilter/man/apspreview.1.in,v 1.1.2.5 2002/02/24 20:47:52 andreas Exp $
.\"
.Dd Dec 27, 2001
.Dt APSPREVIEW 1
.Os
.Sh NAME
.Nm apspreview
.Nd preview PostScript file(s) as generated by apsfilter
.Sh SYNOPSIS
.Nm apspreview
.Op Fl P Ns Ar queue
.Op Fl Z Ns Ar options
.Op Ar input...
.Nm apspreview
.Op Fl h
.Sh DESCRIPTION
With
.Nm apspreview
you can create a PostScript representation of the file(s) you are
about to print in order to check it before actually printing.
.Pp
Your file(s) will be converted to PostScript according to the
queue specific configuration, and afterwards you will be able
to print all or some pages from your PostScript viewer application
(gv, kghostview or ghostview).
.Sh OPTIONS
.Bl -tag -width XXXXXXXXXX -compact
.It \fB\-h\fR
show help screen
.It \fB\-P Ns Ar queue\fR
select a printer queue (different from the default one)
.It \fB\-Z Ns Ar options\fR
use
.Ic apsfilter
command line options (comma-separated list)
.It \fBinput...\fR
input file(s) [default: stdin]
.El
.Sh NOTES
If you use the
.Ic -P
option, please remember to pass the same printer queue on to the
.Xr lpr 1
command.
.Pp
Be careful if your printer queue configuration includes a setting
to create multiple pages per sheet
.Ic (PS_NUP=2, PS_NUP=4 or PS_NUP=8) .
In order to make sure that
.Xr apsfilter 1
does not repeat n-up printing, use the
.Ic 1pps
command line option when actually printing the file.
.Pp
.Nm
only works correctly with entries in \fI@printcap@\fR that have
been created by \fB@datadir@/apsfilter/SETUP\fR. All configuration
settings will be copied from the relevant \fIapsfilterrc\fR files.
.Sh FILES
.Bl -tag -width @datadir@/apsfilter/bin/apsfilter -compact
.It Pa @printcap@
printer capability data base
.It Pa @datadir@/apsfilter/bin/apsfilter
apsfilter script
.It Pa @bindir@/aps2file
tool to save apsfilter output to a file
.Sh SEE ALSO
.Xr apsfilter 1 ,
.Xr aps2file 1 ,
.Xr apsfilter-bug 1 ,
.Xr apsfilterrc 5 ,
.Xr printcap 5
.Sh BUGS
See apsfilter software center -
.Li http://www.apsfilter.org/
- for new versions, bugfixes and known bugs.
.Pp
Please use the new tool
.Xr apsfilter-bug 1
to release bug- or problem reports. It automatically presents you a
.Nm form
in an editor window which asks you some standard questions.
If you save and quit the editor session, then this report is
sent automatically via 
.Nm e-mail
to the proper apsfilter mailinglist.
.Pp
If apsfilter fails to print something or prints it in a way
you wouldn't expect and you want to report an apsfilter error
then please save the debugging output of one print session
using the new
.Xr aps2file 1
utility by typing
.Nm aps2file -D -Z options file > /dev/null 2> file.debug
and including the debugging output in the file
.Nm file.debug
into the edit session of the
.Nm apsfilter-bug
utility, so that it is included into the mail to the apsfilter
mailinglist.
.Pp
Please note that you need to run /bin/sh (Bourne Shell), bash
or a compatible shell, so that the above mentioned output
redirection works. Under C-shell (/bin/csh) or tcsh it would't
work. If you don't know, then simply make sure you use the
Bournce shell by typing
.Nm /bin/sh
or
.Nm bash ,
then you should have no problems with redirection of
.Nm stdout
and
.Nm stderr
(> /dev/null 2> file.debug).
.Sh DOCUMENTATION
See official apsfilter homepage
.Bl -tag -width XXXXXXXXXXXXXTHIS_MUCH_SPACEXXXXXXXXXXX -compact
.It Pa http://www.apsfilter.org/handbook.html
Apsfilter Handbook including the Frequently Asked Questions (FAQ)
.Sh USER FORUM
Please send questions to the official apsfilter help channel
.Ic apsfilter-help@apsfilter.org .
The above section
.Nm BUGS
and the file
.Ic HOWTO-BUGREPORTS
tells you how to report bugs.
If you want to know how to troubleshoot your apsfilter installation,
please read the manpage
.Xr aps2file 1
and
.Xr apsfilter-bug 1
as well as the
.Ic Apsfilter Handbook
carefully.
.Sh HISTORY
The
.Nm
manpage has been written by Michael Loin <phallobst@web.de>
and first appeared in apsfilter V 7.1.0.