cups-browsed 2.0b1 Release

Author: tillkamppeter

CHANGES.md

@@ -1,6 +1,6 @@
-# CHANGES - OpenPrinting cups-browsed v2.0b1 - 2022-11-14
+# CHANGES - OpenPrinting cups-browsed v2.0b1 - 2022-11-18
 
-## CHANGES IN V2.0b1 (TBA)
+## CHANGES IN V2.0b1 (18th November 2022)
 
 - Added multi-threaded operation, the Avahi resolver callback (which
   examines the remote printer, registers it, checks whether we want a
@@ -9,15 +9,14 @@
   threads, so that these processes can get executed in parallel to
   keep the local queues up-to-date more timely and to not overload the
   system's resources.  Thanks a lot to Mohit Mohan who did this work
-  as Google Summer of Code 2020 project
-  (https://github.com/mohitmo/GSoC-2020-Documentation).
+  as
+  [Google Summer of Code 2020 project](https://github.com/mohitmo/GSoC-2020-Documentation).
 
 - Let the implicitclass backend use filter functions instead of
   calling filter executables.
 
-- Build system, README.md: Require CUPS 2.2.2+ and QPDF 10.3.2+.
-  Removed now unneeded ./configure switches for PCLm support in QPDF
-  and for use of the urftopdf filter for old CUPS versions.
+- Build system, README.md: Require CUPS 2.2.2+. Removed now unneeded
+  ./configure switches for old CUPS versions.
 
 - Build system: Remove '-D_PPD_DEPRECATED=""' from the compiling
   command lines of the source files which use libcups. The flag is not

INSTALL

@@ -1,18 +1,10 @@
-INSTALL - OpenPrinting cups-browsed v2.0b1 - 2022-11-14
+INSTALL - OpenPrinting cups-browsed v2.0b1 - 2022-11-18
 -------------------------------------------------------
 
-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".
-
-**** IF YOU HAVE A NON-POSTSCRIPT 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",     ****
-**** "pdfimage24", "pdfimage32", "pdfimage8" DRIVERS AFTER  ****
-**** YOU INSTALL CUPS AND BEFORE YOU INSTALL THIS PACKAGE.  ****
-
+This file describes how to compile and install OpenPrinting
+cups-browsed from source code. For more information on cups-browsed
+see the file called "README.md". A complete change log can be found
+in "CHANGES.md".
 
 BEFORE YOU BEGIN
 
@@ -26,25 +18,13 @@ BEFORE YOU BEGIN
     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.
-
-    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.
+    libcups (of CUPS 2.2.2 or newer), libcupsfilters 2.x, libppd,
+    libavahi-common, libavahi-client, libdbus, and glib must be
+    installed to be able to compile this package.
 
 COMPILING THE GIT REPOSITORY CODE
 
-    The CUPS Filters GIT repository doesn't hold a copy of the pre-built
+    The cups-browsed GIT repository doesn't hold a copy of the pre-built
     configure script.  You'll need to run the GNU autoconf software (2.65 or
     higher) to create it:
 
@@ -53,29 +33,16 @@ COMPILING THE GIT REPOSITORY CODE
 
 CONFIGURATION
 
-    CUPS Filters uses GNU autoconf, so you should find the usual "configure"
-    script in the main CUPS Filters source directory.  To configure CUPS 
-    Filters for your system, type:
+    cups-browsed uses GNU autoconf, so you should find the usual
+    "configure" script in the main cups-browsed source directory.  To
+    configure cups-browsed for your system, type:
 
 	./configure
 
-    The default installation will put the CUPS Filters software in the
-    "/etc" and "/usr" directories on your system, which will overwrite
-    some of the original filters and their auxiliary files of CUPS
-    1.5.x or earlier and the auxiliary files of bannertops in all CUPS
-    versions including version 1.6.x (see also the section "PACKAGING
-    THE SOFTWARE FOR OPERATING SYSTEM DISTRIBUTIONS" below). The
-    system will still have the same functionality as before, but CUPS
-    will not convert all incoming files into PostScript any more, it
-    will convert them into PDF instead and after applying page
-    management (N-up, selected pages, reverse order, ...) by the
-    pdftopdf filter and convert PDF into the printer's native format
-    then (PDF-based printing workflow). CUPS 1.6.x or later does not
-    contain any filters which this package provides. It requires the
-    installation of this package for printing with filters and drivers
-    under Linux (or other non-Mac-OS-X operation systems).
-
-    Use the "--prefix" option to install the CUPS Filters software in another
+    The default installation will put the cups-browsed software in the
+    "/etc" and "/usr" directories on your system.
+
+    Use the "--prefix" option to install the cups-browsed software in another
     location:
 
 	./configure --prefix=/some/directory
@@ -129,57 +96,21 @@ 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
+    cups-browsed is mainly needed and actually used to auto-create
+    local print queues for auto-discovered IPP print services (remote
+    CUPS printers, IPP network printers, IPP-over-USB printers,
+    Printer Applications) so that they also get listed by print
+    dialogs which do not support CUPS' concept of auto-creating
+    temporary print queues on-demand for these services.
+
+    So OS distribution maintainers should check the print dialogs
+    (GTK, Qt, application-specific) whether they list all printers,
+    including above-mentioned IPP services without running
+    cups-browsed and without manual creation of local print
+    queues. only if printers are missing, cups-browsed is needed. It
+    should be built with the `./configure` option
+    `--enable-auto-setup-driverless-only` then.
+
+    Otherwise cups-browsed is only needed for more advanced setups,
+    like printer clusters or support for legacy CUPS (< 1.6.x) on
+    remote servers or clients.