X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=man%2Fmime.convs.man;h=9776256bc08385b81949931c3d1819cfc90605ec;hb=345e10ca719b6a5c460f3e760f31384770e066de;hp=648c0531cd89eadfc110b8386bbc9c9c4205a1cb;hpb=9aff70cc1736fcdb2854c8ab051dcf7c7a7a3325;p=thirdparty%2Fcups.git

diff --git a/man/mime.convs.man b/man/mime.convs.man
index 648c0531c..9776256bc 100644
--- a/man/mime.convs.man
+++ b/man/mime.convs.man
@@ -1,46 +1,61 @@
 .\"
-.\" "$Id: mime.convs.man 7600 2008-05-20 21:06:23Z mike $"
+.\" mime.convs man page for CUPS.
 .\"
-.\"   mime.convs man page for the Common UNIX Printing System (CUPS).
+.\" Copyright 2007-2015 by Apple Inc.
+.\" Copyright 1997-2006 by Easy Software Products.
 .\"
-.\"   Copyright 2007-2009 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/".
 .\"
-.\"   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 mime.convs 5 "CUPS" "20 March 2006" "Apple Inc."
+.TH mime.convs 5 "CUPS" "26 August 2015" "Apple Inc."
 .SH NAME
 mime.convs \- mime type conversion file for cups
 .SH DESCRIPTION
-The \fImime.convs\fR file defines the filters that are available
-for converting files from one format to another. The standard
-filters support text, PDF, PostScript, HP-GL/2, and many types of
-image files.
+The \fBmime.convs\fR file defines the filters that are available for converting files from one format to another.
+The standard filters support text, PDF, PostScript, and many types of image files.
+.LP
+Additional filters are specified in files with the extension \fI.convs\fR in the CUPS configuration directory.
+.LP
+Each line in the \fBmime.convs\fR file is a comment, blank, or filter
+line.
+Comment lines start with the # character.
+Filter lines specify the source and destination MIME types along with a relative cost associated with the filter and the filter to run:
+.nf
+
+    source/type destination/type cost filter
+
+.fi
+The \fIsource/type\fR field specifies the source MIME media type that is consumed by the filter.
 .LP
-Additional filters can be added to the \fImime.convs\fR file or
-(preferably) to other files in the CUPS configuration directory.
+The \fIdestination/type\fR field specifies the destination MIME media type that is produced by the filter.
 .LP
-Each line in the \fImime.convs\fR file is a comment, blank, or filter
-line. Comment lines start with the # character. Filter lines specify
-the source and destination MIME types along with a relative cost
-associated with the filter and the filter to run:
+The \fIcost\fR field specifies the relative cost for running the filter.
+A value of 100 means that the filter uses a large amount of resources while a value of 0 means that the filter uses very few resources.
+.LP
+The \fIfilter\fR field specifies the filter program filename.
+Filenames are relative to the CUPS filter directory.
+.SH FILES
+\fI/etc/cups\fR - Typical CUPS configuration directory.
+.br
+\fI/usr/lib/cups/filter\fR - Typical CUPS filter directory.
 .br
+\fI/usr/libexec/cups/filter\fR - CUPS filter directory on macOS.
+.SH EXAMPLES
+Define a filter that converts PostScript documents to CUPS Raster format:
 .nf
 
-super/type super/type cost filter
-application/postscript application/vnd.cups-raster 50 pstoraster
+    application/vnd.cups\-postscript application/vnd.cups\-raster 50 pstoraster
+
 .fi
 .SH SEE ALSO
-\fIclasses.conf(5)\fR, \fIcupsd(8)\fR, \fIcupsd.conf(5)\fR,
-\fImime.types(5)\fR, \fIprinters.conf(5)\fR,
-.br
-http://localhost:631/help
+.BR cups-files.conf (5),
+.BR cupsd.conf (5),
+.BR cupsd (8),
+.BR cupsfilter (8),
+.BR mime.types (5),
+CUPS Online Help (http://localhost:631/help)
 .SH COPYRIGHT
-Copyright 2007-2009 by Apple Inc.
-.\"
-.\" End of "$Id: mime.convs.man 7600 2008-05-20 21:06:23Z mike $".
-.\"
+Copyright \[co] 2007-2017 by Apple Inc.