Skip to content

Commit

Permalink
libcupsfilters 2.0b1 Release
Browse files Browse the repository at this point in the history
  • Loading branch information
@tillkamppeter
tillkamppeter committed Nov 17, 2022
1 parent 3c88c80 commit 077f401
Show file tree
Hide file tree
Showing 3 changed files with 87 additions and 1,674 deletions.
4 changes: 2 additions & 2 deletions CHANGES.md
View file
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# CHANGES - OpenPrinting libcupsfilters v2.0b1 - 2022-11-14
# CHANGES - OpenPrinting libcupsfilters v2.0b1 - 2022-11-17

## CHANGES IN V2.0b1 (TBA)
## CHANGES IN V2.0b1 (17th November 2022)

- Introduced the filter functions concept converting filter
executables into library functions with common call scheme, moving
Expand Down
101 changes: 24 additions & 77 deletions INSTALL
View file
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
INSTALL - OpenPrinting libcupsfilters v2.0b1 - 2022-11-14
INSTALL - OpenPrinting libcupsfilters v2.0b1 - 2022-11-17
---------------------------------------------------------

This file describes how to compile and install OpenPrinting CUPS
Filters from source code. For more information on OpenPrinting CUPS
Filters see the file called "README.txt". A complete change log can
be found in "CHANGES.txt".
This file describes how to compile and install libcupsfilters from
source code. For more information on libcupsfilters see the file
called "README.md". A complete change log can be found in
"CHANGES.md".

**** IF YOU HAVE A NON-POSTSCRIPT PRINTER AND ARE NOT ****
**** IF YOU HAVE A NON-PDF PRINTER AND ARE NOT ****
**** RUNNING MAC OS X, YOU WILL ALSO NEED TO INSTALL ****
**** GHOSTSCRIPT WITH AT LEAST THE "cups", "pwgraster", ****
**** "appleraster", "urf", "pclm", "pclm8", "pdfwrite", ****
Expand All @@ -16,31 +16,28 @@ be found in "CHANGES.txt".

BEFORE YOU BEGIN

You'll need ANSI-compliant C and C++ compilers, plus a make program and
POSIX-compliant shell (/bin/sh). The GNU compiler tools and Bash work well
and we have tested the current CUPS code against several versions of GCC
with excellent results.
You'll need ANSI-compliant C and C++ compilers, plus a make
program and POSIX-compliant shell (/bin/sh). The GNU compiler
tools and Bash work well and we have tested the current CUPS code
against several versions of GCC with excellent results.

The Makefiles used by the project should work with most versions of make.
We've tested them with GNU make as well as the make programs shipped by
Compaq, HP, SGI, and Sun. BSD users should use GNU make (gmake) since BSD
make does not support "include".
The Makefiles used by the project should work with most versions
of make. We've tested them with GNU make as well as the make
programs shipped by Compaq, HP, SGI, and Sun. BSD users should
use GNU make (gmake) since BSD make does not support "include".

Poppler, freetype, fontconfig, and liblcms (liblcms2 recommended)
must be installed to be able to compile this package.
Poppler, freetype, fontconfig, liblcms (liblcms2 recommended), and
QPDF must be installed to be able to compile this package.

Note that Poppler has to be compiled with the
"--enable-poppler-cpp" configure option (or the
"libpoppler-cpp-dev(el)" package has to be installed if the
Poppler packages from a Linux distribution are used).

Besides these tools you'll want the JPEG, PNG, TIFF, ZLIB libraries for
image support. CUPS Filters will compile and run without these, however
you'll miss out on many of the features provided by CUPS Filters.

To get cups-browsed, the daemon to browse Bonjour broadcasts of
remote CUPS queues and make the queues available locally, you also
need libavahi-common and libavahi-client.
Besides these tools you'll want the JPEG, PNG, TIFF, ZLIB, and
EXIF libraries for image support. libcupsfilters will compile and
run without these, however you'll miss out on many of the features
provided by libcupsfilters.

COMPILING THE GIT REPOSITORY CODE

Expand Down Expand Up @@ -129,57 +126,7 @@ INSTALLING THE SOFTWARE

PACKAGING THE SOFTWARE FOR OPERATING SYSTEM DISTRIBUTIONS

The use of cups-filters is supported for CUPS from version 1.5.x
on (to switch to the PDF-based printing workflow already now) and
required for CUPS 1.6.x (as it does not ship a complete filter set
any more). In both cases cups-filters ships some files which exist
also in CUPS, but the versions of cups-filters have to be used to
assure that printing works correctly. So in the packaging of CUPS
the files should be removed.

Use the alternatives facility (see update-alternatives(8)) only if
your CUPS version is 1.5.x and you want to make the use of
cups-filters optional. Note that then the files of cups-filters
need to have priority.

When using cups-filters with CUPS 1.5.x, many of the original CUPS
filters get replaced or at least useless. Please remove the
following files from your CUPS package:

/usr/lib/cups/backend/serial
/usr/lib/cups/backend/parallel
/usr/lib/cups/filter/bannertops
/usr/lib/cups/filter/commandtoescpx
/usr/lib/cups/filter/commandtopclx
/usr/lib/cups/filter/imagetops
/usr/lib/cups/filter/imagetoraster
/usr/lib/cups/filter/pdftops
/usr/lib/cups/filter/rastertoescpx
/usr/lib/cups/filter/rastertopclx
/usr/lib/cups/filter/texttops
/usr/share/cups/banners/*
/usr/share/cups/data/testprint
/usr/share/cups/data/psglyphs
/usr/share/cups/fonts/*

Also comment out all conversion rules which use any of the removed
filters. You can do it with the following command line:

perl -p -i -e 's:^(.*\s+(pdftops|texttops|imagetops|bannertops|imagetoraster)\s*)$:#\1:' /usr/share/cups/mime/mime.convs

If you use CUPS 1.6.x there is less to remove from the CUPS
package. It is only bannertops and its auxiliary files which are
in the way for bannertopdf:

/usr/lib/cups/filter/bannertops
/usr/share/cups/banners/*
/usr/share/cups/data/testprint

The conversion rules get commented out via:

perl -p -i -e 's:^(.*\s+bannertops\s*)$:#\1:' /usr/share/cups/mime/mime.convs

For CUPS 1.6.x a bug report/feature request is posted to ask for
(at least optional) removal of bannertops:

http://www.cups.org/str.php?L4120
The use of libcupsfilters is supported for CUPS from version
2.2.2. For earlier CUPS versions (1.5.x, required since 1.6.x) use
cups-filters 1.x.

Loading

0 comments on commit 077f401

Please sign in to comment.