From 9b58d35185905f8334142bf4988cb784e993aea7 Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Mon, 21 Nov 2011 02:23:03 -0600 Subject: Initial import of extracted KDE i18n tarballs --- tde-i18n-en_GB/docs/kdebase/kdeprint/Makefile.am | 4 + tde-i18n-en_GB/docs/kdebase/kdeprint/Makefile.in | 635 +++++ .../docs/kdebase/kdeprint/add-printer-wiz.docbook | 344 +++ .../docs/kdebase/kdeprint/cups-config.docbook | 2993 ++++++++++++++++++++ .../docs/kdebase/kdeprint/cupsoptions.docbook | 898 ++++++ .../docs/kdebase/kdeprint/extensions.docbook | 89 + .../docs/kdebase/kdeprint/external-command.docbook | 27 + .../docs/kdebase/kdeprint/final-word.docbook | 92 + .../docs/kdebase/kdeprint/getting-started.docbook | 187 ++ .../docs/kdebase/kdeprint/highlights.docbook | 695 +++++ .../docs/kdebase/kdeprint/index.cache.bz2 | Bin 0 -> 44562 bytes tde-i18n-en_GB/docs/kdebase/kdeprint/index.docbook | 269 ++ tde-i18n-en_GB/docs/kdebase/kdeprint/lpd.docbook | 27 + .../docs/kdebase/kdeprint/lpr-bsd.docbook | 37 + tde-i18n-en_GB/docs/kdebase/kdeprint/lprng.docbook | 12 + tde-i18n-en_GB/docs/kdebase/kdeprint/rlpr.docbook | 24 + .../docs/kdebase/kdeprint/tech-overview.docbook | 346 +++ .../docs/kdebase/kdeprint/theory.docbook | 688 +++++ 18 files changed, 7367 insertions(+) create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/Makefile.am create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/Makefile.in create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/add-printer-wiz.docbook create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/cups-config.docbook create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/cupsoptions.docbook create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/extensions.docbook create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/external-command.docbook create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/final-word.docbook create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/getting-started.docbook create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/highlights.docbook create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/index.cache.bz2 create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/index.docbook create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/lpd.docbook create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/lpr-bsd.docbook create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/lprng.docbook create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/rlpr.docbook create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/tech-overview.docbook create mode 100644 tde-i18n-en_GB/docs/kdebase/kdeprint/theory.docbook (limited to 'tde-i18n-en_GB/docs/kdebase/kdeprint') diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/Makefile.am b/tde-i18n-en_GB/docs/kdebase/kdeprint/Makefile.am new file mode 100644 index 00000000000..b93906d5126 --- /dev/null +++ b/tde-i18n-en_GB/docs/kdebase/kdeprint/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = en_GB +SUBDIRS = $(AUTODIRS) +KDE_DOCS = kdeprint +KDE_MANS = AUTO diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/Makefile.in b/tde-i18n-en_GB/docs/kdebase/kdeprint/Makefile.in new file mode 100644 index 00000000000..10eec897e86 --- /dev/null +++ b/tde-i18n-en_GB/docs/kdebase/kdeprint/Makefile.in @@ -0,0 +1,635 @@ +# Makefile.in generated by automake 1.10.1 from Makefile.am. +# KDE tags expanded automatically by am_edit - $Revision: 483858 $ +# @configure_input@ + +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, +# 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ +VPATH = @srcdir@ +pkgdatadir = $(datadir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +subdir = docs/kdebase/kdeprint +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/acinclude.m4 \ + $(top_srcdir)/configure.in +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = +SOURCES = +DIST_SOURCES = +#>- RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \ +#>- html-recursive info-recursive install-data-recursive \ +#>- install-dvi-recursive install-exec-recursive \ +#>- install-html-recursive install-info-recursive \ +#>- install-pdf-recursive install-ps-recursive install-recursive \ +#>- installcheck-recursive installdirs-recursive pdf-recursive \ +#>- ps-recursive uninstall-recursive +#>+ 7 +RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \ + html-recursive info-recursive install-data-recursive \ + install-dvi-recursive install-exec-recursive \ + install-html-recursive install-info-recursive \ + install-pdf-recursive install-ps-recursive install-recursive \ + installcheck-recursive installdirs-recursive pdf-recursive \ + ps-recursive uninstall-recursive nmcheck-recursive bcheck-recursive +RECURSIVE_CLEAN_TARGETS = mostlyclean-recursive clean-recursive \ + distclean-recursive maintainer-clean-recursive +ETAGS = etags +CTAGS = ctags +DIST_SUBDIRS = $(SUBDIRS) +#>- DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +#>+ 1 +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) $(KDE_DIST) +ACLOCAL = @ACLOCAL@ +AMTAR = @AMTAR@ +ARTSCCONFIG = @ARTSCCONFIG@ +AUTOCONF = @AUTOCONF@ +AUTODIRS = @AUTODIRS@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CONF_FILES = @CONF_FILES@ +CYGPATH_W = @CYGPATH_W@ +DCOPIDL = @DCOPIDL@ +DCOPIDL2CPP = @DCOPIDL2CPP@ +DCOPIDLNG = @DCOPIDLNG@ +DCOP_DEPENDENCIES = @DCOP_DEPENDENCIES@ +DEFS = @DEFS@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +GMSGFMT = @GMSGFMT@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +KCFG_DEPENDENCIES = @KCFG_DEPENDENCIES@ +KCONFIG_COMPILER = @KCONFIG_COMPILER@ +KDECONFIG = @KDECONFIG@ +KDE_EXTRA_RPATH = @KDE_EXTRA_RPATH@ +KDE_RPATH = @KDE_RPATH@ +KDE_XSL_STYLESHEET = @KDE_XSL_STYLESHEET@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LN_S = @LN_S@ +LTLIBOBJS = @LTLIBOBJS@ +MAKEINFO = @MAKEINFO@ +MAKEKDEWIDGETS = @MAKEKDEWIDGETS@ +MCOPIDL = @MCOPIDL@ +MEINPROC = @MEINPROC@ +MKDIR_P = @MKDIR_P@ +MSGFMT = @MSGFMT@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +TOPSUBDIRS = @TOPSUBDIRS@ +VERSION = @VERSION@ +XGETTEXT = @XGETTEXT@ +XMLLINT = @XMLLINT@ +X_RPATH = @X_RPATH@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +am__leading_dot = @am__leading_dot@ +am__tar = @am__tar@ +am__untar = @am__untar@ +#>- bindir = @bindir@ +#>+ 2 +DEPDIR = .deps +bindir = @bindir@ +build_alias = @build_alias@ +builddir = @builddir@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +host_alias = @host_alias@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +kde_appsdir = @kde_appsdir@ +kde_bindir = @kde_bindir@ +kde_confdir = @kde_confdir@ +kde_datadir = @kde_datadir@ +kde_htmldir = @kde_htmldir@ +kde_icondir = @kde_icondir@ +kde_kcfgdir = @kde_kcfgdir@ +kde_libs_htmldir = @kde_libs_htmldir@ +kde_libs_prefix = @kde_libs_prefix@ +kde_locale = @kde_locale@ +kde_mimedir = @kde_mimedir@ +kde_moduledir = @kde_moduledir@ +kde_servicesdir = @kde_servicesdir@ +kde_servicetypesdir = @kde_servicetypesdir@ +kde_sounddir = @kde_sounddir@ +kde_styledir = @kde_styledir@ +kde_templatesdir = @kde_templatesdir@ +kde_wallpaperdir = @kde_wallpaperdir@ +kde_widgetdir = @kde_widgetdir@ +kdeinitdir = @kdeinitdir@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ +xdg_appsdir = @xdg_appsdir@ +xdg_directorydir = @xdg_directorydir@ +xdg_menudir = @xdg_menudir@ +KDE_LANG = en_GB +#>- SUBDIRS = $(AUTODIRS) +#>+ 1 +SUBDIRS =. +KDE_DOCS = kdeprint +KDE_MANS = AUTO +#>- all: all-recursive +#>+ 1 +all: docs-am all-recursive + +.SUFFIXES: +$(srcdir)/Makefile.in: $(srcdir)/Makefile.am $(am__configure_deps) +#>- @for dep in $?; do \ +#>- case '$(am__configure_deps)' in \ +#>- *$$dep*) \ +#>- cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ +#>- && exit 0; \ +#>- exit 1;; \ +#>- esac; \ +#>- done; \ +#>- echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/kdebase/kdeprint/Makefile'; \ +#>- cd $(top_srcdir) && \ +#>- $(AUTOMAKE) --gnu docs/kdebase/kdeprint/Makefile +#>+ 12 + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ + && exit 0; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/kdebase/kdeprint/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu docs/kdebase/kdeprint/Makefile + cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/kdebase/kdeprint/Makefile.in +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +# This directory's subdirectories are mostly independent; you can cd +# into them and run `make' without going through this Makefile. +# To change the values of `make' variables: instead of editing Makefiles, +# (1) if the variable is set in `config.status', edit `config.status' +# (which will cause the Makefiles to be regenerated when you run `make'); +# (2) otherwise, pass the desired values on the `make' command line. +$(RECURSIVE_TARGETS): + @failcom='exit 1'; \ + for f in x $$MAKEFLAGS; do \ + case $$f in \ + *=* | --[!k]*);; \ + *k*) failcom='fail=yes';; \ + esac; \ + done; \ + dot_seen=no; \ + target=`echo $@ | sed s/-recursive//`; \ + list='$(SUBDIRS)'; for subdir in $$list; do \ + echo "Making $$target in $$subdir"; \ + if test "$$subdir" = "."; then \ + dot_seen=yes; \ + local_target="$$target-am"; \ + else \ + local_target="$$target"; \ + fi; \ + (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ + || eval $$failcom; \ + done; \ + if test "$$dot_seen" = "no"; then \ + $(MAKE) $(AM_MAKEFLAGS) "$$target-am" || exit 1; \ + fi; test -z "$$fail" + +$(RECURSIVE_CLEAN_TARGETS): + @failcom='exit 1'; \ + for f in x $$MAKEFLAGS; do \ + case $$f in \ + *=* | --[!k]*);; \ + *k*) failcom='fail=yes';; \ + esac; \ + done; \ + dot_seen=no; \ + case "$@" in \ + distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \ + *) list='$(SUBDIRS)' ;; \ + esac; \ + rev=''; for subdir in $$list; do \ + if test "$$subdir" = "."; then :; else \ + rev="$$subdir $$rev"; \ + fi; \ + done; \ + rev="$$rev ."; \ + target=`echo $@ | sed s/-recursive//`; \ + for subdir in $$rev; do \ + echo "Making $$target in $$subdir"; \ + if test "$$subdir" = "."; then \ + local_target="$$target-am"; \ + else \ + local_target="$$target"; \ + fi; \ + (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ + || eval $$failcom; \ + done && test -z "$$fail" +tags-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \ + done +ctags-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) ctags); \ + done + +ID: $(HEADERS) $(SOURCES) $(LISP) $(TAGS_FILES) + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) '{ files[$$0] = 1; nonemtpy = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + mkid -fID $$unique +tags: TAGS + +TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ + $(TAGS_FILES) $(LISP) + tags=; \ + here=`pwd`; \ + if ($(ETAGS) --etags-include --version) >/dev/null 2>&1; then \ + include_option=--etags-include; \ + empty_fix=.; \ + else \ + include_option=--include; \ + empty_fix=; \ + fi; \ + list='$(SUBDIRS)'; for subdir in $$list; do \ + if test "$$subdir" = .; then :; else \ + test ! -f $$subdir/TAGS || \ + tags="$$tags $$include_option=$$here/$$subdir/TAGS"; \ + fi; \ + done; \ + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + if test -z "$(ETAGS_ARGS)$$tags$$unique"; then :; else \ + test -n "$$unique" || unique=$$empty_fix; \ + $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ + $$tags $$unique; \ + fi +ctags: CTAGS +CTAGS: ctags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ + $(TAGS_FILES) $(LISP) + tags=; \ + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + test -z "$(CTAGS_ARGS)$$tags$$unique" \ + || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \ + $$tags $$unique + +GTAGS: + here=`$(am__cd) $(top_builddir) && pwd` \ + && cd $(top_srcdir) \ + && gtags -i $(GTAGS_ARGS) $$here + +distclean-tags: + -rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags + +#>- distdir: $(DISTFILES) +#>+ 1 +distdir: distdir-nls $(DISTFILES) + @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + list='$(DISTFILES)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ + fi; \ + cp -pR $$d/$$file $(distdir)$$dir || exit 1; \ + else \ + test -f $(distdir)/$$file \ + || cp -p $$d/$$file $(distdir)/$$file \ + || exit 1; \ + fi; \ + done + list='$(DIST_SUBDIRS)'; for subdir in $$list; do \ + if test "$$subdir" = .; then :; else \ + test -d "$(distdir)/$$subdir" \ + || $(MKDIR_P) "$(distdir)/$$subdir" \ + || exit 1; \ + distdir=`$(am__cd) $(distdir) && pwd`; \ + top_distdir=`$(am__cd) $(top_distdir) && pwd`; \ + (cd $$subdir && \ + $(MAKE) $(AM_MAKEFLAGS) \ + top_distdir="$$top_distdir" \ + distdir="$$distdir/$$subdir" \ + am__remove_distdir=: \ + am__skip_length_check=: \ + distdir) \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-recursive +all-am: Makefile +installdirs: installdirs-recursive +installdirs-am: +install: install-recursive +install-exec: install-exec-recursive +install-data: install-data-recursive +#>- uninstall: uninstall-recursive +#>+ 1 +uninstall: uninstall-docs uninstall-nls uninstall-recursive + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-recursive +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +#>- clean: clean-recursive +#>+ 1 +clean: kde-rpo-clean clean-recursive + +#>- clean-am: clean-generic mostlyclean-am +#>+ 1 +clean-am: clean-docs clean-bcheck clean-generic mostlyclean-am + +distclean: distclean-recursive + -rm -f Makefile +distclean-am: clean-am distclean-generic distclean-tags + +dvi: dvi-recursive + +dvi-am: + +html: html-recursive + +info: info-recursive + +info-am: + +#>- install-data-am: +#>+ 1 +install-data-am: install-docs install-nls + +install-dvi: install-dvi-recursive + +install-exec-am: + +install-html: install-html-recursive + +install-info: install-info-recursive + +install-man: + +install-pdf: install-pdf-recursive + +install-ps: install-ps-recursive + +installcheck-am: + +maintainer-clean: maintainer-clean-recursive + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-recursive + +mostlyclean-am: mostlyclean-generic + +pdf: pdf-recursive + +pdf-am: + +ps: ps-recursive + +ps-am: + +uninstall-am: + +.MAKE: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) install-am \ + install-strip + +.PHONY: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) CTAGS GTAGS \ + all all-am check check-am clean clean-generic ctags \ + ctags-recursive distclean distclean-generic distclean-tags \ + distdir dvi dvi-am html html-am info info-am install \ + install-am install-data install-data-am install-dvi \ + install-dvi-am install-exec install-exec-am install-html \ + install-html-am install-info install-info-am install-man \ + install-pdf install-pdf-am install-ps install-ps-am \ + install-strip installcheck installcheck-am installdirs \ + installdirs-am maintainer-clean maintainer-clean-generic \ + mostlyclean mostlyclean-generic pdf pdf-am ps ps-am tags \ + tags-recursive uninstall uninstall-am + +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: + +#>+ 2 +KDE_DIST=lpr-bsd.docbook Makefile.in tech-overview.docbook cups-config.docbook highlights.docbook add-printer-wiz.docbook rlpr.docbook lprng.docbook index.docbook lpd.docbook cupsoptions.docbook theory.docbook final-word.docbook Makefile.am extensions.docbook external-command.docbook getting-started.docbook index.cache.bz2 + +#>+ 24 +index.cache.bz2: $(srcdir)/index.docbook $(KDE_XSL_STYLESHEET) extensions.docbook tech-overview.docbook highlights.docbook add-printer-wiz.docbook lpd.docbook lpr-bsd.docbook external-command.docbook cups-config.docbook index.docbook rlpr.docbook cupsoptions.docbook final-word.docbook lprng.docbook theory.docbook getting-started.docbook + @if test -n "$(MEINPROC)"; then echo $(MEINPROC) --check --cache index.cache.bz2 $(srcdir)/index.docbook; $(MEINPROC) --check --cache index.cache.bz2 $(srcdir)/index.docbook; fi + +docs-am: index.cache.bz2 + +install-docs: docs-am install-nls + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kdeprint + @if test -f index.cache.bz2; then \ + echo $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kdeprint/; \ + $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kdeprint/; \ + elif test -f $(srcdir)/index.cache.bz2; then \ + echo $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kdeprint/; \ + $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kdeprint/; \ + fi + -rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kdeprint/common + $(LN_S) $(kde_libs_htmldir)/$(KDE_LANG)/common $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kdeprint/common + +uninstall-docs: + -rm -rf $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kdeprint + +clean-docs: + -rm -f index.cache.bz2 + + +#>+ 13 +install-nls: + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kdeprint + @for base in extensions.docbook tech-overview.docbook highlights.docbook add-printer-wiz.docbook lpd.docbook lpr-bsd.docbook external-command.docbook cups-config.docbook index.docbook rlpr.docbook cupsoptions.docbook final-word.docbook lprng.docbook theory.docbook getting-started.docbook ; do \ + echo $(INSTALL_DATA) $$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kdeprint/$$base ;\ + $(INSTALL_DATA) $(srcdir)/$$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kdeprint/$$base ;\ + done + +uninstall-nls: + for base in extensions.docbook tech-overview.docbook highlights.docbook add-printer-wiz.docbook lpd.docbook lpr-bsd.docbook external-command.docbook cups-config.docbook index.docbook rlpr.docbook cupsoptions.docbook final-word.docbook lprng.docbook theory.docbook getting-started.docbook ; do \ + rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kdeprint/$$base ;\ + done + + +#>+ 5 +distdir-nls: + for file in extensions.docbook tech-overview.docbook highlights.docbook add-printer-wiz.docbook lpd.docbook lpr-bsd.docbook external-command.docbook cups-config.docbook index.docbook rlpr.docbook cupsoptions.docbook final-word.docbook lprng.docbook theory.docbook getting-started.docbook ; do \ + cp $(srcdir)/$$file $(distdir); \ + done + +#>+ 15 +force-reedit: + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ + && exit 0; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/kdebase/kdeprint/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu docs/kdebase/kdeprint/Makefile + cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/kdebase/kdeprint/Makefile.in + + +#>+ 21 +clean-bcheck: + rm -f *.bchecktest.cc *.bchecktest.cc.class a.out + +bcheck: bcheck-recursive + +bcheck-am: + @for i in ; do \ + if test $(srcdir)/$$i -nt $$i.bchecktest.cc; then \ + echo "int main() {return 0;}" > $$i.bchecktest.cc ; \ + echo "#include \"$$i\"" >> $$i.bchecktest.cc ; \ + echo "$$i"; \ + if ! $(CXX) $(DEFS) -I. -I$(srcdir) -I$(top_builddir) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(KDE_CXXFLAGS) --dump-class-hierarchy -c $$i.bchecktest.cc; then \ + rm -f $$i.bchecktest.cc; exit 1; \ + fi ; \ + echo "" >> $$i.bchecktest.cc.class; \ + perl $(top_srcdir)/admin/bcheck.pl $$i.bchecktest.cc.class || { rm -f $$i.bchecktest.cc; exit 1; }; \ + rm -f a.out; \ + fi ; \ + done + + +#>+ 3 +final: + $(MAKE) all-am + +#>+ 3 +final-install: + $(MAKE) install-am + +#>+ 3 +no-final: + $(MAKE) all-am + +#>+ 3 +no-final-install: + $(MAKE) install-am + +#>+ 3 +kde-rpo-clean: + -rm -f *.rpo + +#>+ 3 +nmcheck: +nmcheck-am: nmcheck diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/add-printer-wiz.docbook b/tde-i18n-en_GB/docs/kdebase/kdeprint/add-printer-wiz.docbook new file mode 100644 index 00000000000..5124dddaa9a --- /dev/null +++ b/tde-i18n-en_GB/docs/kdebase/kdeprint/add-printer-wiz.docbook @@ -0,0 +1,344 @@ + +The <quote +>Add Printer Wizard</quote +> for &CUPS; + +Clicking on the leftmost icon on the toolbar in the upper part of the window starts the Add Printer Wizard. + +This wizard steps you through various screens to install a new printer. At present this Wizard works for &CUPS; and the RLPR environment module. The number of steps depend on the actual print-subsystem which is active and available to you on your box. + + +Starting + +The welcome screen informs you that you can go back any time to change a setting. + + +The &kdeprint; wizard introduction screen + + + + +The introduction screen of the printer wizard + + + + + +Backend Selection + +Choose the backend protocol that &CUPS; is supposed to use with your new printer. There are: + + + +local printer (serial, parallel, USB) + + +remote LPD queue + + +SMB shared printer (&Windows;) + + +Network Printer (TCP, &HP; JetDirect, AppSocket) + + +Network printer with &IPP; (&IPP;/HTTP) + + +File printer + + +serial fax /modem printer + + +Class of Printers + + + +If some choices are greyed out, they are not available. For example, you may have no FAX backend software or no modem installed to use it. + + +Choosing your Printer system + + + + +Choosing your Printer System + + + + + + +Direct Network Setting + +The contents of your next screen is dependent on your choice in the previous screen. If you know the details, just type them in to configure your network settings directly. + +In other cases the wizard can scan the network for you, to help you decide which setting could be useful. + + +&kdeprint; wizard network scan + + + + +In the &kdeprint; wizard, you can enter network details directly, or you can scan the network automatically. + + + + + +Information Retrieval by Scanning the Network + +If you use one of the network connections (remote LPD, SMB, remote &CUPS;, network printer with &IPP;), you have an option for scanning the network. Be careful when applying this; in some environments network scanning is considered to be hostile and harmful! + +In the case of SMB, &kdeprint; will use the Samba utilities nmblookup and smbclient (which need to be installed for this to work) to retrieve the information it presents in a tree structure. + +In the case of &IPP; (Port 631) and TCP Network/AppSocket (Port 9100) &kdeprint; will try to open the port and, if successful, send an ipp-get-printer-attribute request to the printer. For newer &HP; printers the latter usually works, because they support both AppSocket and &IPP;. + +Some printers or manufacturers use other port numbers for direct TCP/IP printing. You may need to look up which one to use. The Settings button in the dialogue lets you configure your scan, including IP addresses, ports and timeout to use. + +Once again: be careful not to be mistaken for an intruder on your network, if you use the scanning technique. + + +&kdeprint; wizard network configuration dialogue + + + + +In the &kdeprint; wizard, you can enter parameters to have the wizard scan parts of your network. + + + + + +Printer Model Selection + +The hardest part is probably the Printer Model Selection. In former years the situation was difficult, because there were hardly any drivers to find. The difficulty now is there are too many; though some of them are very good, many are quite broken. + +If you have a current database of available drivers on your system, select the manufacturer in the left part of the window first, then the device model in the right part. This split window shows all &PPD;s found by &CUPS; in its standard repository of installable &PPD;s. This repository normally is /usr/share/cups/model/. If you want your driver to be found automatically by &CUPS; and &kdeprint;, place it in there. + + + + + + +Driver Selection + +On the next screen you will see a description of the driver selected previously. This description is extracted from the actual &PPD; used. + + +For a real &PostScript; printer never try to install a Foomatic or Gimp-Print &PPD;, even if it is offered. You won't be happy with it. Instead find the original &PPD; from the manufacturer, preferably the one written for &Windows; NT and use it. + + +Some &Linux; distributions have supplied for &CUPS; every possible combination of Ghostscript filters and foomatic &PPD; files they could find on the net. Many of these are quite useless; they were generated a year ago, when the people at www.linuxprinting.org began their first experiments with supplying third party &PPD;s for &CUPS;. Although dubbed Alpha at the time, these started to take on a life of their own and can now be found at various places on the net, doing &CUPS; no favours. + +If you are not sure which ones to use go to: + + + +http://www.linuxprinting.org + + + + + +http://www.cups.org + + + + +And ask for help. At a later stage, a document detailing the differences between the different driver and &PPD; models will appear at http://kdeprint.sourceforge.net/ Watch out for this! + +Via the Other... button you are able to retrieve any &PPD; located somewhere on your available file system. + + + + + +Printer Test and Finding the Right Settings + +Specify your first driver settings now. The most important one is the default paper size. In many cases this is set to Letter. If you live in an A4 country and don't want your first test page to jam: now is the time to prevent this. + +You are ready to start a test print. Hit the Test button. + + + + + + + + +Finally: Baptising Your New Printer + +The last screen lets you insert a name for your new printer. + +The name must start with a letter and may contain numbers and underscores with a maximum size of 128 characters. Conform to this if you want to avoid erratic behaviour of your &CUPS; daemon. The printer names in &CUPS; are not case sensitive! This is a requirement of &IPP;. So the names DANKA_infotec, Danka_Infotec and danka_infotec all represent the same printer. + + + + + + +The Final Confirmation Screen + + + + + + + + diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/cups-config.docbook b/tde-i18n-en_GB/docs/kdebase/kdeprint/cups-config.docbook new file mode 100644 index 00000000000..419111a86dd --- /dev/null +++ b/tde-i18n-en_GB/docs/kdebase/kdeprint/cups-config.docbook @@ -0,0 +1,2993 @@ + +Print Server Configuration: CUPS + +Start the print server configuration (now that you have chosen &CUPS;, this is equivalent to the configuration of the &CUPS; daemon) by clicking on the appropriate button. You can find it by moving the mouse slowly over the buttons and reading the tooltips. It should be the 11th from the left , or third from the right; its icon is a wrench. + +The &CUPS; Server Configuration window pops up. It gives you a structured view of all the settings that apply to the &CUPS; daemon. The configuration file for that daemon is normally located in /etc/cups/cupsd.conf. This is a plain ASCII file with a syntax similar to the configuration file of the Apache web server. It is a good idea to create a backup copy, just in case something goes wrong with the configuration through &kdeprint;/&CUPS; Server Configuration dialogues: + +cp /etc/cups/cupsd.conf /etc/cups/cupsd.conf.bak + +As this graphical user interface to edit the configuration file is such a new feature, you should have the second chance of resorting to the original file. So back it up, please. + + +Quick Help + +One very nice feature is the Quick Help available. If you click on the little question mark (What's this?) on your window title bar, you'll see the cursor changing its form. Now click on a cupsd configuration setting field to find out what it means and what your options are. In most cases you should understand the meaning immediately, otherwise turn to the excellent &CUPS; documentation. (If your &CUPS; Daemon is running, you have it online on your own host at http://localhost:631/documentation.html. +If &CUPS; is not running, but installed on your system you could find it in your own host's file system. The exact location depends on your &OS;, but on &Linux; the default is /usr/share/doc/cups/ or /usr/share/doc/cups/documentation.html. + + + +Longer Help + +For the best, most detailed and most recent information you should always refer to the original &CUPS; documentation. &CUPS; is, much like &kde; in a rapid development process. There are constantly new features being added. New features might for times be only configurable by directly editing the configuration files. The &kdeprint; &GUI; might not have caught up with &CUPS; development. + +Just in case you want to look at the original configuration files of your &CUPS; system -- they are here: + + +These paths are based on the default installation. Your &OS; may have installed them to a different prefix, for example, /usr/local/, but the hierarchy should still match that shown below. + + + + +/etc/cups/ + +The folder with the configuration files + + + + +/etc/cups/cupsd.conf + +The configuration file for the &CUPS; daemon + + + + +/etc/cups/printers.conf + +The configuration file that contains the information about your locally installed printers. + + + + +/etc/cups/ppd/ + +The folder with &PPD; files of your installed printers. + + + + +The following links only work if your &CUPS; daemon is up and running. To access all the original &CUPS; documentation, go to: + + + +http://localhost:631/documentation.html + +A page with all the links to the other documents. + + + + +http://localhost:631/sam.html + +Direct access to the &CUPS; Software Administrator Manual in HTML format. + + + + +http://localhost:631/sam.pdf + +Direct access to the &CUPS; Software Administrator Manual in PDF format. + + + + +http://www.cups.org/documentation.html + +The latest on line documentation from the &CUPS; web site. + + + +The following links give you access to the same files (probably icons and graphics will be missing) even if your CUPS daemon is not up and running. You need, however, CUPS installed on your system. (Some distributions might place the files somewhere else -- you're on your own then to find out where...) To access all the original CUPS documentation, go to: + +This documentation is available even when the &CUPS; daemon is not installed, although you may find images and icons are missing when you view the HTML files. + +As noted above, the hierarchy below should be intact, but your &OS; may have installed &CUPS; to a different location. + + + +/usr/share/doc/cups/documentation.html + +A page with all the links to the other documents. + + + + +/usr/share/doc/cups/sam.html + +Direct access to the &CUPS; Software Administrator Manual in HTML format. + + + + +/usr/share/doc/cups/sam.pdf + +Direct access to the &CUPS; Software Administrator Manual in PDF format. + + + + +There are a few WebSites and Newsgroups discussing &CUPS; (and &Linux; Printing in General) and giving help to newbies at: + + + +http://www.cups.org/newsgroups.php + +The &CUPS; website. + + + + +http://www.linuxprinting.org/newsportal/ + +LinuxPrinting.org, the home of the Linuxprinting HOWTO and the &Linux; Printer Database + + + + +And finally, there will be a WebSite for &kdeprint; and related documentation, at http://kdeprint.sourceforge.net/ + +In the next section I will step you through most of the configuration options of &kdeprint; with &CUPS;. + + + +Explaining different elements of the &GUI; + + +Upper Window: View on Printers, both Real and Virtual + +This section is not yet complete + + + +Tree view, icon view and list view + + +The icons of the task bar + + +Different fonts for different printers + + +Different printer icons mean different things + + + + + + +Lower Window: Tabbed View of Details + +This section is not yet complete. + + + +The icons of the task bar + + +The Tabs + + +Changing printer settings + + + + + + + + + +Welcome to the &CUPS; Server Configuration + +This is the Welcome Screen for your server configuration dialogues. Clicking onto one of the items of the tree view on left side of the screen opens the appropriate part of the configuration settings. + +Every setting has a default value. The defaults let &CUPS; normally work as a fully functional client. The clients listen on TCP/IP Port 631 for infos broadcast by &CUPS; servers on the LAN. This information let the clients print immediately after receiving them, without installing any driver or configuring any printer on the clients. + +To configure a &CUPS; server (which is broadcasting its service to the LAN) you need to change settings from the defaults. + +The dialogue to configure the &CUPS; server: welcome screen. + +CUPS server configuration dialogue: welcome screen + + + + +The dialogue to configure the &CUPS; server: welcome screen +The dialogue to configure the &CUPS; server: welcome screen + + + +To select the default setting of any item just enable the checkbox on the right side of the screen. To set an item to a different value, disable the checkbox and then go on to do the setting you want on the left side of the screen. + +The complete server configuration includes: + + + +Server General Configuration + + +Server Logging Configuration + + +Server Folders and Path Definitions + + +Server HTTP Configuration + + +Server Encryption and Certificate Support Configuration + + +Server Miscellaneous Configuration + + +Network General Configuration + + +Network Clients Configuration + + +Browsing General Configuration + + +Browsing Connection Configuration + + +Browsing Masks Configuration + + +Browsing Timeouts Configuration + + +Browsing Relay Configuration + + +Security Configuration + + + +Each of these configuration items will be described in the following sections of the manual. + + + + +Server General Configuration + +The server general configuration is done on this screen. It includes: + + +Server name +Administrator's email +Server user +Server group +Remote user name + + +The tab window to configure the &CUPS; server general settings lets you the change the default values. Click on the little question mark and then on one of the fields to get a Quick Help about the meaning of the setting. + +If you are unsure, leave alone and turn to the original &CUPS; documentation first. If your &CUPS; daemon is already running, it is readable from the &konqueror; by pointing it to &URL; http://localhost:631/documentation.html. + +There, first make friends with the Software Administrator Manual. Otherwise, for example, if the &CUPS; daemon is not running, try looking in your local file system, by default at /usr/share/doc/cups/ or /usr/share/doc/cups/documentation.html. + + +&CUPS; server general configuration dialogue: ServerName, AdminMail, ServerUser, ServerGroup, RemoteUserName + + + + +The dialogue to configure the &CUPS; server general settings: ServerName, AdminMail, ServerUser, ServerGroup, RemoteUserName + + + + + +Server Name + +The hostname of your server, as advertised to the world. By default, &CUPS; will use the hostname of the system. To set the default server usd by clients, see the client.conf file. + + +For example, enter myhost.domain.com + + +This is the hostname that is reported to clients. Should you ever encounter strange problems in accessing the server, put here its IP address for troubleshooting. This way you eliminate any potential name resolution problems; and you can more easily nail the real problem down. + + + + +Administrator's email + +This is the email address to send all complaints or problems to. By default &CUPS; will use root@hostname. + + +For example, enter root@myhost.com. + + + +Contrary to what the quickhelp suggests, it is also legal to send an email full of praise and enthusiasm about &CUPS; and &kdeprint; to the server administrator. + + + + + +Server User + +The user the server runs under. Normally this must be lp, however you can configure things for another user if needed. + + +The server must be initially run as root to support the default IPP port of 631. It changes users whenever an external program is run. + + + +Enter for example lp. + + +This is the &UNIX; user account for filters and CGI programs to run under. CGI programs are responsible for showing you the nice web administration interface accessible via http://localhost:631/). + + +There is no need to set the User directive to root, so never do this, as it only involves dangers. Should anyone discover security vulnerabilities in one of the used file filters, printer drivers or CGI programs, he could remotely execute arbitrary commands on your system with root user privileges. Always use an unprivileged account for the server directive User. + + + + + +Server group + +The group the server runs under. Normally this must be sys, however you can configure things for another group as needed. + + +Enter for example sys. + + + + + +Remote user name + +The name of the user assigned to unauthenticated accesses from remote systems. By default remroot. + +This name will appear in log files and in queries about the job owner &etc;, for all resources and locations of the &CUPS; server that are configured to allow access without authentication. Authenticated entries will carry the authenticated names. + + + + + + +Server Logging Configuration + +The server logging configuration is done on this screen. It includes: + + +Access log file setting +Error log file setting +Page log file setting +Log level setting +Max log file size setting + + +This is an important screen for you. Should you ever encounter problems: here is the place to set the Log level to debug, restart the &CUPS; daemon and then look at the Error log file defined here for entries that might give you an insight to the trouble. + + +&CUPS; server configuration dialogue: Server logging + + + + +The dialogue to configure the &CUPS; server: Server logging + + + + + +Access log file + +This is where accesses to the server are logged. If this does not start with a leading /, then it is assumed to be relative to the server root. + +You can also use the special name syslog to send the output to the syslog file or daemon. + + +Enter a path, for example /var/log/cups/acces_log. + + +The format of this file is stored in the so-called Common Log Format. This way you can use programs such as Webalizer or any other Web access reporting tool to generate reports on the &CUPS; server activities. + +To include the server name in the file name use a %s in the name. Example: /var/log/cups/access_log-%s. + +kurt@transmeta:~ +>tail /var/log/cups/access_log + +127.0.0.1 - - [04/Aug/2001:20:11:39 +0100] "POST /printers/ HTTP/1.1" 200 109 +127.0.0.1 - - [04/Aug/2001:20:11:39 +0100] "POST /admin/ HTTP/1.1" 401 0 +127.0.0.1 - - [04/Aug/2001:20:11:39 +0100] "POST / HTTP/1.1" 200 210 +127.0.0.1 - - [04/Aug/2001:20:11:39 +0100] "GET /ppd/DANKA_P450.ppd HTTP/1.1" 200 51021 +127.0.0.1 - - [04/Aug/2001:20:11:39 +0100] "POST /jobs/ HTTP/1.1" 200 246 +10.160.16.45 - - [04/Aug/2001:20:11:39 +0100] "GET /printers/DANKA_P450 HTTP/1.0" 200 0 +127.0.0.1 - - [04/Aug/2001:20:11:39 +0100] "POST / HTTP/1.1" 200 80 +127.0.0.1 - - [04/Aug/2001:20:11:39 +0100] "POST / HTTP/1.1" 200 139 +10.160.16.45 - - [04/Aug/2001:20:11:40 +0100] "GET /cups.css HTTP/1.0" 200 198 +127.0.0.1 - - [04/Aug/2001:20:11:40 +0100] "POST / HTTP/1.1" 200 139 +10.160.16.45 - - [04/Aug/2001:20:11:39 +0100] "GET /printers/DANKA_P450 HTTP/1.0" 200 7319 +10.160.16.45 - - [04/Aug/2001:20:11:40 +0100] "GET /images/title-logo.gif HTTP/1.0" 200 5729 + + +You see a separate line for each single access, showing the IP address of the accessing client, date and time of access, method of access (POST or GET), the requested ressource, the &HTTP; version used by the client, status code and the number of transferred bytes. Status code 200 means successful-OK the 401 in the above example was an unauthorized access which was denied. For a detailed explanation of the log format go to the &CUPS; Software Administrator Manual. + + + + +Error log file + +If this does not start with a leading /, then it is assumed to be relative to the server root. The default setting is /var/log/cups/error_log. + +You can also use the special name syslog to send the output to the syslog file or daemon. + + +Enter the path, for example /var/log/cups/error_log. + + +The error log excerpt below shows you the part logged for printing the test page with the default setting of Log level to info. For an explanation of the Log Level setting see further below. + +kurt@transmeta:~ +> tail /var/log/cups/error_log + +I [04/Aug/2001:23:15:10 +0100] Job 213 queued on 'DANKA_P450' by 'root' +I [04/Aug/2001:23:15:10 +0100] Started filter /usr/lib/cups/filter/pstops (PID 18891) for job 213. +I [04/Aug/2001:23:15:10 +0100] Started backend /usr/lib/cups/backend/lpd (PID 18892) for job 213. + + + + + +Page log file + +If this does not start with a leading / then it is assumed to be relative to the server root. The default is /var/log/cups/page_log + +You can also use the special name syslog to send the output to the syslog file or daemon. + + +Enter the path, for example /var/log/cups/page_log. + +The page log file has a line for every single page of every job printed. + +Here is what some entries look like: + +kurt@transmeta:~ +> tail /var/log/cups/page_log + +GIMP_print_stp_HP kdetest 201 [03/Aug/2001:03:18:03 +0100] 4 1 +GIMP_print_stp_HP kdetest 201 [03/Aug/2001:03:18:03 +0100] 5 1 +GIMP_print_stp_HP kdetest 202 [03/Aug/2001:11:46:49 +0100] 1 1 +GIMP_print_stp_HP kdetest 203 [03/Aug/2001:11:46:54 +0100] 1 1 +DANKA_infotec_P450 kurt 204 [04/Aug/2001:03:29:00 +0100] 1 33 +DANKA_infotec_P450 kurt 204 [04/Aug/2001:03:29:00 +0100] 2 33 +DANKA_infotec_P450 kurt 204 [04/Aug/2001:03:29:00 +0100] 3 33 +DANKA_infotec_P450 kurt 204 [04/Aug/2001:03:29:00 +0100] 4 33 +DANKA_infotec_P450 root 205 [04/Aug/2001:19:12:34 +0100] 1 14 +DANKA_infotec_P450 root 206 [04/Aug/2001:19:15:20 +0100] 1 1 + + +In this excerpt of the file you find information on the name of the printers (GIMP_print_stp_HP and DANKA_infotec_P450) used through this server, the user names (kdetest, kurt and root), the job-IDs (201 to 205), time of printing, page number inside the job and the number of copies for the pages. For example, job-ID 204 had 4 pages and 33 copies printed, job-ID 205 had 14 copies of just 1 page) . + + +&CUPS; is dependent (for its calculation of the number of pages in a job) on passing the &PostScript; through the pstops filter. See the &kivio; Flowchart on the &CUPS; filter architecture for an idea about were this filter fits into the whole printing process). More, pstops depends for the counting on a DSC conforming (DSC is Document Structuring Conventions, a standard defined by Adobe) to be sent by the client. In most cases this is working. + +However, this page accounting does not work for any raw printer queues (as those, by definition, don't use any filtering on the &CUPS; host and are by-passing pstops.) Every job going through a raw queue is counted as a 1-page-job (with possibly multiple copies). This is especially true for all Jobs send from &Microsoft; &Windows; clients via Samba to the &CUPS; server, as those jobs are already arriving in the correct format for the printer, because the clients use the original printer driver. + + + +I am still looking for someone who will write a nice &CUPS; page log analysing tool. It should generate a report with a graphical output similar to the Webalizer's access log reports. This way you could have nice statistics to be used for accounting about usage of printers, load dependent on daytime or weekday, users &etc; Anyone? + + + + + +Log level + +This setting controls the number of messages logged to the error log file. It can be one of the following: + + + +debug2 + +Log everything. + + + + +debug + +Log almost everything. + + + + +info + +Log all requests and state changes. + + + + +warn + +Log errors and warnings. + + + + +error + +Log only errors. + + + + +none + +Log nothing. + + + + + +If you need to troubleshoot (or if you want to study the inner workings of &CUPS;), set the log level to debug or debug2. Then the error_log will have a lot more entries (not just errors, but also informational entries). + +You can use this to watch live what &CUPS; is doing when you send a print job. In a &konsole; type: + +kurt@transmeta:~ +>tail 100 /var/log/cups/error_log + +This will give you the last 100 lines ( 100) of the file onto the screen and a realtime update ()of what is happening. The following listing shows the printing of a test page (some pieces have been cut off for space reasons... Try it yourself if you need more info): + + +I [04/Aug/2001:23:15:12 +0100] Job 214 queued on 'DANKA_P450' by 'root' +D [04/Aug/2001:23:15:12 +0100] StartJob(214, 08426fe0) +D [04/Aug/2001:23:15:12 +0100] StartJob() id = 214, file = 0/1 +D [04/Aug/2001:23:15:12 +0100] job-sheets=none,none +D [04/Aug/2001:23:15:12 +0100] banner_page = 0 +D [04/Aug/2001:23:15:12 +0100] StartJob: argv = "DANKA_P450","214","root","KDE Print Test", +[....] +D [04/Aug/2001:23:15:12 +0100] StartJob: envp = "PATH=/usr/lib/cups/filter:/bin:/usr/bin", [....] +D [04/Aug/2001:23:15:12 +0100] StartJob: statusfds = 5, 6 +D [04/Aug/2001:23:15:12 +0100] StartJob: filterfds[1] = 7, -1 +D [04/Aug/2001:23:15:12 +0100] StartJob: filter = "/usr/lib/cups/filter/pstops" +D [04/Aug/2001:23:15:12 +0100] StartJob: filterfds[0] = 8, 9 +D [04/Aug/2001:23:15:12 +0100] start_process("/usr/lib/cups/filter/pstops", [....] +I [04/Aug/2001:23:15:12 +0100] Started filter /usr/lib/cups/filter/pstops (PID 18991) for job 214. +D [04/Aug/2001:23:15:12 +0100] StartJob: backend = "/usr/lib/cups/backend/lpd" +D [04/Aug/2001:23:15:12 +0100] StartJob: filterfds[1] = -1, 7 +D [04/Aug/2001:23:15:12 +0100] start_process("/usr/lib/cups/backend/lpd", [....] +I [04/Aug/2001:23:15:12 +0100] Started backend /usr/lib/cups/backend/lpd (PID 18992) for job 214. +D [04/Aug/2001:23:15:12 +0100] Page = 595x842; 15,16 to 580,833 [....] + +The lines tagged D at the beginning are debug level entries, the ones tagged I are there in info level. + + + + +Max log file size + + +Controls the maximum size of each log file before they are rotated. Defaults to 1048576 (1 Mb). Set this to 0 to disable log rotation. + + +Enter an size in bytes, for example 1048576 + + + + + + + + +Server Folders Configuration + +The dialogue to configure the &CUPS; server. Different folders are to be set here. Normally you don't need to change anything in this section. In case you play around with fancy (TrueType, &PostScript; or other) fonts on your system, this qis the place to do the settings for using those fonts when printing. Server folder settings include: + + + +Executables: where to find the server executables + + +Configuration: where to find the server configuration files + + +Data: where to find the server data files + + +Temporary files: where to put the server temporary print files + + +Temporary Requests: where to find the server + + +Font Path: where to find the server fonts + + + +&CUPS; server configuration dialogue: &HTTP; configuration + + + + +The dialogue to configure the &CUPS; server: &HTTP; configuration + + + + + +Executables + +The root folder for the scheduler executables. By default this is /usr/lib/cups (or /usr/lib32/cups on IRIX 6.5) + + + + +Configuration + +The root folder for the scheduler. By default, /etc/cups. +On the authors SuSE system, this is /usr/share/doc/cups. It contains all the HTML or PDF documentation for &CUPS; which is available through the Web interface at http://localhost:631/documentation.html + + + + +Data + +The root folder for the &CUPS; data files. By default this is /usr/share/cups +It contains such things as banners, charsets, data, drivers, fonts, and pstoraster templates. + + + + +Temporary files + +The folder to put temporary files in. This folder must be writable by the user defined on the previous screen. This defaults to either /var/spool/cups/tmp or the value of the TMPDIR environment variable. + + + + +Temporary Requests + +The folder where request files are stored. By default this is /var/spool/cups + + + + +Font path + +The place to configure the &CUPS; server for handling your fancy fonts (TrueType or &PostScript;). &CUPS; will look here for fonts to embed in printfiles. This currently only affects the pstoraster filter, and the default is /usr/share/cups/fonts. + +To specify more than one folder, list them with double colons as separator. Do it like this: + + +/path/to/first/fontdir/:/path/to/second/fontdir/:/path/to/last/fontdir/ + + +For the Font path directive to work as intended, the application that wants to print needs to: + + + +Either correctly reference its desired fonts in the header of the generated &PostScript; + + +Or embed the font into the &PostScript; file. + + + +Referencing the font by name leaves it up to the RIP and print device to respect and actually use it. RIP or printer can only use the desired font, if it is available on the system. + +In the case of a &PostScript; printer, this needs to be a printer-resident font. If the printer doesn't have this font, it will try and replace it by an adequately similar font. + +In the case of a non &PostScript; printer, this is done by &CUPS; and its RIP-ing filtering system. &CUPS; will use the font path directive to grab the correct font when RIP-ing the &PostScript; in the pstoraster filter. + +In the case of a &PostScript; output device, &CUPS; is just spooling the file (actually, it is passing it through the pstops filter for accounting or n-up purposes), not working on it. Therefore, if you print to a &PostScript; printer it is solely the printer's responsibility to use the font asked for. It can't, if the font is neither loaded into the printer nor embedded in the &PostScript;. + + + + + + +Server <acronym +>HTTP</acronym +> Configuration + +The dialogue to configure the &CUPS; server &HTTP; settings is shown here. +&CUPS; server &HTTP; settings are the following ones: + +the Document folder +the Default Language +the Default Charset + + + +Dialogue to configure the &CUPS; server &HTTP; settings + + + + +Dialogue to configure the &CUPS; server &HTTP; settings + + + + + +Document folder + +The root folder for &HTTP; documents that are served. By default the compiled in folder, /usr/share/cups/doc + + + + +Default Language + +The default language, if not specified by the browser. If not specified, the current locale is used. + +Use the two letter locale codes, for example en or de. + + + + + + +Default charset + +The default character set to use. If not specified, this defaults to UTF-8. This can also be overridden directly in the HTML documents. + + + + + + +<guilabel +>Server encryption support configuration</guilabel +> + +This is the dialogue to configure the &CUPS; server security settings. The server encryption support settings are these: + + +Server certificate: the file to read containing the server's certificate +Server key: the file to read containing the server's key + + +&CUPS; server configuration dialogue: security overview + + + + +The dialogue to configure the &CUPS; server: security settings + + + + + +Server certificate + +The file to read containing the server's certificate. Defaults to /etc/cups/ssl/server.crt. + + + + +Server key + +The file to read containing the server's key. Defaults to /etc/cups/ssl/server.key + + + + + + + +Server Miscellaneous Configuration + +The dialogue to configure the &CUPS; server miscellaneous settings is shown here. The following server settings are done through this screen: + + +Preserve job history: whether to preserve a job history for later re-view +Preserve job files: whether to preserve fully RIP-ed job files for later re-print +Printcap file: setting the name of and the path to a printcap file +RIP Cache: setting the size of the RIP cache in memory +Filter Limit: defining a filter limit + + + +Dialogue to configure the &CUPS; server miscellaneous settings + + + + +Dialogue to configure the &CUPS; server miscellaneous settings + + + + + +Preserve job history (after completion) + +Whether or not to preserve the job history after a job is completed, canceled, or stopped. The default is yes + + + + +Preserve job file (after completion) + +Whether or not to preserve the job files after a job is completed, canceled, or stopped. The default is no. + + + + +Printcap file + +The name of the printcap file. The default is no filename. Leave this blank, to disable printcap file generation. +The printcap setting is only needed to satisfy older applications in need of such a file. + + + + +RIP cache + +The amount of memory that each RIP should use to cache bitmaps. The value can be any real number, followed by k for kilobytes, m for megabytes, gfor gigabytes, or t for tiles, where one tile is 256 x 256 pixels. The default value is 8m. + + + + +Filter limit + +Sets the maximum cost of all job filters that can be run at the same time. A limit of 0 means no limit. A typical job may need a filter limit of at least 200. Limits less than the minimum required by a job force a single job to be printed at any time. The default limit is 0 (unlimited). + + + + + + +Network General Configuration + +The dialogue to configure the &CUPS; server network settings is shown here. It includes: + + +Look for hostname on IP addresses +Port +Max request size +Timeout + + + +Dialogue to configure the &CUPS; server network settings + + + + +Dialogue to configure the &CUPS; server network settings + + + + +Look for hostname on IP addresses + +Whether or not to do lookups on IP addresses to get a fully-qualified hostname. This defaults to off, for performance reasons. + + + + +Port + +Enter here Ports and addresses that the server will listen to. The default port 631 is reserved for the Internet Printing Protocol, and is what we use here. +You can have multiple entries, to listen to more than one port or address, or to restrict access. + +Unfortunately, most web browsers don't support TLS or &HTTP; upgrades for encryption. If you want to support web-based encryption, you'll probably need to listen on port 443, the HTTPS port. + +Use the Add and Remove buttons to add and remove entries from the list. + +You can enter ports on their own, ⪚ 631, or hostnames with ports, ⪚ myhost:80 or 1.2.3.4:631. + + + + + +Max request size + +Controls the maximum size of &HTTP; requests and print files. The default setting is 0, which disables this feature. + + + + +Timeout + +The timeout (in seconds) before requests time out. The default is 300 seconds. + + + + + + + +Network Clients Configuration + +The dialogue to configure the &CUPS; network client settings is shown here. It includes: + + +Accept "Keep Alive" requests +KeepAliveTimeout: +MaxClients: + + +dialogue to configure the &CUPS; network client settings + + + + +Dialogue to configure the &CUPS; network client settings + + + + + +Accept "Keep Alive" requests + +Whether or not to support the Keep-Alive connection option. The default is on. + + + + +Keep alive timeout + +The timeout (in seconds) before Keep-Alive connections are automatically closed. The default is 60 seconds. + + + + +Max number of clients + +Controls the maximum number of simultaneous clients that will be handled. Defaults to 100. + + + + + + + +Browsing General Configuration + +The dialogue to configure the &CUPS; browsing general settings is shown here. It includes: + + +Enable browsing +Use short names when possible +Use implicit classes + + + + +Dialogue to configure the &CUPS; browsing general settings + + + + +Dialogue to configure the &CUPS; browsing general settings + + + + + +Enable browsing + +Whether or not to broadcast printer information to other &CUPS; servers. Enabled by default. + + + + +Use short names when possible + +Whether or not to use short names for remote printers when possible (⪚ printer instead of printer@host). Enabled by default. + + + + +Use implicit classes + +Whether or not to use implicit classes. +Printer classes can be specified explicitly, in the classes.conf file, implicitly based upon the printers available on the LAN, or both. +When Implicit classes are enabled, printers on the LAN with the same name (⪚ Acme-LaserPrint-1000) will be put into a class with the same name. This allows you to setup multiple redundant queues on a LAN without a lot of administrative difficulties. If a user sends a job to Acme-LaserPrint-1000, the job will go to the first available queue. +This option is enabled by default. + + + + + + +Browsing Connection Configuration + +The dialogue to configure the &CUPS; server browsing connection is shown here. Browsing connection settings include: + + +Broadcast addresses: The (UDP) broadcast address to transmit printer information to +Broadcast Port: The port number to use for broadcasting +Poll addresses: The address(es) to poll for information about printers on servers that might not broadcast (or whose broadcasts might not reach your LAN due to routers in between). + + + +Dialogue to configure the &CUPS; server browsing connection + + + + +Dialogue to configure the &CUPS; server browsing connection + + + + + +Broadcast addresses + +After pressing the Add button, you will see the following dialogue to enter a new value for outgoing broadcasting browse packets. It is the same kind of dialogue as for adding other &CUPS; server addresses to be polled for printer information. + + +Dialogue to enter a new value for broadcasting browse packets to + + + + +Dialogue to enter a new value for broadcasting browse packets to + + + +This option specifies a broadcast address to be used. By default, browsing information is broadcast to all active interfaces. + + +&HP-UX; 10.20 and earlier do not properly handle broadcast unless you have a Class A, B, C or D netmask (&ie;, there is no CIDR support). + + + + + +Broadcast port + +The port used for UDP broadcasts. By default this is the IPP port; if you change this, you need to do it on all servers. Only one BrowsePort is recognised. + + + + +Poll addresses + +Poll the named server(s) for printers. + + + + + + +Browsing Masks Configuration + +The dialogue to configure the &CUPS; server allowed and/or denied browse packets from other servers is shown here. + + +Browse allow: +Browse deny: +Browse order: + + + +Dialogue to configure the &CUPS; server allowed and/or denied browse packets from other servers + + + + +Dialogue to configure the &CUPS; server allowed and/or denied browse packets from other servers + + + + + +Add Browse Address dialogue + +The dialogue to enter a new value for the address of another &CUPS; server to accept browse packets from is shown here. It is opened by clicking on the Add... button beside the field named Browse Allow:. It is the same dialogue as for adding denied broadcast sending addresses. + +The dialogue to enter a new value for the address of another &CUPS; server to accept browse packets from is shown here. + + +Dialogue to enter a new value for the address of another &CUPS; server to accept browse packets from + + + + +Dialogue to enter a new value for the address of another &CUPS; server to accept browse packets from + + + + + + +Browse allow and Browse deny + +Browse allow specifies an address mask to allow for incoming browser packets. The default is to allow packets from all addresses. +Browse deny specifies an address mask to deny for incoming browser packets. The default is to deny packets from no addresses. +Both Browse allow and Browse deny accept the following notations for addresses: + + + + +All + + +None + + +*.domain.com + + +.domain.com + + +host.domain.com + + +nnn.* + + +nnn.nnn.* + + +nnn.nnn.nnn.* + + +nnn.nnn.nnn.nnn + + +nnn.nnn.nnn.nnn/mmm + + +nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm + + + + +The hostname/domain name restrictions will only work if you have turned hostname lookups on! + + + + +Browse order + +Specifies the order of the allow/deny comparisons. + + + + + + + +Browsing Timeouts Configuration + +The dialogue to configure the &CUPS; server browse timeout settings is shown here. Browse timeout settings include: + +Browse Interval +Browse Timeout + + +Dialogue to configure the &CUPS; server browse timeout settings + + + + +dialogue to configure the &CUPS; server browse timeout settings + + + + + +Browse interval + +The time between browsing updates in seconds. The default is 30 seconds. +Note that browsing information is sent whenever a printer's state changes as well, so this represents the maximum time between updates. +Set this to 0 to disable outgoing broadcasts so your local printers are not advertised, but you can still see printers on other hosts. + + + + +Browse timeouts + +The timeout (in seconds) for network printers - if we don't get an update within this time, the printer will be removed from the printer list. +This number definitely should not be less than the browse interval period, for obvious reasons. Defaults to 300 seconds. + + + + + + +Browsing Relay Configuration + +The dialogue to configure the &CUPS; server as a browsing relay is shown here. Browsing relay settings include: + + +Browser packets relay + + + +Dialogue to configure the &CUPS; server as a browsing relay + + + + +Dialogue to configure the &CUPS; server as a browsing relay + + + + + +Add Browse Relay dialogue + +The dialogue to enter a new value for an address pair to define browsing relaying between a &CUPS; server and a network is shown here. + + +The dialogue to enter a new value for an address pair to define browsing relaying between a &CUPS; server and a network + + + + +The dialogue to enter a new value for an address pair to define browsing relaying between a &CUPS; server and a network + + + + + + +Browser packets relay + +Relay browser packets from one address or network to another. + + + + + + + +Security Configuration + +The dialogue to configure the &CUPS; server security settings for any of the defined server locations is shown here. It contains the following settings, which may be defined separately for any valid resource (or location) of the &CUPS; server: + + +System Group: +Access Permissions: +Auth Type: +Auth Class: +Auth Group Name: +Encryption: +Allow: +Deny: +Order: + + +Valid resources (or locations) of the &CUPS; server are: + + +Server Root Location: / +Server Administration Location: /admin +All printers on the server: /printers +Any individual printer on the server: ⪚ /printers/infotec_P320 +All printer classes on the server: /classes: +Any individual printer class on the server: ⪚ /classes/all_infotecs_P320_or_P450 + + + +Dialogue to configure the &CUPS; server security settings for any of the defined server locations + + + + +dialogue to configure the &CUPS; server security settings for any of the defined server locations + + + + + +For all locations that are not defined separately the setting of the location above it is valid. + +For example, you have a printer named infotec_P450 with no set security options. Then the security of the location /printers will take the responsibility for this printer as it is a sub-location of/printers. If, in turn there is no security set for /printers, then the security for / (the general security) of the server takes responsibility. Either you have set this for your purpose or the compiled-in default value takes over. + + + + +SystemGroup + +The group name for System or printer administration access. The default varies depending on the operating system, but will be sys, system or root (checked for in that order). + + + + +Access Permissions + +Access permissions for each folder served by the scheduler. Locations are relative to the document root. + + + + +Authorisation Type + +The authorisation to use: + + + +None + +Perform no authentication. + + + +Basic + +Perform authentication using the &HTTP; Basic method. + + + +Digest + +Perform authentication using the &HTTP; Digest method. + + + + + +Local certificate authentication can be substituted by the client for Basic or Digest, when connecting to the localhost interface. + + + + + +Authorisation Class + +The authorisation class. Currently only Anonymous, User, System (valid user belonging to the group set as system group), and group (valid user belonging to the specified group) are supported. + + + + +Authorisation Group Name + +The group name for Group authorisation + + + + +Encryption + +Whether or not to use encryption. This depends on having the OpenSSL linked into the &CUPS; library and scheduler. +Possible values are: + + +Always + +Always use encryption (SSL) + + + +Never + +Never use encryption. + + + +Required + +Use TLS encryption upgrade. + + + +IfRequested + +Use encryption if the server requests it. + + + + + + + +Allow + +Allows access from the specified hostname, domain, IP address or network. Possible values are: + + + + +All + + +None + + +*.domain.com + + +.domain.com + + +host.domain.com + + +nnn.* + + +nnn.nnn.* + + +nnn.nnn.nnn.* + + +nnn.nnn.nnn.nnn + + +nnn.nnn.nnn.nnn/mmm + + +nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm + + + + +The host and domain address require that you enable hostname lookups, as described earlier. + + + + +Deny + +Denies access from the specified hostname, domain, IP address or network. Possible values are: + + + +All + + +None + + +*.domain.com + + +.domain.com + + +host.domain.com + + +nnn.* + + +nnn.nnn.* + + +nnn.nnn.nnn.* + + +nnn.nnn.nnn.nnn + + +nnn.nnn.nnn.nnn/mmm + + +nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm + + + +The host and domain address require that you enable hostname lookups, as described earlier. + + + + +Order + +The order of the allow and deny processing. + + + + + + +Example: How To Define The Security For All Printers + +The dialogue to configure the &CUPS; server security settings is discussed here. We use the example to add security definitions other than the default ones for the resource named all printers. For the &CUPS; web server, this is the location you access through http://localhost:631/printers/ or (remotely) through http://cups.server.name:631/printers/ + +The first screenshot shows the general location for this setting. Select Add or Modify a resource for which you want to decide about its security settings. + + +Dialogue to configure the &CUPS; server security settings + + + +Dialogue to configure the &CUPS; server security settings + + + +This dialogue is to add a new resource. It looks similar if you want to modify an already existing resource. Here are the general options: + + +Dialogue to add a new resource. + + + + +Dialogue to add a new resource. + + + +.This is the second part or the dialogue is to add a new ressource. It looks similar if you want to modify an already existing resource. Here you define the actual access masks for the resource in question. + + +Dialogue to add a new resource. + + + + +Dialogue to add a new resource. + + + +Resource dialogue + + + + +Resource dialogue + + + + +Resource dialogue + + + + +Resource dialogue + + + + +Resource dialogue + + + + +Resource dialogue + + + + +Resource dialogue + + + + +Resource dialogue + + + + + + diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/cupsoptions.docbook b/tde-i18n-en_GB/docs/kdebase/kdeprint/cupsoptions.docbook new file mode 100644 index 00000000000..dd99dcad9fd --- /dev/null +++ b/tde-i18n-en_GB/docs/kdebase/kdeprint/cupsoptions.docbook @@ -0,0 +1,898 @@ + +&CUPS; options presently not available through &kcontrol; + +This chapter gives you some hints about further configuration possibilities which may not be available through the &kdeprint; &GUI; interface to &CUPS;. + + +Overview of provided features + +All of the most often used features and functions &CUPS; provides are supported in &kdeprint;. + + + +Printer management is supported: add, remove, modify, configure, test, disable, enable ... + + +Job management is supported: cancel, hold, release, move to different printer + + +Print options: for full control as provided by &CUPS;. + + + + + + +Where to find help when using &CUPS; + +A lot of information about the inner workings of &CUPS; is available through the web interface, which &CUPS; will always support. It works with any browser (yes, even text-based ones). Just go to http://localhost:631/ for a start. There you find a link to locally available &CUPS; documentation in HTML and PDF if you are new to &CUPS;. + +&CUPS; is accessible through other means than &kdeprint;: commandline and browser are two native &CUPS; interfaces. The many commandline utilities add up to the most complete control you have on &CUPS;. The web interface is only a subset of all available configuration or control options. + +This is also true for &kdeprint;. Generally, as &CUPS; develops, most new features will first be implemented through the commandline. Be sure to check the latest versions of the man pages for &CUPS; to stay up-to-date with new features after you install a new version. + + +Depending on your update method for &CUPS;, your active configuration file might not have been re-placed by a new one; thus your new, more capable &CUPS;-daemon might not have been told by the old configuration file about the new features to use. + + +A complete list of available files and man pages should always be in the &CUPS; Software Administrator Manual (http://localhost:631/sam.html#FILES. In the &konqueror; &URL;/location field, type man:/lpadmin and man:/cupsd.conf to find out about the most important command and configuration file. You knew already about &konqueror;'s nice abilities to show you the traditional &UNIX; man pages, didn't you? Read this. From there you find more interesting hints and links to other man pages and documentation. + + +How to find &CUPS; related man pages + +Here is a way to find out which &CUPS; related man pages there are on your system: + +kurt@transmeta:~ +> apropos cups + +cups-calibrate (8)- ESP Printer Calibration Tool +lpstat (1) - print cups status information +cups-lpd (8) - receive print jobs + report printer status to lpd clients +classes.conf (5) - class configuration file for cups +backend (1) - cups backend transmission interfaces +filter (1) - cups file conversion filter interfaces +cups-polld (8) - cups printer polling daemon +mime.types (5) - mime type description file for cups +cupsd (8) - common unix printing system daemon +lpadmin (8) - configure cups printers and classes +cupsd.conf (5) - server configuration file for cups +mime.convs (5) - mime type conversion file for cups +printers.conf (5) - printer configuration file for cups +mime.convs (5) - mime type conversion file for cups +cups-polld (8) - cups printer polling daemon +lpstat (1) - print cups status information +backend (1) - cups backend transmission interfaces +mime.types (5) - mime type description file for cups +cupsd (8) - common unix printing system daemon +lpadmin (8) - configure cups printers and classes +printers.conf (5) - printer configuration file for cups +cupsd.conf (5) - server configuration file for cups +filter (1) - cups file conversion filter interfaces + + + + + +Outside &kdeprint;: Hints & Tips Tricks with &CUPS; on the Commandline + +Here are a few examples of options that are presently only available if you use the commandline. + + +Allowing or denying printer access for certain users + +When installing (or modifying) a printer through the command line, you can either deny or allow the usage of that printer to certain users: + +lpadmin HeidelbergDigimaster9110 lpd:/10.160.16.99/mqueue allow:kurt,sylvi,hansjoerg /home/kurt/PPDs/DVHV.ppd + +will allow the usage of this (believe me: very nice and also very professional) printer to only the three mentioned users and at the same time deny it to all others. If another user wants to print on the DigiMaster via this &CUPS; server, he will receive an error message along the lines client-error-not-possible. + +lpadmin HeidelbergDigimaster9110 lpd:/10.160.16.99/mqueue deny:tackat,boss,waba /home/kurt/PPDs/DVHV.ppd + +will deny the usage of this same printer to the three mentioned users and at the same time allow it to all others. If denied user wants to print on the DigiMaster via this &CUPS; server, he will receive an error message along the lines client-error-not-possible. + + +Only one of the two options may be used at one time; at present there is no support to have a similar option in a per-group based way. This will be implemented in the future. + + + + +Imposing Quotas for certain printers + +Sometimes you want to impose quotas for certain printers. With quotas you can set upper limits for the number of pages or the amount of data to be printed over a certain period to a certain printer. + +Quotas can be set with the option when installing a printer with the lpadmin command, or afterwards for an already existing printer. Following are some guidelines (which are missing at the time of writing in the, official &CUPS; documentation): + + + +With &CUPS; you may have pagecount- and filesize-based quotas for individual printers. + + + +Quotas are calculated for each user individually (so a single set of limits applies to all users for the printer concerned). + + + +Quotas include banner pages (if those are used). + + + +This means: you can limit every user to 20 pages per day on an expensive printer, but you cannot limit every user except Kurt or root. + + + +There are , , and options to give when setting up a printer. + + + + sets a time interval for quota computing (intervals are determined in seconds; so a day is 60x60x24=86.400, a week is 60x60x24x7=604,800, and a month is 60x60x24x30=2.592.000 seconds.) + + + +For quotas to be enforced, the time-period plus at least one job-limit must be set to non-zero. + + + +The default value of 0 for specifies that there is no limit. + + + +The default value of 0 for specifies that there is no limit. + + + +The default value of 0 for specifies that the limits apply to all jobs that have been printed by a user that are still known to the system. + + + + +Working Examples: + +Working, as both, time-period plus one or both job-limits are defined + +lpadmin danka_infotec_4850 job-quota-period=604800 job-k-limit=1024 + +This sets a limit of a file size of 1 MB (in total) for each user of existing printer danka_infotec_4850 during one week. + +lpadmin danka_infotec_4105 job-quota-period=604800 job-page-limit=100 + +This sets a limit of 100 pages (in total) for each user of existing printer danka_infotec_4105 during one week. + +lpadmin danka_infotec_P450 job-quota-period=604800 job-k-limit=1024 job-page-limit=100 + +This sets a combined limit of 1 MB (in total) and 100 pages (in total) for each user of existing printer danka_infotec_P450 during one week. Whichever limit is reached first will take effect. + + + + +Not working examples + +NOT working, as only one, time-period or job-limit is defined) + +lpadmin danka_infotec_P320 job-quota-period=604800 + +lpadmin danka_infotec_FullColor job-page-limit=100 + +lpadmin danka_infotec_HiSpeed job-k-limit=1024 + + + + +Related Error Messages + +Once a user reaches his quota limit, he'll get a client-error-not-possible message, if he wants to print. + + + + + + +Installing a <quote +>raw</quote +> printer + +There are different ways to define a raw printer. One comfortable one is to use the lpadmin command. Just don't define a &PPD; file to be used for that printer and it will be a raw one: + +lpadmin Raw_Danka_infotec lpd://10.160.16.137/PORT1 + +Raw printer queues are those which don't touch the print file to transform it to a different file format. You need this for example when printing from &Windows; clients via Samba through a &CUPS; server to a PCL printer: in this case the &Windows; side printer driver would generate the finished print file format for the target printer and filtering it through &CUPS; filters would only harm the purpose. Under certain circumstances (if you want to make sure that the file goes to the printer unfiltered by &CUPS;) the lpadmin without a &PPD; comes in handy. + + + + + +Troubleshooting &CUPS; in &kdeprint; + +This section of the &kdeprint; Handbook will live from the readers' feedback. Here is just a small beginning. + + +Error Messages + + + + +What does the error client-error-bad-request mean? + + +The user sent a file to the &CUPS; which the server could not process. You get this also upon sending an empty file. + + + + + +And client-error-not-possible? + + +User is either not allowed to print to a certain printer or has achieved his quota (based on file size and/or page number) + + + + + +How about client-error-not-found? + + +The user tried to access a nonexistent resource on the &CUPS; server, such as trying to print a nonexistent file, or one that you are denied permission to read. + + + + + + + + +Questions and Answers + + + + +Why can't I re-start my jobs? + + +To be able to re-start your completed jobs from the web interface, you need a setting in the /etc/cups/cupsd.conf file: set PreserveJobFiles True. + + + + + +How do I get rid of the long list of completed jobs in the web interface? + + +TODO + + + + + +How does page accounting work? + + +&CUPS; does the print accounting by passing nearly every job through the pstops filter. This one does, amongst other things, the page counting. Output of this filter there may be piped into other filters (like pstoraster --> rastertopcl) or sent to the printer directly (if it is a &PostScript; printer). + +In any case, this works for network, parallel, serial or USB printers the same. For pstops to work, it needs DSC, Document Structuring Convention compliant &PostScript; (or near-equivalent) as input. So it calculates the pages during filtering on the print server and writes info about every single page (what time, which user, which job-ID and -name, which printer, how many copies of which pages of the document, how many kilo-bytes?) into /var/log/cups/page_log. + +By the way: on my personal wishlist is a hack of webalizer to read and analyse the page_log and give a similar output. Anyone? + +However, it is not giving correct results in the following cases: + + + +The printer jams and maybe therefore throw away the job (real live experience; or maybe throwing away the job because of problems with the data format) + + +Jobs printed as raw are always counted as size of 1 page (and maybe multiple copies). + + + +Therefore the page accounting of &CUPS; is only an approximation (in many cases an excellent or at least good one, in others a quite poor one). The only reliable print count is the one done by the internal printer counter. (Because this is the one you pay for, if you are on a click price or similar.) Some, by far not most, printers can be queried remotely for that information via SNMP (Simple Network Management Protocol). That means, in a bigger network with many different printers there is just no completely reliable and accurate page accounting tool! + + + + + +Why doesn't page-accounting work with &Windows; clients? + + +From &Windows; clients jobs nearly always need to be sent as raw. Why? If &CUPS; works as a print server for &Windows; clients using the original native &Windows; driver for the target print device, this guarantees the correct formatting of the job on the clients already; therefor the server should not touch it and print raw; therefor no filtering is started (and this is not even possible as the input from the clients is not &PostScript; as pstops expects; hence no page-count other than the default 1. + + + + + +How do I get a list of available options for a given printer or a &PPD; file? + + +See the man page for the lpoptions command. You may investigate a &CUPS;-enabled box about any option of its available printers. There is no need to have the printer installed locally. As long as the printer is available locally (through the &CUPS; printer browsing feature), it will also work remote. + +To query for a printers' option typing lpoptions HitachiDDP70MicroPress will give a long listing of all available options as read from the &PPD; file for the given Hitachi-Printer (in my case installed on remote server transmeta). Remote server Transmeta and its &CUPS; daemon as well as the localhost's &CUPS; daemon need to be up and running for this to succeed. + + + + + +How do I read the listing retrieved by the lpoptions command? + + + +You know that for &PostScript; printer manufacturers it is legal to define their own internal names and procedures even for standard &PostScript; options. As long as the driver is able to retrieve the option from the &PPD; and show it to the user in a way that he understands it everything is OK. But what do you do, if you want to use some obscure printer options on the command line? How do you find out its exact syntax? + +Let's take an example. Looking at Hitachi's DDP70 printer and how it implements duplex printing is revealing somehow. How do you tell how to print double sided? duplex or Duplex? Or another name altogether?. + +lpoptions transmeta Hitachi_DDP70_ClusterPrintingSystem | grep uplex + +This leads to the output + +TR-Duplex/Duplex: False *True + +This is to be interpreted like follows: + + + +The name of the investigated option is ; + + +Behind the slash you see the translation of the option, as it should be shown in a &GUI; or Web interface (Duplex); + + +The option may take one of the two values False or True; + + +The present setting is True to be recognised by the marking with a star *. + + + +To override the present default setting (duplex) and print a job in simplex, you need to use the following command: + +lpr Hitachi_DDP70_ClusterPrintingSystem TR-Duplex=False /path/to/your/printjob + + + + + +How do I get a nicely formatted listing of available options for a given printer or &PPD;? + + +Use the lphelp command which may be installed on your system locally. There is not yet a man page for lphelp. + +lphelp infotecP450 + +This lists the available options for the named printer. It is nicely formatted and does explain every available option and how to use it. You can query different printers' options at once: + +lphelp infotec7410color DANKA_fullcolor_D2000 HP_ColorLaserJet8550 + +It also works for &PPD; files. Just specify the path to the &PPD;: + +lphelp /home/kurt/PPDs/HP-ColorLaserJet8550.ppd + + + + + + +Solving Problems + +No system is perfect. Here are some commonly seen traps people have fallen into. + + + + +My printer named 3-lp-duplex shows erratic behaviour. What's wrong? + + +The printer names used in &CUPS; shall start with a letter and may contain up to 128 letters, numbers or underscores. Using dashes may lead to problems. Speaking about naming: printer names in &CUPS; are not case sensitive. So a printer named Best_of_Danka will be the same as best_of_danka or BEST_OF_DANKA. (This is a requirement of &IPP;, which &CUPS; is fully compliant with). + + + + + +Why do I get Unable to connect to SAMBA host: Success with my printer shares from &Windows; accessed via Samba? + + +Are the rights on the remote &Windows; box set correctly for you? Are you actually allowed to print on the &Windows; shared printer? + + + + + +My files for printer lp sometimes mysteriously disappear and two days later I am told they got printed on a printer three floors below my office. What is going on? + + +Believe me, it is very unlikely that your printer is the only one with the name lp. Maybe &CUPS; is playing a trick on you. As you might have the setting ImplicitClasses On activated, &CUPS; tries to stuff all printers it sees on the network into a Class name lp. All jobs destined to lp are sent to this class and the first available member prints it. So if you had this nice fellow (who listened closely when you raved about &CUPS; and &kdeprint;) install &CUPS; and poke around the system...get the idea? + +Take my advice: choose a unique name for any network printer! (Mind you, the one on your parallel port also turns out to be a network printer for the rest of the world if you don't take care of your settings). + + + + + + diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/extensions.docbook b/tde-i18n-en_GB/docs/kdebase/kdeprint/extensions.docbook new file mode 100644 index 00000000000..275a933fb47 --- /dev/null +++ b/tde-i18n-en_GB/docs/kdebase/kdeprint/extensions.docbook @@ -0,0 +1,89 @@ + +&kdeprint; Extensions To All Print Subsystems + + +<quote +>Virtual</quote +> Printers + + +The <quote +>Fax</quote +> Printer + +To be written + + + + +The <quote +>File</quote +> Printer + +To be written + + + + +The <quote +><acronym +>PDF</acronym +></quote +> Printer + +To be written + + + + + + +<quote +>External</quote +> Filters + + +The <command +>enscript</command +> Filter for Text Files + +To be written + + + + +The <quote +>n-up</quote +> Filter for Any File + +To be written + + + + +Three different <quote +>Make Pamphlet</quote +> Filters for &PostScript; Files + +To be written + + + + + + diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/external-command.docbook b/tde-i18n-en_GB/docs/kdebase/kdeprint/external-command.docbook new file mode 100644 index 00000000000..40f62dde1a0 --- /dev/null +++ b/tde-i18n-en_GB/docs/kdebase/kdeprint/external-command.docbook @@ -0,0 +1,27 @@ + +Module For External Print Command (&Netscape;-like) + +This module allows the print command to be specified completely (&Netscape;-like). An edit line is added in the print dialogue for that purpose. Can be used in many cases, for example with a self-made print program. + + +Overview of provided features + + + +Printer management: not supported + + +Job management: not supported. + + +Print options: basic control, depending on your knowledge of the print command + + + + diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/final-word.docbook b/tde-i18n-en_GB/docs/kdebase/kdeprint/final-word.docbook new file mode 100644 index 00000000000..36028488805 --- /dev/null +++ b/tde-i18n-en_GB/docs/kdebase/kdeprint/final-word.docbook @@ -0,0 +1,92 @@ + +Final word from the Author + + +Who am I, what is my business? + +My employer is Danka Deutschland GmbH, a leading and manufacturer-independent provider of professional and hi-speed digital printing systems, black-and-white as well as colour. Danka provides hardware, software, service, maintenance, consumables and customised solutions for the products in its portfolio. I work there as a System Engineer. Amongst the brands Danka offers are Heidelberg (formerly Kodak), Canon, &Hewlett-Packard;, Hitachi, Infotec and EfI. + +My acquaintance with &Linux; and the Free Software community is not too old. When I started to play around with &Linux; at the beginning of 1999, my deepest disappointment was the poor support for printing. True, I made all our machines spit out simplex prints -- but what about duplex? What about punching the output? How to make sorting work? Or stapling, cover sheets and all the other beautiful finishing options our engines offer to customers? No way -- at least for me as a non-geek! + +I began a search on the Internet for a solution. Fortunately not much later, in May 1999, Mike Sweet, principal developer of &CUPS;, announced the first Beta release of this superb piece of printing software. After trying it briefly, I knew this was it! + +Next thing I attempted: to make &Linux; distributions interested in this new stuff. Believe me -- it was more than tenacious! They seemed to think they already had the best thing they could get in printing. One reason probably was that they (and many &Linux; developers) never had to think about how to best support a printer duplexer -- because one had never come near their own desks... + +Finally, my attempts to make some &Linux; print publications interested in &CUPS; backfired on me - one editor squeezed me into writing a series on the subject myself. And this is how some people started to give me the nickname CUPS Evangelist. I will not get rid of this nick anytime soon, now that even the &kde; people wedged me into their timeframe of releases. Oh, boy... + +Anyway, &CUPS; is now making its way around the world and it might well become a triumphal one: I am a little bit proud to have supported and contributed to this from near the beginning. + +It should encourage you: even if some more experienced &Linux; users than you are skeptical about it, and even if your programming skills are next to zero (like mine) - there are a lot of tasks and jobs and ideas, and talent that you can contribute to the Free Software community. Not least within the &kde; project... + + + + +Credits + +I'd like to thank... + + +Mike Sweet for developing &CUPS; in the first place + + +Jean-Eric Cuendet for starting kups and qtcups, the predecessors of &kdeprint; + + +Michael Goffioul for doing all the hard work recently + + +Martin Konold for thinking twice + + +Sven Guckes for teaching me a few things about the art of survival on the terminal (just in case &kde; is not there ;-) ) + + +...too numerous others to mention who also let me snatch bits and bytes of knowledge off them + + +and last, but not least: Tom Schwaller for encouraging me to get into documentation writing + + + + + + +Caveats + +&kdeprint; has been developed on a system using &CUPS; 1.1.6. &kdeprint; has been tested on other versions of &CUPS; and so far no incompatibilities are known. By the time of writing this Handbook, &CUPS; 1.1.9 is out with a few new features not yet supported by &kdeprint;. Of course you are able to access these features, but you will need to bypass &kdeprint; and use the &CUPS; command-line tools or edit configuration files manually. &kdeprint;'s development will go on and this Handbook strives to always be the best available user documentation resource for it. + + + + diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/getting-started.docbook b/tde-i18n-en_GB/docs/kdebase/kdeprint/getting-started.docbook new file mode 100644 index 00000000000..71f16e0b030 --- /dev/null +++ b/tde-i18n-en_GB/docs/kdebase/kdeprint/getting-started.docbook @@ -0,0 +1,187 @@ + +Getting Started + +This chapter of the &kdeprint; Handbook will walk you through most of the configuration or selection options of &kdeprint;. It will mainly deal with &CUPS; in this version, as the author is most familiar with it, and also because &kdeprint; started off with supporting &CUPS; best. Later versions of the &kdeprint; software and editions of this handbook will support and explore other printing systems more closely. + + +Selecting Your Print Subsystem + +You need to define your print subsystem, before you are able to install any printer with the &kdeprint; framework. There are two areas where you can define this: either in &kcontrol; (The Printing Manager section), or directly and on the fly from the print dialogue. + +Navigate to K Menu Preferences System Printing Manager. At the bottom you can see a button that lets you select which printing subsystem you want to use. In &kde; 2.2 you can choose from the following alternatives: + + + +&CUPS; (Common &UNIX; Printing System) + + +Print through an external program (generic) + + +LPR (Standard BSD Print System) + + +Generic &UNIX; LPD print system (the default) + + +RLPR environment (print to remote LPD servers from the command line) + + + +Of course, the chosen system must be installed, and up and running on your box prior to your selection, or before it takes effect. + +On it's first startup, &kdeprint; will try an autodetection. This only works for: + + + +&CUPS;, as it is checking first for a running &CUPS; daemon + + +LPD, as it is checking for a running LPD daemon, plus a printcap file. + + + + + +The system you choose must be installed on your system prior to your selection. The author's personal recommendation is &CUPS;. + +Once autodetected, chosen, or changed, the active print subsystem will take effect for all &kde; applications. Different users may have different print subsystems in use, if those do exist on the computer and are compliant with each other. Their settings are stored in the kdeprintrc. This file is unique to every user, and is normally installed in $HOME/.kde/share/config/kdeprintrc. + + +This file is not intended to be directly editable, and all available options can be set from the &kdeprint; &GUI;. + + +You may even select a different printer subsystem, on the fly, from the &kprinter; dialogue box. + + + + +Working with the Printing Manager + +Once you have chosen your preferred and installed print subsystem, you are ready to investigate, configure administer and work with this system through the &kdeprint; framework. + +Navigate to K Menu Preferences System Printing Manager. In the right part of the window you will see at least 4 printers predefined. These are the virtual or special purpose printers, explained in section . You will probably see a toolbar with 13 icons at the top of the window, and at least 4 tabs in the lower half of the window, labelled Information, Jobs, Properties and Instances. + + + + + + + + + + + + + + + + + + diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/highlights.docbook b/tde-i18n-en_GB/docs/kdebase/kdeprint/highlights.docbook new file mode 100644 index 00000000000..26466730066 --- /dev/null +++ b/tde-i18n-en_GB/docs/kdebase/kdeprint/highlights.docbook @@ -0,0 +1,695 @@ + +&kdeprint;'s Highlights + +The new &kdeprint; system includes more than one highlight. Having worked in an environment in the past that is not exactly sophisticated, as far as printing is concerned, take a look at some of the benefits that come with &kdeprint; + + +The <quote +>Add Printer</quote +> Wizard + +&kdeprint; has an Add Printer Wizard. The Add Printer Wizard helps you with adding and configuring a new printer. Of course, you may do this manually as well. + +&kdeprint; helps you discover printers. It is able to scan the environment for available devices and queues. This works for network connections using TCP (AppSocket, aka &HP; JetDirect, or IPP) or SMB/Samba (shared &Windows;) printers and partially for directly attached printers over parallel, serial, or USB connections. + + +A screenshot of the new Add Printer Wizard + + + + + +Here's a screenshot of the Add Printer Wizard (this one is not very exciting yet; but...) + + + + +The wizard makes the installation and handling of the drivers a snap. Selecting, configuring and testing should be easy as never before on any &Linux;-like system. + + + + + + + +Full Print Job Control + +The Print Job Viewer is automatically started by &kprinter;. It may be docked into the &kde; panel (in the system tray). The Print Job Viewer allows full job management, if supported by the print subsystem. + +You can: + + + +Hold and release jobs, + + +Move pending jobs to another printer, + + +Cancel pending or processing jobs. + + + +A screenshot of the &kdeprint; PrintJob Viewer shows the information you get: Job-ID, target printer, job name, job owner, job status and job size. In the next &kdeprint; release you will also see information about the number of pages (as &CUPS; calculates it; see chapter on page accounting for more information about its merits and limitations). + + +A screenshot of the &kdeprint; PrintJob Viewer + + + + + +Here's a screenshot of the &kdeprint; PrintJob Viewer. + +A screenshot of the &kdeprint; PrintJob Viewer. + + + +An alternative way to looking at the same information (and having the same amount of control is through the &kcontrolcenter; selecting SystemPrinting Manager. If you don't see the Printer Information, right click on the window background and select View Printer Information. Then go to the Jobs tab to see this: + + + + + + + + +Here's a screenshot of the &kdeprint; PrintJob Viewer. + + + + + + + +Modules for different print subsystems + +&kdeprint; uses different modules to realise the interface to the possible print subsystems. Not all the modules are yet developed fully, but you will have basic printing functionality with: + + + +LPD (BSD style) + + +LPRng (&RedHat;, if you just use it's BSD style subset), + + +RLPR (a command-line LPR utility, which doesn't need a printcap file. + + +external print commands (&Netscape; like). + + + +Most importantly, full support for &CUPS; is already there. Modules for other print subsystems, such as PLP, PPR and PDQ may be available later. + +&kdeprint; makes &kde; much more flexible. It gives freedom of choice to &kde; 2.2 users. To use different available print subsystems, these must, of course, be installed independently from &kde;. In former versions, users were stuck with the old LPD style print subsystems. Now they can even use &CUPS;. In the future, there will be easy integration of new subsystems, as they appear on the scene. + + + + +More &kdeprint; <quote +>Goodies</quote +> +Benefitting all Print SubSystems. + +Some specific features of &kdeprint; depend on the chosen print subsystem. This dependency might exist because those features are only implemented there; remember, &kdeprint; is an intermediate layer between &kde; applications, and the print subsystem, but it's no replacement for any print subsystem by itself. Such dependency may exist for another reason: that &kdeprint; has not yet implemented an interface to all the features of all the subsystems. + +Other features include benefits from &kdeprint; that are independent of the chosen print subsystem, and are available with all of them. At present there are special or virtual printers, and some generic pre-filters. + + + +Print Preview + +From the Print Dialogue, you can select to look at a preview. For this, the print file is passed through filters which make it suitable for displaying on screen using &kghostview;. + + + + +Special Printers + +Amongst these additional &kdeprint; features are a few special or virtual printers: + +These special printers may: + + + +Print to PDF + +Convert your document into a PDF file with the help of an external program. + + + + +Print to email + +Send your document as an email attached PDF file. + + + + +Print to PS file + +Save your document as a &PostScript; file. + + + + +Print to Fax + +Send it through an available backend, such as Hylafax as a fax. + + + + + +These special printers appear in the user print dialogue just like normal printers. They are entirely configurable on a per-user basis. + + + + + +Generic Pre-Filtering + +&kdeprint; provides you with a framework to define and configure your own pre-filters. These pre-filters may take effect before they are passed to your print subsystem for further processing, but after the (&PostScript;, plain text or other) print files have been generated by your application. + +There are a few useful filters already predefined. These are: + + + +The multiple pages per sheet filter, + + + +the enscript text filter, + + + +and three filters to help print pamphlets. + + + +You may create your own filters based on any third party program that is able to process &PostScript;, plain text or image files, and output any one of those formats. + +These filters are configured through XML files. This makes an extension of the concept very easy for experienced developers, but end-user configuration is also done through an intuitive graphical user interface. So, fear not, you don't need to learn XML because of &kdeprint;! + + + +Multiple Pages Per Sheet Filter + +This is a predefined filter that installs with &kdeprint;. It allows you to create a modified &PostScript; output, from &PostScript; input, that prints 1, 2, or 4 logical pages on a single sheet of paper. + + + + +Enscript Text Filter + +This is a predefined filter that installs with &kdeprint;. It allows you to create &PostScript; output from any text file input, that includes syntax highlighting for program listings, pretty-printing, and nice configurable page frames and headers. + + + + +Pamphlet Printing Filters + +If your printer is able to produce duplex output, using either one-pass or two-pass technology, you may be able to use one, or a combination, of the pamphlet filters. + +For duplexing printers, make sure you use the duplex option that turns the output along the short paper edge. Folding the printed paper along the middle turns your document into a nice pamphlet. + +If you are stuck with using a simplex-only device, you can do the same, using two different filters and a few additional steps. + +Depending on your model, first use the filter for printing the odd pages, then insert the paper in the correct order back into the paper tray to get the even pages printed on the reverse side. These can then be folded to make a pamphlet. + + + + + + + + + + +&CUPS; Support: the Most Important Module in &kdeprint; + +&kdeprint; contains a module for &CUPS;. &CUPS;, the Common &UNIX; Printing System (http://www.cups.org/), is the most advanced, powerful and flexible of all print subsystems on &UNIX; and other &UNIX;-like operating systems. It is still quite new on the horizon, but is based on IPP, the Internet Printing Protocol, the newly emerging standard for the future of network printing. &CUPS; is clearly the print system of choice for Michael Goffioul, the principal &kdeprint; developer. + +Experienced &kde; users may already be familiar with Michael's utilities qtcups and kups (co-developed with Jean-Eric Cuendet). These were, up until now, the graphical &GUI; front ends for &CUPS; with a strong relation to &kde;. + + +<application +>qtcups</application +> and <application +>kups</application +> — The Predecessors + +Both utilities are probably still widely used. For those not familiar with them, here are brief explanations. + +qtcups was a graphical front end for the lp or lpr print commands as installed by &CUPS;. Using qtcups opened a dialogue. This dialogue let you comfortably select your printer and the print job options. qtcups worked from the command line, or from within applications, when the application in question had a configurable print command. + +kups was a graphical wrapper to do the administration tasks for your &CUPS; server, and the &CUPS; daemon at the heart of it. You could add, delete, modify, configure, start, and stop printers. You could cancel, delete, move, stop and restart print jobs, and you could change the settings of the daemon, start, stop, and restart it. + + + + +&kdeprint; — The Heir + +The &CUPS; Module in &kdeprint; now contains all (and more) functions that were provided by qtcups and kups in former &kde; versions. + +Instead of qtcups you can now use the kprinter command. And in place of kups you will probably use kcmshell printmgr from now on. + +The &kdeprint; module for &CUPS; also lets you fully administer the print subsystem, just like kups did before. It can start, stop and configure your &CUPS; daemon. It can also start, stop, add and delete printers (&ie; printer queues) and printer instances. Printer instances are printer queues that point to the same physical output device but with a different default setting of print options. + + + + +&kprinter; — Graphical Print Command + +&kdeprint;'s &CUPS; module gives you access to a graphical print command, like qtcups did before. + +Use &kprinter; in any application, even a non-&kde; application, that lets you configure your print command. Examples of these are &Netscape; and StarOffice, but not most pre-&kde; 2.2 programs. + +A screenshot how to use the new kprinter print command instead of the old-fashioned lpr... Of course you need to have kprinter in your $PATH, or give the full path in the dialogue; ⪚ /opt/kde/bin/kprinter. &Netscape; will remember this and with further print jobs you will get the kprinter dialogue to configure your printouts. + + +A screenshot of the kprinter print command in action. + + + + + +Here's a screenshot showing how to use the new kprinter print command instead of the old-fashioned lp or lpr in &Netscape;. + + + + +You can also use &kprinter; from the command line and see the resulting dialogue box pop up: + + +Screenshot of the kprinter command + + + + +Screenshot showing use of the kprinter command from the command line. + + + +Just make sure you give at least the file to be printed from the command line as well: kprinter . This will hand over the &CUPS; Software Administrator Manual to the kprinter dialogue, which will then pop up with the default printer pre-selected. + +To pre-select a specific printer from the command line, use the option, ⪚: kprinter . You can still de-select the printer and choose a different one. + +You cannot however call kprinter without a print file and hope to open a file selection dialogue box from the &kprinter; window. This is a feature that will be implemented only in the next version. + + +Using kprinter you are able to ring all the bells and blow all the whistles of your printer. You will need a device-specific so-called &PPD; (&PostScript; Printer Description) to enable &CUPS; to make this nice tandem team do this for you. Read more about this in . + + + + + + +Plans for Future Development + +What you have now is the first, already very feature-rich version of &kdeprint;. This version is, of course, fully usable for printing. You might even think that it was never so easy (not even back in the days when you had to use &Microsoft; &Windows;). + +In the future, &kdeprint; will become even better. It will do a better job of detecting your installed print subsystem itself. Already &kdeprint; is doing quite well in automatically sensing if you have &CUPS; on your system. But in many cases you will have to tell &kdeprint; what you are using, if you want to keep a legacy print system. + +The most important improvement in the near future will be a completion of the LPRng plugin. This at present is still very basic. It is restricted to the pure classical LPD part of LPRng. + +Also, you may be able to add printers directly from the print dialogue to your system just in time, without going to &kcontrol; first. + +Some smaller improvements already planned are: + + +add a file selection dialogue from the &kprinter; window to allow combining of additional files to the present printjob add a history button to the KJobViewer window and also a column to show the number of pages &CUPS; calculates for the job. + + +Finally, there will be an IO slave that will give you access to your print subsystem, via &konqueror; for example. With this you will soon be able to browse your print subsystem from &konqueror; through a &URL; like shortcut such as print://printers/printername. A KPart will add a virtual folder to the services section of the &konqueror; navigation panel, giving a nice integrated way to browse and manage your print system via the &URL; print:/manager. + +Please contact Michael Goffioul at kdeprint@swing.be with any further user or developer suggestions. + + + diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/index.cache.bz2 b/tde-i18n-en_GB/docs/kdebase/kdeprint/index.cache.bz2 new file mode 100644 index 00000000000..1130ee97102 Binary files /dev/null and b/tde-i18n-en_GB/docs/kdebase/kdeprint/index.cache.bz2 differ diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/index.docbook b/tde-i18n-en_GB/docs/kdebase/kdeprint/index.docbook new file mode 100644 index 00000000000..07ace5776b2 --- /dev/null +++ b/tde-i18n-en_GB/docs/kdebase/kdeprint/index.docbook @@ -0,0 +1,269 @@ + +KDEPrint"> + kprinter"> + CUPS"> + PPD"> + IPP"> + ghostscript"> + + + + + + + + + + + + + + + + + +]> + + + + +The &kdeprint; Handbook + + +Kurt Pfeifle
kpfeifle@danka.de
+ + + +Michael Goffioul
kdeprint@swing.be
+ +Developer + + +Lauri Watts
lauri@kde.org
+ +Reviewer + + +MalcolmHunter
malcolm.hunter@gmx.co.uk
Conversion to British English + + + + +2001 +Kurt Pfeifle + + +&FDLNotice; + +2001-08-09 +1.00.04 + + +This handbook describes &kdeprint;. &kdeprint; is not a standalone program. It is the new printing framework for &kde; 2.2. &kdeprint; is an intermediate layer between &kde; (or other) applications and the selected (and installed) print subsystem of your OS (&OS;). + + + +KDE +kdebase +kdeprint +print +printing +CUPS +LPR + + + + + +Introduction + +This handbook describes &kdeprint;. &kdeprint; is not a standalone program. It is the new printing framework for &kde; 2.2. &kdeprint; is an intermediate layer between &kde; (or other) applications and the selected (and installed) print subsystem of your OS (&OS;). + +It should be noted that both the developer of this application, and the author of this document are most familiar with &CUPS; as a printing system. At the time of writing, &CUPS; is the best supported printing subsystem, and it is the best documented. + +This handbook is a work in progress, and later versions of the &kdeprint; software and editions of this handbook will support and explore more closely other printing systems. + +In the meantime, even if your printing subsystem is not yet well covered, you are encouraged to explore the Printing Manager module in &kcontrol;, and you will find its operation to hopefully be fairly self evident, no matter what printing subsystem you use. + +Lauri Watts, &kde; documentation team + + + + +To configure your printing subsystem from &kcontrol; + +To configure your printing subsystem from &kcontrol;, go to SystemPrinting Manager and select your subsystem. Or you can let &kdeprint; try to determine it... + + +&CUPS; Printing Manager dialogue: overview via &kcontrol; + + + + +The dialogue to configure the &CUPS; server: security settings +Configuration of printing subsystem from &kcontrol; + + + + + + +&tech-overview-doc; + +&highlights-doc; + +&theory-doc; + +&getting-started-doc; + +&cups-configuration-doc; + +&add-printer-wizard-2-doc; + +&cupsoptions-presently-outside-kcontrol-doc; + +&rlpr-doc; + +&lpd-doc; + +&lpr-bsd-doc; + +&lprng-doc; + +&external-command-doc; + +&extensions-doc; + +&final-word-doc; + + +Credits And Licences + +&kdeprint; copyright 2001, Michael Goffioul kdeprint@swing.be +&underGPL; Documentation copyright 2001, Kurt Pfeifle, kpfeifle@danka.de &underFDL; Conversion to British English: Malcolm Hunter malcolm.hunter@gmx.co.uk + + + + + + diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/lpd.docbook b/tde-i18n-en_GB/docs/kdebase/kdeprint/lpd.docbook new file mode 100644 index 00000000000..8c39ba87173 --- /dev/null +++ b/tde-i18n-en_GB/docs/kdebase/kdeprint/lpd.docbook @@ -0,0 +1,27 @@ + +Generic <acronym +>LPD</acronym +> Module (&UNIX;) + + + +Overview of Provided Features + +Module used by default (on first start for example). + +Generic module that only allows sending of print jobs. No printer or job management supported. It is made to work on a wide variety of &UNIX; flavours: &Linux;/LPR, &HP-UX;, Solaris, &IRIX;. It also supports some LPRng extensions (like the absence of continuation character \ in printcap files). + + + diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/lpr-bsd.docbook b/tde-i18n-en_GB/docs/kdebase/kdeprint/lpr-bsd.docbook new file mode 100644 index 00000000000..9d6bcbbf86d --- /dev/null +++ b/tde-i18n-en_GB/docs/kdebase/kdeprint/lpr-bsd.docbook @@ -0,0 +1,37 @@ + +<acronym +>LPR</acronym +> (<acronym +>BSD</acronym +>) + +Plain (old?) LPR support. An LPRng module is in development, and hopefully available for 2.3 release. + + +Overview of Provided Features + + + +Printer management: basic support to add/remove/configure a printer, compatible with &RedHat;-6.x systems (printtool + rhs-printfilers packages). + + +Job management: not supported + + +Print options: basic control + + + + diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/lprng.docbook b/tde-i18n-en_GB/docs/kdebase/kdeprint/lprng.docbook new file mode 100644 index 00000000000..926cc08a8fe --- /dev/null +++ b/tde-i18n-en_GB/docs/kdebase/kdeprint/lprng.docbook @@ -0,0 +1,12 @@ + +<application +>LPRng</application +> + +An LPRng module for &kdeprint; is in development, and hopefully available for the &kde; 2.3 release. + + diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/rlpr.docbook b/tde-i18n-en_GB/docs/kdebase/kdeprint/rlpr.docbook new file mode 100644 index 00000000000..88b2ac1dd7b --- /dev/null +++ b/tde-i18n-en_GB/docs/kdebase/kdeprint/rlpr.docbook @@ -0,0 +1,24 @@ + +Module Built Around <application +>rlpr</application +> Utility + + +Overview of provided features + +Printer management: basic operations are supported (add/remove/modify). + +Each user can predefine the printers he wants to use by specifying the host and related printer queues. Printers are stored on a per user basis. This module is built around the rlpr utility rlpr + + + diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/tech-overview.docbook b/tde-i18n-en_GB/docs/kdebase/kdeprint/tech-overview.docbook new file mode 100644 index 00000000000..774f741317e --- /dev/null +++ b/tde-i18n-en_GB/docs/kdebase/kdeprint/tech-overview.docbook @@ -0,0 +1,346 @@ + +Technical Overview + +This chapter aims to give a technical overview of &kdeprint; which non-programmers can comprehend. + +&kdeprint; is a new and revolutionary tool to give easy access to printing services for both &kde; users and &kde; developers. + + +A Brief Description of &kdeprint; + +You can access the functions of &kdeprint; in different ways: through the Printing Manger in the &kcontrol;, through the kprinter command or through the dialogue that pops up if you want to print. + + +What it is <emphasis +>not</emphasis +> + +&kdeprint; is not a replacement for the printing subsystem itself. &kdeprint; does not therefore give provision for spooling, and it does not do the basic processing of &PostScript; or other print data. + + + + +What it <emphasis +>is</emphasis +> +&kdeprint; is an intermediate layer between the spooling and the data processing print subsystem (as installed), and the application that seeks to print. &kdeprint; provides a common interface for &kde; developers and &kde; users, to various supported print subsystems. At the same time, it is customisable, and highly configurable. + +&kdeprint; is easy to use for both &kde; developers and end-users. Developers can port their applications, with minimal changes, to use &kdeprint; instead of the old &Qt; print system. Users can easily choose and configure their print subsystem. + +For a reference to new &kde; users: &Qt; is the basic library and graphical toolkit, which is used by all &kde; applications; &Qt; is developed by TrollTech, a Norwegian software company. + + + + + + +&kdeprint; -- Different Usage for Different People + +&kdeprint; has different faces for different people. + + +What users and administrators can do with &kdeprint; + +&kdeprint; allows users and/or administrators, depending on their rights, access to printing subsystems (&CUPS;, LPD, RLPR, LPRng, PDQ &etc;) through a &kde; graphical user interface (&GUI;). Using &kdeprint;, they can print, administer jobs, printers and the printing daemon, all in a comfortable manner. + +Experienced users will like the capability to plug any working filter for the print data between the output of their application and the input, into the chosen print subsystem. Some examples for this already ship with plain vanilla &kdeprint;. Read on. + + + + + +What &kde; developers can do with it... + +If a &kde; developer needs printing access for his application, he does not code the printing functions from scratch. Before &kde; 2.2 this service was provided by the QPrinter class, a library function of the &Qt; Toolkit. The QPrinter class relied on the out-moded Line Printer Daemon (LPD). The &kdeprint; library bases itself firmly on the more modern Common &UNIX; Printing System (&CUPS;), while at the same time keeping backward compatibility with LPD and other legacy, or less elaborate, print systems. It also leaves the door open for any new development that might occur. + +For &kde; developers to use the new &kdeprint; class in their applications, they require only minimal changes to their code: for every call of QPrinter, they just need to change this to KPrinter. Replacing one (!) letter in a few spots, and automatically they are done; their application can then use all of the features of the new &kdeprint; library. + +More ambitious developers, or ones with special requirements, can do more: despite &kdeprint;'s feature-rich framework, they are still able to customise the print dialogue of their application by creating an additional Tab, where their extensions to the standard &kdeprint; will feel right at home. + + +This last mentioned feature has not been used widely inside &kde; so far, as developers are not yet fully aware of &kdeprint;'s power. Expect more of this in the near future. One example I discovered is the &kcron; application. It lets you edit the crontab through a &GUI;. The developers have implemented a printing feature that lets you (or root) choose if you want to print the whole of crontab (for all users) or just the part that is marked. You can see the effects on &kdeprint; in the following screenshots. + +This shot shows a sample from the &kcron; utility. +&kcron; utility: a small sample of a system's cronjobs as shown through the &kde; GUI&GUI;. + + + + +The &kcron; developers let you choose to print the whole of the cron table or just the marked part of it. + + + + +The dialogue to configure &kcron;'s printing options: the additional tab titled Cron Options is from inside &kcron;, not &kdeprint;; it is a special extension added by the &kcron; developers for printing purposes, not originating from, but executed by &kdeprint;. Developers of other applications are free to implement their own goodies, if they feel need for it. + + + +&kcron;'s addition to the &kdeprint; dialogue. + + + + +&kcron;'s addition to the &kdeprint; dialogue. + +&kcron;'s addition to the &kdeprint; dialogue. + + + + + + + +What &kdeprint; offers to everybody... + +&kdeprint;'s easy-to-use interface for all supported print subsystems of course does not eliminate basic traditional weaknesses of some of those systems. But it smooths some rough edges. Different users may use different printing systems on the same box. A user is free to even switch on the fly, from the print dialogue, the print subsystem to be used for the next job. (This is possible if different systems are installed in a way that they don't get in each other's way.) + +Most &UNIX; users are used to LPD printing. LPD provides only basic printing functions, is very inflexible and does not utilise the many options of more modern print systems like &CUPS;. While also working remotely over any distance (like every TCP/IP based protocol), LPD lacks bi-directional communication, authentication, access control and encryption support. + +&kdeprint; can use &CUPS; to support: + + + +Querying the LAN for available printers, + + +Basic, Digest, and Certificate Authentication, + + +Access Control based on IP addresses, net addresses, netmasks, host- and domain names, + + +and 128-Bit TLS or SSL3 encryption of print data, to prevent eavesdropping, or at least make it much more difficult. + + + +This makes &kdeprint; a much more robust and reliable solution than using the venerable LPD. + + + +How to access &kdeprint; + +You get access to &kdeprint;, or parts of it, in four different ways: + + +through your applications: if you call the printing dialogue (either File Print...) or the button with the little printer icon on it; this opens the printing dialogue. + +through the typed command kprinter in a terminal or a &konsole; window or from the Run Command... mini-CLI window: this also opens the printing dialogue. + +from the button, starting &kcontrol;, and then go to SystemPrinting Manager. This opens the &kdeprint; administration which is part of the &kcontrolcenter; and also lets you switch to other parts of the &kcontrol; + +from a command line (&konsole; or mini-CLI) type kcmshell . This opens just the &kdeprint; part of &kcontrol; to change your settings + + +&kprinter; dialogue to be started from Run Command... window + + + + +Starting the &kprinter; dialogue from a Run Command... window. +Starting the &kprinter; dialogue from a Run Command... window. + + + + Here is a &kivio; drawing of the &kprinter; dialogue as it pops up after being started... You can always add a new printer by clicking on the small Wizard button (marked red/yellow in this drawing). + + +&kprinter; dialogue started (&kivio; draft drawing) + + + + +&kprinter; dialogue started (&kivio; draft drawing) +&kprinter; dialogue started (&kivio; draft drawing) + + + + + + + + + + diff --git a/tde-i18n-en_GB/docs/kdebase/kdeprint/theory.docbook b/tde-i18n-en_GB/docs/kdebase/kdeprint/theory.docbook new file mode 100644 index 00000000000..77421885153 --- /dev/null +++ b/tde-i18n-en_GB/docs/kdebase/kdeprint/theory.docbook @@ -0,0 +1,688 @@ + +Some Theoretical Background: &CUPS;, <acronym +>IPP</acronym +>, &PostScript; and <application +>Ghostscript</application +> + +This chapter aims to give a bit of theoretical background to printing in general, and to &CUPS; especially. If you are not in need of this, you might like to skip ahead to the next chapter. Chances are you will come back to this chapter at some point anyway, because sometimes one needs extra theory to solve a practical problem. + + +Basics About Printing + +Printing is one of the more complicated chapters in IT technology. + + +Earlier on in history, every developer of a program that was capable of producing printable output had to write his own printer drivers too. That was quite complicated, because different programs have different file formats. Even programs with the same purpose, for example: word processors, often do not understand each other's formats. There was therefore no common interface to all printers, hence the programmers often supported only a few selected models. + +A new device appearing on the market required the program authors to write a new driver if they wanted their program to support it. Also for manufacturers, it was impossible to make sure their device was supported by any program known to the world (although there were far fewer than today). + +Having to support ten application programs and a dozen printers, meant a system administrator had to deal with 120 drivers. So the development of unified interfaces between programs and printers became an urgent need. + +The appearance of Page Description Languages, describing the graphical representation of ink and toner on sheets of paper (or other output devices, like monitors, photo typesetters, &etc;) in a common way, was a move that filled a big gap. + +One such development was &PostScript; by Adobe. It meant that an application programmer could concentrate on making his program generate a &PostScript; language description of his printable page, while printing device developers could focus on making their devices &PostScript; literate. + +Of course, over time, there came the development of other description methods. The most important competitors to &PostScript; were PCL (Print Control Language, from &Hewlett-Packard;), ESC/P (from Epson) and GDI (Graphical Device Interface from &Microsoft;). + +The appearance of these page description languages made life easier, and facilitated further development for everybody. Yet the fact that there still remained different, incompatible, and competing page description languages keeps life for users, administrators, developers and manufacturers difficult enough. + + +&PostScript; in memory - Bitmaps on Paper + +&PostScript; is most heavily used in professional printing environments such as PrePress and printing service industries. In the &UNIX; and &Linux; domains, &PostScript; is the predominant standard as a PDL. Here, nearly every program generates a &PostScript; representation of its pages once you push the Print button. Let us look at a simple example of (hand-made) &PostScript; code. The following listing describes two simple drawings: + + +&PostScript; Code +%!PS +100 100 moveto +0 50 rlineto +50 0 rlineto +0 -50 rlineto +closepath +.7 setgray fill +% first box over; next +160 100 moveto +0 60 rlineto +45 10 rlineto +0 -40 rlineto +closepath +.2 setgray fill + + +This tells the imaginary &PostScript; pen to draw a path of a certain shape, and then fill it with different shades of grey. The first part translates into more comprehensive English as Go to coordinate (100,100), draw a line with length 50 upward; then one from there to the right, then down again, and finally close this part. Now fill the drawn shape with 70% darkness grey. + + +Rendered &PostScript; + + + + + + example rendered as an image. + + + + +Of course, &PostScript; can be much more complicated than this simplistic example. It is a fully fledged programming language with many different operators and functions. You may even write &PostScript; programs to compute the value of Pi, format a hard disk or write to a file. The main value and strength of &PostScript; however lies in the field to describe the layout of graphical objects on a page: it also can scale, mirror, translate, transform, rotate and distort everything you can imagine on a piece of paper -- such as letters in different font representations, figures, shapes, shades, colours, lines, dots, raster... + +A &PostScript; file is a representation of one or more pages to be printed, in a relatively abstract way. Ideally, it is meant to describe the pages in a device-independent way. &PostScript; is not directly visible; it only lives on hard disks and in RAM as a coded representation of future printouts. + + + + +Raster Images on Paper Sheets + +What you see on a piece of paper is nearly always a raster image. Even if your brain suggests to you that your eyes see a line: take a good magnifying glass and you will discover lots of small dots... (One example to the contrary are lines that have been drawn by pen plotters). And that is the only thing that the marking engines of today's printers can put on paper: simple dots of different colours, size and resolution, to make up a complete page image composed of different bitmap patterns. + +Different printers need the raster image prepared in different ways. Thinking about an inkjet device: depending on its resolution, the number of inks used (the very good ones need 7 different inks, while cheaper ones might only use 3), the number of available jets (some print heads have more than 100!) dispensing ink simultaneously, the dithering algorithm used, and many other things, the final raster format and transfer order to the marking engine is heavily dependent on the exact model used. + +Back in the early life of the Line Printer Daemon, printers were machines that hammered rows of ASCII text mechanically on to long media, folded as a zig-zag paper snake, drawn from a cardboard box beneath the table... What a difference from today! + + + + + +<acronym +>RIP</acronym +>: From &PostScript; to Raster + +Before the final raster images are put on paper cut-sheets, they have to be calculated somehow out of their abstract &PostScript; representation. This is a very computing-intensive process. It is called the Raster Imaging Process, more commonly RIP). + +With &PostScript; printers the RIP-ping is taken care of by the device itself. You just send the &PostScript; file to it. The Raster Imaging Processor (also called the RIP) inside the printer is responsible (and specialized) to fulfill quite well this task of interpreting the &PostScript;-page descriptions and put the raster image on paper. + +Smaller &PostScript; devices have a hardware-RIP built in; it is etched in silicon, on a special chip. Big professional printers often have their RIP implemented as a software-RIP inside a dedicated fast &UNIX; run computer, often a Sun SPARC Solaris or a &SGI; &IRIX; machine. + + + + +<application +>Ghostscript</application +> as a Software <acronym +>RIP</acronym +> + +But what happens, if you are not lucky enough to have a &PostScript; printer available? + +You need to do the RIP-ing before you send the print data to the marking engine. You need to digest the &PostScript; generated by your application on the host machine (the print client) itself. You need to know how the exact raster format of the target printer's marking engine must be composed. + +In other words, as you can't rely on the printer to understand and interpret the &PostScript; itself, the issue becomes quite a bit more complicated. You need software that tries to solve for you the issues involved. + +This is exactly what the omnipresent &ghostscript; package is doing for many &Linux;, *BSD and other &UNIX; boxes that need to print to non-&PostScript; printers: &ghostscript; is a &PostScript; interpreter, a software RIP capable of running many different devices. + + + + +<quote +>Drivers</quote +> and <quote +>Filters</quote +> in General + +To produce rasterised bitmaps from &PostScript; input, the concept of filters is used by &ghostscript;. There are many different filters in &ghostscript;, some of them specialised for a certain model of printer. &ghostscript; filterspecializedin devices have often been developed without the consent or support of the manufacturer concerned. Without access to the specifications and documentation, it was a very painstaking process to reverse engineer protocols and data formats. + +Not all &ghostscript; filters work equally well for their printers. Yet, some of the newer ones, like the stp Filter of the Gimp Print project, produce excellent results leading to photographic quality on a par or even superior to their &Microsoft; &Windows; driver counterparts. + +&PostScript; is what most application programs produce for printing in &UNIX; and &Linux;. Filters are the true workhorses of any printing system there. Essentially they produce the right bitmaps from any &PostScript; input for non-&PostScript; target engines. + + + + +Drivers and Filters and Backends in CUPS + +&CUPS; uses its own filters, though the filtering system is based on Ghostscript. Namely the pstoraster and the imagetoraster filters are directly derived from Ghostscript code. &CUPS; has reorganised and streamlined the whole mechanics of this legacy code and organised it into a few clear and distinct modules. + +This next drawing (done with the help of &kivio;) gives an overview of the filters and backends inside &CUPS; and how they fit together. The flow is from top to bottom. Backends are special filters: they don't convert date to a different format, but they send the ready files to the printer. There are different backends for different transfer protocols. + + +&kprinter; dialogue started (&kivio; draft drawing) + + + + +&kprinter; dialogue started (&kivio; draft drawing) + + + + + +Spoolers and Printing Daemons + +Besides the heavy part of the filtering task to generate a print-ready bitmap, any printing software needs to use a SPOOLing mechanism: this is to line up different jobs from different users for different printers and different filters and send them accordingly to the destinations. The printing daemon takes care of all this. + +This daemon is keeping the house in order: it is also responsible for the job control: users should be allowed to cancel, stop, restart, &etc; their jobs (but not other peoples's jobs) and so on. + + + + + + + + +Excursion: How <quote +>CUPS</quote +> uses the power of &PPD;s + +Now that you know how a &PostScript; language file (which describes the page layout in a largely device independent way) is transformed into a Raster Image, you might ask: Well, there are different kinds of raster output devices: first they differ in their resolution; then there are the different paper sizes; it goes on with many finishing options (duplex prints, pamphlets, punched and stapled output with different sheets of coloured paper being drawn from different trays, &etc;). How does this fit into our model of device-independent &PostScript;? + +The answer comes with so called &PostScript; Printer Description (&PPD; files. A &PPD; describes all the device dependent features which can be utilised by a certain printer model. It also contains the coded commands that must be used to call certain features of the device. But &PPD;s are not a closed book, they are simple ASCII text files. + +&PPD;s were invented by Adobe to make it easy for manufacturers to implement their own features into &PostScript; printers, and at the same time retain a standard way of doing so. &PPD;s are well documented and described by Adobe. Their specification is a de-facto open standard. + + +Device Dependent Print Options + +Remember, advanced &PostScript; printing was originally only developed for use on &Microsoft; &Windows; and Apple &Mac; systems. For a long time, all of the feature rich printing on modern devices was simply unavailable for &Linux; and &UNIX;. &CUPS; changes this decisively. &CUPS; is closely tied with &PPD;s, and therefore existing &PPD;s can be utilised to the full by all systems powered by &CUPS;. + +Using &PPD;s, printer manufacturers were able to insert device-specific hardware features into their products, for features such as duplexing, stapling, punching, finishing, &etc;. The printer drivers load this &PPD; just like an additional configuration file. Thus the printer driver learns about the available device options and how to call them; the driver also presents them in a &GUI; to the user. Through this mechanism you are still able to print device-independent &PostScript; page description language files and specify device-dependent finishing options on top, which are added to the application-generated &PostScript;. + + + + +Where to get the &PPD;s for &PostScript; Printers + +&PPD;s originally were not used routinely in &UNIX; and &Linux; systems. The vendors providing those &PPD;s never intended them for anything other than the originally supported &OS;s: &Microsoft; &Windows; and &MacOS;. Through its brilliant move to fully support and utilise the existing &PPD; specification, &CUPS; now gives the power to use all features of modern printers to users of &Linux; and &Linux;-like systems. &kdeprint; makes its usage even more comfortable than the &CUPS; developers ever dreamed of. + +&CUPS; can use original &Windows; &PPD;s, distributed by the vendors in the case of &PostScript; printers. Those normally don't cost any money, and they can be grabbed from any &Windows; computer with an installed &PostScript; driver for the model concerned, or from the disks provided with the printer. There are also several places on the web to download them. + + + + +How Special &PPD;s are Now Useful Even For Non-&PostScript; Printers. + +Now you know how &PostScript;-Printers can use &PPD;s. But what about non-&PostScript; printers? &CUPS; has done a very good trick: by using the same format and data structure as the &PostScript; Printer Descriptions (&PPD;s) in the &PostScript; world, it can describe the available print job options for non-&PostScript; printers just the same. For its own special purposes &CUPS; just added a few special options (namely the line which defines the filter to be used for further processing of the &PostScript; file). + +So, the developers could use the same software engine to parse the Printer Description Files for available options for all sorts of printers. Of course the &CUPS; developers could not rely on the non-&PostScript; hardware manufacturers to suddenly develop &PPD;s. They had to do the difficult start themselves and write them from scratch. More than 1000 of these are available through the commercial version of &CUPS;, called ESP PrintPro. + +Meanwhile there are a lot of &CUPS;-specific &PPD;s available. Even now those are in most cases not originating from the printer manufacturers, but from Free software developers. The &CUPS; folks proofed it, and others followed suit: where &Linux; and &UNIX; printing one or two years ago still was a kludge, it is now able to support a big range of printers, including 7-colour inkjets capable of pushing them to Photo Quality output. + + + + +Different Ways to get &PPD;s for non-&PostScript; Printers + +You can get &PPD;s to be used with &CUPS; and non-&PostScript; printers from different areas in the Web: + + + +first, there is the repository at www.linuxprinting.org, which lets you generate a CUPS-O-Matic-&PPD; online for any printer that had been supported by traditional &ghostscript; printing already. This helps you to switch over to &CUPS; with little effort, if you wish so. If your printer was doing well with the traditional way of &ghostscript; printing, take CUPS-O-Matic to plug your driver into the &CUPS; system and you'll have the best of both worlds. + + + +second, there are &CUPS;-&PPD;s for the more than 120 printer models, which are driven by the new universal stp driver. stp (stood originally for Stylus Photo) is now developed by the gimp-print project; it was started by Mike Sweet, the leading &CUPS; developer and is now available through gimp-print.sourceforge.net. This driver prints real Photo quality on many modern inkjets and can be configured to make 120 &CUPS;-&PPD;s along its own compilation. &HP; Laser- and DeskJet, Epson Stylus and Photo Colour models as well as some Canon and Lexmark are covered. + + + +third, there is the commercial extension to &CUPS; from the &CUPS; developers themselves: it is called ESP PrintPro and comes with more than 2.300 printer drivers. There are even improved imagetoraster and pstoraster filters included. + + + +&CUPS; makes it really easy for manufacturers to start supporting &Linux; and &UNIX; printing for their models at reasonably low cost. The modular framework of &CUPS; facilitates to plug in any filter (=driver) with minimal effort and to access and utilise the whole printing framework that &CUPS; is creating. + +Read more about the exciting &CUPS; features in the available &CUPS; documentation at http://www.cups.org/documentation.html and http://www.danka.de/printpro/faq.html. Also at http://www.linuxprinting.org/ is a universal repository for all issues related to &Linux; and &UNIX; printing. + + + + + + +How &IPP; Support Makes &CUPS; the Best Choice Around + + +<quote +><acronym +>LPD</acronym +> Must Die!</quote +> + +For a long time many developers were deeply dissatisfied with good old LPD. Quite a few new projects were started to improve printing: LPRng is the best known example. Others are PDQ, PPR, PLP, GNUlpr and RLPR. But none of the new programs were seen as a big shot; most of them are just implementing the same old LPD specification with a few (or many) new extensions, which again make them incompatible with each other. + +Having seen the development of not just one, but different viable alternatives to venerable BSD-style LPD, Grant Taylor, author of the Linux Printing HOWTO, finally rallied the call LPD Must Die! in his Campaign To Abolish The Line Printer Daemon. + + + + + + +How the &IPP; Came to Be + +Along with the above, on the industry side of things, there were efforts to overcome the well-known weaknesses of LPD. It started with proprietary extensions to plain old LPD, and stretched as far as &Hewlett-Packard;'s attempt to establish &HP; JetDirect as a new standard for a network printing protocol. The result were even more incompatibilities. + +In the end, an initiative to define a new common industry and IETF standard took shape. The Printer Working Group or PWG, a loose aggregation of vendors in hardware, software, and operating systems, drafted the new Internet Printing Protocol, &IPP;. &IPP; v1.1 has now been approved by the IETF (Internet Engineering Task Force) as a proposed standard, and now enjoys the unanimous support throughout the industry in Europe, USA and Japan. Most current network printer models have now built in &IPP; support on top of traditional LPR/LPD or JetDirect Printing. + + + + +Why &IPP; is Solving Many Problems + +&IPP; promises to solve a lot of problems network administrators face. This trade normally deals with heterogeneous network environments and spends more than half of its working hours dealing with printing problems. + +By creating a unified set of query functions for &IPP; enabled printers and servers, for transferring files and setting job-control attributes &etc;, &IPP; is destined to work across all &OS; platforms. It's rollout however, will not happen overnight, as many legacy print devices will still be in use for many years to come. Therefore, in &IPP; there is a provision made for backwards compatibility of all &IPP; implementations. &CUPS; is proving the viability of &IPP; printing in all environments. + +The most striking advantage will be it's integration into the existing set of other robust IP protocols. Being an extension of the proven and robust HTTP 1.1 protocol, for the special task of handling print file and related data, it is also very easy to plug in other standards as they are being developed and deployed: + + + +Basic, Digest, and Certificate Authentication for users seeking access to print services. + + +SSL3 and TLS encryption for transferring data. + + +Bi directional communication of clients with print devices, using the HTTP/&IPP; GET and POST mechanism. + + +LDAP directory service integration to keep a consistent database of available printers, their capabilities and page-costs, &etc;, as well as user passwords, ACLs &etc;. + + +Pull (as opposed to the usual Push model) printing, where a server or printer just needs to be told the &URL; of a document, whereupon it is retrieved from the resource on the internet and printed. + + + + + + + + +Printer <quote +>Plug'n'Play</quote +> for Clients + +Have you ever seen a demonstration about &CUPS; capabilities in the network? You must have been quite impressed if you didn't know in advance what to expect. + +Imagine you as the administrator of a LAN. For testing purposes you fully installed one &kde;/&CUPS; box on your net, complete with a dozen printers configured and functional: &PostScript;, LaserJets, InkJets and BubbleJets, and so on. Your &kde; users on that box are very happy, they can print like never before, ringing all the bells and whistles of every printer. It took you 2 hours to make everything run perfectly... and now all the other 100 users on the network want the same. Two hours again for every box? No way you could do that before next year, you think? + +Wrong. Just change one setting in the original &CUPS; box to make it a server. Install &CUPS; on five other boxes, as clients. By the time you turn back to your first client, you find the users happily playing with the settings for the dozen printers you had defined earlier on the server. Somehow magically the printers had appeared on all the Print dialogues of the five new &CUPS; client boxes. + +Your users print, but not a single driver had been installed on the clients, nor a printer queue defined. + +So, how does this magic work? + + + + +<quote +>Seeing</quote +> Printers Not Installed Locally? + +The answer is not complicated at all. + +If a &CUPS; server is on the LAN, it broadcasts the names of all available printers to the LAN, using the UDP protocol and port 631. Port 631 is reserved as a well-known port by IANA (the Internet Assigning Numbers Authority) for &IPP; purposes. All &CUPS; clients listen to &CUPS; server info sent to their port 631. That's how they know about available printers, and that's how they learn about the path to the printers as well. + +Using &IPP;, which is really a clever extension to HTTP v1.1, &CUPS; is able to address all objects related to the printing system via Universal Resource Locators or URLs. Print jobs to be deleted or restarted, printers to be queried or modified, admin tasks to be performed on the server, with &IPP; and &CUPS;, everything is addressable by a certain URL. Many important things can be done through the web interface to &CUPS;, accessible for example with &konqueror;. + + + + +Printing Without Installing a Driver + +And more, the clients basically can administer and use any printer they see, just as if it was a locally installed one. Of course, you can set restrictions on it with access control lists &etc;, so that not any clients may use any printer as it likes. + +The clients even are able to print without the appropriate filter (or driver) installed locally. + +So how does this work? If a client wants to know about and select printer-specific options, it sends a request (called CUPS-get-ppd) to the server. The server tells the client all about all printer-specific options, as read from the server side &PPD;. The user on the client side can see the options and select the required ones. He then sends the print file, usually unfiltered raw &PostScript;, spiced up with the printer-options to the printer server, using &IPP; as the transport protocol. All further processing, especially the filtering to generate the final format for the target printer, is then done by the server. The server has the necessary programs (drivers or filters) to do this. + +This way a client prints without needing to install a driver locally. + +Any change on the server, such as adding or modifying a printer, is instantly known to the clients with no further configuration. + + + + +<quote +>Zero Administration</quote +>, Load Balancing, and <quote +>Failover Switching</quote +> + +Some other advanced features built into &CUPS; are the capacity to do load balancing. + +If you define the same printer queues on two or more different servers, the clients will send their jobs to the first responding or available server. This implies an automatic load balancing amongst servers. If you have to take one server off the network for maintenance, the others will just take over its tasks without the users even noticing the difference. + + + + + + -- cgit v1.2.1