Greatly simplify the man page handling.
[thirdparty/cups.git] / man / filter.7
similarity index 95%
rename from man/filter.man
rename to man/filter.7
index 9bbc497..dbc3150 100644 (file)
@@ -1,12 +1,13 @@
 .\"
 .\" filter man page for CUPS.
 .\"
-.\" Copyright 2007-2015 by Apple Inc.
-.\" Copyright 1997-2007 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-2007 by Easy Software Products.
 .\"
-.\" Licensed under Apache License v2.0.  See the file "LICENSE" for more information.
+.\" Licensed under Apache License v2.0.  See the file "LICENSE" for more
+.\" information.
 .\"
-.TH filter 7 "CUPS" "19 October 2015" "Apple Inc."
+.TH filter 7 "CUPS" "26 April 2019" "Apple Inc."
 .SH NAME
 filter \- cups file conversion filter interface
 .SH SYNOPSIS
@@ -198,6 +199,10 @@ The user executing the filter, typically "lp" or "root"; consult the \fIcups-fil
 .SH CONFORMING TO
 While the filter interface is compatible with System V interface scripts, CUPS does not support System V interface scripts.
 .SH NOTES
+CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+.BR ippeveprinter (1).
+.LP
 CUPS filters are not meant to be run directly by the user.
 Aside from the legacy System V interface issues (\fIargv[0]\fR is the printer name), CUPS filters also expect specific environment variables and file descriptors, and typically run in a user session that (on macOS) has additional restrictions that affect how it runs.
 Unless you are a developer and know what you are doing, please do not run filters directly.
@@ -213,4 +218,4 @@ program to use the appropriate filters to do the conversions you need.
 .br
 CUPS Online Help (http://localhost:631/help)
 .SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.