]> git.ipfire.org Git - thirdparty/cups.git/blame - man/cupsfilter.man
Merge changes from CUPS 1.4svn-r7696.
[thirdparty/cups.git] / man / cupsfilter.man
CommitLineData
bc44d920 1.\"
75bd9771 2.\" "$Id: cupsfilter.man 7600 2008-05-20 21:06:23Z mike $"
bc44d920 3.\"
4.\" cupsfilter man page for the Common UNIX Printing System (CUPS).
5.\"
6.\" Copyright 2007 by Apple Inc.
7.\"
8.\" These coded instructions, statements, and computer programs are the
9.\" property of Apple Inc. and are protected by Federal copyright
10.\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
11.\" which should have been included with this file. If this file is
12.\" file is missing or damaged, see the license at "http://www.cups.org/".
13.\"
2fb76298 14.TH cupsfilter 8 "Common UNIX Printing System" "19 October 2007" "Apple Inc."
bc44d920 15.SH NAME
16cupsfilter \- convert a file to another format using cups filters
17.SH SYNOPSIS
18.B cupsfilter
19[ -c
20.I config-file
2e4ff8af
MS
21] -j
22.I job-id[,N]
2fb76298 23[ -m
bc44d920 24.I mime/type
2fb76298 25] [ -n
bc44d920 26.I copies
27] [ -o
28.I name=value
29] [ -p
30.I filename.ppd
31] [ -t
32.I title
33]
34.I filename
35.SH DESCRIPTION
36\fIcupsfilter\fR is a front-end to the CUPS filter subsystem which allows you
37to convert a file to a specific format, just as if you had printed the file
2fb76298 38through CUPS. By default, \fIcupsfilter\fR generates a PDF file.
bc44d920 39.SH OPTIONS
40.TP 5
41-c config-file
42.br
43Uses the named cupsd.conf configuration file.
44.TP 5
2e4ff8af
MS
45-j job-id[,N]
46.br
47Converts document N from the specified job. If N is omitted, document 1 is
48converted.
49.TP 5
bc44d920 50-m mime/type
51.br
2fb76298 52Specifies the destination file type. The default file type is application/pdf.
bc44d920 53.TP 5
54-n copies
55.br
56Specifies the number of copies to generate.
57.TP 5
58-o name=value
59.br
60Specifies options to pass to the CUPS filters.
61.TP 5
62-p filename.ppd
63.br
64Specifies the PPD file to use.
65.TP 5
66-t title
67.br
68Specifies the document title.
2fb76298
MS
69.SH KNOWN ISSUES
70\fIcupsfilter\fR currently does not use the filters defined in the PPD file.
71This will be addressed in a future CUPS release.
bc44d920 72.SH SEE ALSO
73\fIcupsd.conf(5)\fR
74.br
75http://localhost:631/help
76.SH COPYRIGHT
77Copyright 2007 by Apple Inc.
78.\"
75bd9771 79.\" End of "$Id: cupsfilter.man 7600 2008-05-20 21:06:23Z mike $".
bc44d920 80.\"