midipix / build / midipix_build

Forked from build/midipix_build 4 years ago
Clone

Blame patches/xorgproto-2018.4.local.patch

Lucio Andrés Illanes Albornoz bbde6e
diff -Nru xorgproto-2018.4.orig/man/Xprint.man xorgproto-2018.4/man/Xprint.man
Lucio Andrés Illanes Albornoz bbde6e
--- xorgproto-2018.4.orig/man/Xprint.man	1970-01-01 01:00:00.000000000 +0100
Lucio Andrés Illanes Albornoz bbde6e
+++ xorgproto-2018.4/man/Xprint.man	2018-07-29 01:06:04.000000000 +0200
Lucio Andrés Illanes Albornoz bbde6e
@@ -0,0 +1,421 @@
Lucio Andrés Illanes Albornoz bbde6e
+.\" -*- coding: us-ascii -*-
Lucio Andrés Illanes Albornoz bbde6e
+.TH Xprint __miscmansuffix__ "8 October 2004"
Lucio Andrés Illanes Albornoz bbde6e
+.SH NAME
Lucio Andrés Illanes Albornoz bbde6e
+Xprint \- The "X print service" - a portable, network-transparent printing system based on the X11 protocol
Lucio Andrés Illanes Albornoz bbde6e
+.SH SYNOPSIS
Lucio Andrés Illanes Albornoz bbde6e
+Xprint is a very flexible, extensible, scaleable, client/server
Lucio Andrés Illanes Albornoz bbde6e
+print system based on ISO 10175 (and some other specs) and the X11
Lucio Andrés Illanes Albornoz bbde6e
+rendering protocol.
Lucio Andrés Illanes Albornoz bbde6e
+Using Xprint an application can search, query and use devices like
Lucio Andrés Illanes Albornoz bbde6e
+printers, FAX machines or create documents in formats like PDF.
Lucio Andrés Illanes Albornoz bbde6e
+In particular, an application can seek a printer, query supported
Lucio Andrés Illanes Albornoz bbde6e
+attributes (like paper size, trays, fonts etc.), configure the printer
Lucio Andrés Illanes Albornoz bbde6e
+device to match it\(cqs needs and print on it like on any other X device
Lucio Andrés Illanes Albornoz bbde6e
+reusing parts of the code which is used for the video card Xserver.
Lucio Andrés Illanes Albornoz bbde6e
+.SH OVERVIEW
Lucio Andrés Illanes Albornoz bbde6e
+The "X Print Service" technology allows X rendering to devices such as
Lucio Andrés Illanes Albornoz bbde6e
+printers and fax. Most of the service is available in the X11
Lucio Andrés Illanes Albornoz bbde6e
+technology stack as Xp, with the remainder in single toolkit stacks (e.g. DtPrint for CDE).
Lucio Andrés Illanes Albornoz bbde6e
+Modifications have also been made to the LessTif/Motif/Qt technology
Lucio Andrés Illanes Albornoz bbde6e
+stacks to support Xprint.
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+The Xp portion consists of:
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.2i
Lucio Andrés Illanes Albornoz bbde6e
+\(bu
Lucio Andrés Illanes Albornoz bbde6e
+Xp Extension for the X-Server (included in the X-Server Xprt)
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.2i
Lucio Andrés Illanes Albornoz bbde6e
+\(bu
Lucio Andrés Illanes Albornoz bbde6e
+Xp Extension API for the client side (libXp/libXprintUtils)
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.2i
Lucio Andrés Illanes Albornoz bbde6e
+\(bu
Lucio Andrés Illanes Albornoz bbde6e
+PCL ddx driver that converts core X to native PCL
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.2i
Lucio Andrés Illanes Albornoz bbde6e
+\(bu
Lucio Andrés Illanes Albornoz bbde6e
+PDF ddx driver that converts core X to native PDF
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.2i
Lucio Andrés Illanes Albornoz bbde6e
+\(bu
Lucio Andrés Illanes Albornoz bbde6e
+PostScript ddx driver that converts core X to native PostScript
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.2i
Lucio Andrés Illanes Albornoz bbde6e
+\(bu
Lucio Andrés Illanes Albornoz bbde6e
+Raster ddx driver that generates xwd rasters which can be converted to PCL, PDF or PostScript rasters
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+From an X clients perspective, it can attach to one of two nearly
Lucio Andrés Illanes Albornoz bbde6e
+identical X-Servers, a "Video" X-Server, and a "Print" X-Server
Lucio Andrés Illanes Albornoz bbde6e
+which has the additional Xp capability but otherwise looks and
Lucio Andrés Illanes Albornoz bbde6e
+behaves the same.
Lucio Andrés Illanes Albornoz bbde6e
+.SH "HOW THE X PRINT SERVICE WORKS"
Lucio Andrés Illanes Albornoz bbde6e
+The X Print Service expands on the traditional X-Server and Xlib world
Lucio Andrés Illanes Albornoz bbde6e
+in four ways.
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.4i
Lucio Andrés Illanes Albornoz bbde6e
+1.
Lucio Andrés Illanes Albornoz bbde6e
+Most obvious is the use of "print ddx drivers" instead of
Lucio Andrés Illanes Albornoz bbde6e
+"video ddx drivers". While a video ddx driver modifies pixels
Lucio Andrés Illanes Albornoz bbde6e
+in a video frame buffer, a print ddx driver generates "page
Lucio Andrés Illanes Albornoz bbde6e
+description language (PDL)" output (such as PCL, PDF or PostScript)
Lucio Andrés Illanes Albornoz bbde6e
+or sends the print rendering instructions to a platform-specific
Lucio Andrés Illanes Albornoz bbde6e
+print API (like Win32/GDI).
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+Once a print ddx driver generates PDL output, it can be sent to
Lucio Andrés Illanes Albornoz bbde6e
+a spooler such as \fBlp\fR(1)
Lucio Andrés Illanes Albornoz bbde6e
+or retrieved by the client (to implement functionality like "print-to-file").
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+Though not currently done, a single X-Server can support both
Lucio Andrés Illanes Albornoz bbde6e
+print and video ddx drivers.
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.4i
Lucio Andrés Illanes Albornoz bbde6e
+2.
Lucio Andrés Illanes Albornoz bbde6e
+Since printers support "paged" output, unlike video, a portion
Lucio Andrés Illanes Albornoz bbde6e
+of the Xp Extension supports APIs to delineate printed output.
Lucio Andrés Illanes Albornoz bbde6e
+For example, XpStartPage and XpEndPage tell the X-Server where
Lucio Andrés Illanes Albornoz bbde6e
+a physical page starts and ends in an otherwise continuous
Lucio Andrés Illanes Albornoz bbde6e
+stream of X rendering primitives. Likewise, XpStartJob and
Lucio Andrés Illanes Albornoz bbde6e
+XpEndJob determine when a collection of pages starts and ends.
Lucio Andrés Illanes Albornoz bbde6e
+XpEndJob typically causes the generated PDL to be submitted to
Lucio Andrés Illanes Albornoz bbde6e
+a spooler, such as \fBlp\fR(1).
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.4i
Lucio Andrés Illanes Albornoz bbde6e
+3.
Lucio Andrés Illanes Albornoz bbde6e
+Since printers have extensive capabilities, another portion of
Lucio Andrés Illanes Albornoz bbde6e
+the Xp Extension supports APIs to manipulate "print contexts".
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+Once a printer is selected using the Xp Extension API, a print
Lucio Andrés Illanes Albornoz bbde6e
+context to represent it can be created. A print context
Lucio Andrés Illanes Albornoz bbde6e
+embodies the printer selected - it contains the printer's
Lucio Andrés Illanes Albornoz bbde6e
+default capabilities, selectable range of capabilities,
Lucio Andrés Illanes Albornoz bbde6e
+printer state, and generated output. Some "attributes" within
Lucio Andrés Illanes Albornoz bbde6e
+the print context can be modified by the user, and the
Lucio Andrés Illanes Albornoz bbde6e
+X-Server and print ddx driver will react accordingly. For
Lucio Andrés Illanes Albornoz bbde6e
+example, the attribute "content-orientation" can be set to
Lucio Andrés Illanes Albornoz bbde6e
+"landscape" or "portrait" (if the printer supports these
Lucio Andrés Illanes Albornoz bbde6e
+values - which can be queried using the Xprint API as well).
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.4i
Lucio Andrés Illanes Albornoz bbde6e
+4.
Lucio Andrés Illanes Albornoz bbde6e
+Since printers can have "built in" fonts, the Xp Extension in
Lucio Andrés Illanes Albornoz bbde6e
+the X-Server works with the print ddx drivers to make
Lucio Andrés Illanes Albornoz bbde6e
+available (for printing only) additional fonts on a per print
Lucio Andrés Illanes Albornoz bbde6e
+context basis.
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+When a print context is created and set for a given printer,
Lucio Andrés Illanes Albornoz bbde6e
+the X font calls may be able to access additional printer
Lucio Andrés Illanes Albornoz bbde6e
+fonts. To do this (typically), the X-Server must have access
Lucio Andrés Illanes Albornoz bbde6e
+to "printer metric files" (.pmf) that describe at minimum the
Lucio Andrés Illanes Albornoz bbde6e
+metrics of the built in fonts.
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+.SH USAGE
Lucio Andrés Illanes Albornoz bbde6e
+There are three tasks to start the X Print Service:
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.4i
Lucio Andrés Illanes Albornoz bbde6e
+1.
Lucio Andrés Illanes Albornoz bbde6e
+configuring the X Print Server,
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.4i
Lucio Andrés Illanes Albornoz bbde6e
+2.
Lucio Andrés Illanes Albornoz bbde6e
+starting the X Print Service
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.4i
Lucio Andrés Illanes Albornoz bbde6e
+3.
Lucio Andrés Illanes Albornoz bbde6e
+configuring the user session so that clients can find the running X Print Service
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+The tasks are described in detail below.
Lucio Andrés Illanes Albornoz bbde6e
+.SH "SERVER CONFIGURATION"
Lucio Andrés Illanes Albornoz bbde6e
+The X Print Server (Xprt) can read a number of configuration files which
Lucio Andrés Illanes Albornoz bbde6e
+control its behavior and support for printers. Each vendor platform has
Lucio Andrés Illanes Albornoz bbde6e
+a default location for this information. Xprt can also read the
Lucio Andrés Illanes Albornoz bbde6e
+environment variable \fBXPCONFIGDIR\fR to locate alternate configuration
Lucio Andrés Illanes Albornoz bbde6e
+directories. Common settings include:
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+export XPCONFIGDIR=/X11/lib/X11/XpConfig/
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+export XPCONFIGDIR=/proj/x11/xc/programs/Xserver/XpConfig/
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+Xprt has many built-in defaults, and lacking any configuration files,
Lucio Andrés Illanes Albornoz bbde6e
+will immediately try to support all printers visible via \fBlpstat\fR(1).
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+In order of importance for configuration by a system administrator, the
Lucio Andrés Illanes Albornoz bbde6e
+configuration files for a "C" locale are as follows (see \fBXprt\fR(__appmansuffix__) for more
Lucio Andrés Illanes Albornoz bbde6e
+details (including support for non-"C" locales)):
Lucio Andrés Illanes Albornoz bbde6e
+.TP
Lucio Andrés Illanes Albornoz bbde6e
+\fB${XPCONFIGDIR}/C/print/Xprinters\fR
Lucio Andrés Illanes Albornoz bbde6e
+\&'Xprinters' is the top most configuration file. It tells
Lucio Andrés Illanes Albornoz bbde6e
+Xprt which specific printer names (e.g. mylaser) should
Lucio Andrés Illanes Albornoz bbde6e
+be supported, and whether \fBlpstat\fR(1) or other commands
Lucio Andrés Illanes Albornoz bbde6e
+should be used to automatically supplement the list of
Lucio Andrés Illanes Albornoz bbde6e
+printers.
Lucio Andrés Illanes Albornoz bbde6e
+.TP
Lucio Andrés Illanes Albornoz bbde6e
+\fB${XPCONFIGDIR}/C/print/attributes/printer\fR
Lucio Andrés Illanes Albornoz bbde6e
+The 'printer' file maps printer names to model
Lucio Andrés Illanes Albornoz bbde6e
+configurations (see 'model-config' below). For example,
Lucio Andrés Illanes Albornoz bbde6e
+"mylaser" could be mapped to a "HPDJ1600C", and all other
Lucio Andrés Illanes Albornoz bbde6e
+arbitrary printers could be mapped to a default, such as
Lucio Andrés Illanes Albornoz bbde6e
+"HPLJ4SI". When depending on \fBlpstat\fR(1) in the Xprinters
Lucio Andrés Illanes Albornoz bbde6e
+file, setting up defaults in 'printer' becomes all the
Lucio Andrés Illanes Albornoz bbde6e
+more important.
Lucio Andrés Illanes Albornoz bbde6e
+.TP
Lucio Andrés Illanes Albornoz bbde6e
+\fB${XPCONFIGDIR}/C/print/attributes/document\fR
Lucio Andrés Illanes Albornoz bbde6e
+The 'document' file specifies the initial document values
Lucio Andrés Illanes Albornoz bbde6e
+for any print jobs. For example, which paper tray to
Lucio Andrés Illanes Albornoz bbde6e
+use, what default resolution, etc.
Lucio Andrés Illanes Albornoz bbde6e
+.TP
Lucio Andrés Illanes Albornoz bbde6e
+\fB${XPCONFIGDIR}/C/print/attributes/job\fR
Lucio Andrés Illanes Albornoz bbde6e
+The 'job' file specifies the initial job values for any
Lucio Andrés Illanes Albornoz bbde6e
+print jobs. For example, "notification-profile" can be
Lucio Andrés Illanes Albornoz bbde6e
+set so that when a print job is successfully sent to a
Lucio Andrés Illanes Albornoz bbde6e
+printer, e-mail is sent to the user.
Lucio Andrés Illanes Albornoz bbde6e
+.TP
Lucio Andrés Illanes Albornoz bbde6e
+\fB${XPCONFIGDIR}/C/print/models/PSdefault/model\-config\fR, \fB${XPCONFIGDIR}/C/print/models/PSdefault/fonts/fonts.dir\fR, \fB${XPCONFIGDIR}/C/print/models/PSdefault/fonts/9nb00051.pmf\fR, \fB${XPCONFIGDIR}/C/print/models/PSdefault/fonts/9nb00093.pmf\fR
Lucio Andrés Illanes Albornoz bbde6e
+The 'model-config' file has attributes that describe the
Lucio Andrés Illanes Albornoz bbde6e
+printer model\(cqs capabilities and default settings.
Lucio Andrés Illanes Albornoz bbde6e
+Printer model fonts may also be present. The model-config
Lucio Andrés Illanes Albornoz bbde6e
+file also identifies the print ddx driver to be used.
Lucio Andrés Illanes Albornoz bbde6e
+For each printer model supported, a complete hierarchy of
Lucio Andrés Illanes Albornoz bbde6e
+files should exist. In most cases, these files do not
Lucio Andrés Illanes Albornoz bbde6e
+need to be modified.
Lucio Andrés Illanes Albornoz bbde6e
+.TP
Lucio Andrés Illanes Albornoz bbde6e
+\fB${XPCONFIGDIR}/C/print/ddx\-config/raster/pcl\fR, \fB${XPCONFIGDIR}/C/print/ddx\-config/raster/pdf\fR, \fB${XPCONFIGDIR}/C/print/ddx\-config/raster/postscript\fR
Lucio Andrés Illanes Albornoz bbde6e
+The print ddx drivers can have highly specific
Lucio Andrés Illanes Albornoz bbde6e
+configuration files to control their behavior. In most
Lucio Andrés Illanes Albornoz bbde6e
+cases, these files do not need to be modified.
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+More information in how to configure and customize the X print server can be found in the
Lucio Andrés Illanes Albornoz bbde6e
+\fBXprt\fR(__appmansuffix__)
Lucio Andrés Illanes Albornoz bbde6e
+manual page.
Lucio Andrés Illanes Albornoz bbde6e
+.SH "STARTING UP"
Lucio Andrés Illanes Albornoz bbde6e
+The summary checklist for starting the X Print Service is as follows:
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.4i
Lucio Andrés Illanes Albornoz bbde6e
+1.
Lucio Andrés Illanes Albornoz bbde6e
+Choose an execution model for the X Print Service. The X
Lucio Andrés Illanes Albornoz bbde6e
+Print Service can be run on a per-user session basis, per
Lucio Andrés Illanes Albornoz bbde6e
+machine basis, or can be run on a few machines globally
Lucio Andrés Illanes Albornoz bbde6e
+available to a number of users.
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.4i
Lucio Andrés Illanes Albornoz bbde6e
+2.
Lucio Andrés Illanes Albornoz bbde6e
+If print jobs are to be submitted to a spooler (almost always
Lucio Andrés Illanes Albornoz bbde6e
+the case), make sure all needed printers are available to the
Lucio Andrés Illanes Albornoz bbde6e
+spooler subsystem (most often \fBlp\fR(1))
Lucio Andrés Illanes Albornoz bbde6e
+on the same machine running the X Print Service.
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.4i
Lucio Andrés Illanes Albornoz bbde6e
+3.
Lucio Andrés Illanes Albornoz bbde6e
+Configure the X Print Server. See ``X Print Server
Lucio Andrés Illanes Albornoz bbde6e
+Configuration''.
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.4i
Lucio Andrés Illanes Albornoz bbde6e
+4.
Lucio Andrés Illanes Albornoz bbde6e
+Depending on #1, start the X Print Server process "Xprt", and
Lucio Andrés Illanes Albornoz bbde6e
+then the toolkit-specific Print Dialog Manager Daemon process
Lucio Andrés Illanes Albornoz bbde6e
+(such as CDEnext's "dtpdmd") at the appropriate times.
Lucio Andrés Illanes Albornoz bbde6e
+Note that libXprintUtils-based applications/toolkits do not need
Lucio Andrés Illanes Albornoz bbde6e
+a Print Dialog Manager Daemon process to use Xprint.
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+The details are described below.
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+Because the X Print Service is based on X, it can be easily distributed.
Lucio Andrés Illanes Albornoz bbde6e
+The most significant factors in which execution model to choose will be
Lucio Andrés Illanes Albornoz bbde6e
+driven by:
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.2i
Lucio Andrés Illanes Albornoz bbde6e
+\(bu
Lucio Andrés Illanes Albornoz bbde6e
+how many printers will be accessable through the printer
Lucio Andrés Illanes Albornoz bbde6e
+subsystem on any given machine. A system administrator may
Lucio Andrés Illanes Albornoz bbde6e
+choose to cluster printers on a few given machines, or
Lucio Andrés Illanes Albornoz bbde6e
+scatter them across an organization and possibly make
Lucio Andrés Illanes Albornoz bbde6e
+extensive use of remote spoolers to make them globally
Lucio Andrés Illanes Albornoz bbde6e
+available.
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.2i
Lucio Andrés Illanes Albornoz bbde6e
+\(bu
Lucio Andrés Illanes Albornoz bbde6e
+how many machines will need a copy of the X Print Server
Lucio Andrés Illanes Albornoz bbde6e
+configuration files. The files have been architected so
Lucio Andrés Illanes Albornoz bbde6e
+that one super-set version of them can be maintained and
Lucio Andrés Illanes Albornoz bbde6e
+distributed (e.g. via NFS), and a per-machine or per-user
Lucio Andrés Illanes Albornoz bbde6e
+version of the `Xprinters' is all that is needed to have the
Lucio Andrés Illanes Albornoz bbde6e
+appropriate information in them utilized or ignored.
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.2i
Lucio Andrés Illanes Albornoz bbde6e
+\(bu
Lucio Andrés Illanes Albornoz bbde6e
+how many users can demand services from a given X Print
Lucio Andrés Illanes Albornoz bbde6e
+Service.
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+With the above in mind, some obvious execution models include:
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.2i
Lucio Andrés Illanes Albornoz bbde6e
+\(bu
Lucio Andrés Illanes Albornoz bbde6e
+Global - in this model, the system administrator is choosing
Lucio Andrés Illanes Albornoz bbde6e
+to run the X Print Service on a *few* select machines with
Lucio Andrés Illanes Albornoz bbde6e
+appropriate printers configured, and allow clients access to
Lucio Andrés Illanes Albornoz bbde6e
+the global resource. This can centralize the administration
Lucio Andrés Illanes Albornoz bbde6e
+of printers and configuration files, but may have to be
Lucio Andrés Illanes Albornoz bbde6e
+monitored for performance loading.
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+Startup would likely be done by boot-up scripts (such as \fB/etc/init.d/xprint\fR).
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.2i
Lucio Andrés Illanes Albornoz bbde6e
+\(bu
Lucio Andrés Illanes Albornoz bbde6e
+Per-machine - every machine with potential X Print Service
Lucio Andrés Illanes Albornoz bbde6e
+users would run the service. Printer and configuration file
Lucio Andrés Illanes Albornoz bbde6e
+administration is decentralized, and usage would be limited
Lucio Andrés Illanes Albornoz bbde6e
+to the users on the machine.
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+Startup would likely be done by boot-up scripts (such as \fB/etc/init.d/xprint\fR).
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.2i
Lucio Andrés Illanes Albornoz bbde6e
+\(bu
Lucio Andrés Illanes Albornoz bbde6e
+Per-user session - every user would run an entire X Print
Lucio Andrés Illanes Albornoz bbde6e
+Service for themselves. In the future, the Video X Server
Lucio Andrés Illanes Albornoz bbde6e
+normally started may contain Print X Server capability, so
Lucio Andrés Illanes Albornoz bbde6e
+this model becomes very natural.
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+Startup would likely be done at session login or by
Lucio Andrés Illanes Albornoz bbde6e
+launching actions or processes manually once the user
Lucio Andrés Illanes Albornoz bbde6e
+logs in. Note: Deamons like "dtpdmd" must be started after Xprt.
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+Starting of the processes is straight forward. In strict order (example is for manually starting the X print server for CDEnext usage):
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.4i
Lucio Andrés Illanes Albornoz bbde6e
+1.
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+.nf
Lucio Andrés Illanes Albornoz bbde6e
+[machineA] % Xprt [\-XpFile <Xprinters file>] [:dispNum] &
Lucio Andrés Illanes Albornoz bbde6e
+.fi
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+Note that Xprt will look for configuration files in either
Lucio Andrés Illanes Albornoz bbde6e
+a default location or where \fBXPCONFIGDIR\fR points.
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+\fB\-XpFile\fR specifies an alternate `Xprinters' file, rather
Lucio Andrés Illanes Albornoz bbde6e
+than the default one or `\fB${XPCONFIGDIR}/C/print/Xprinters\fR'.
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.4i
Lucio Andrés Illanes Albornoz bbde6e
+2.
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+.nf
Lucio Andrés Illanes Albornoz bbde6e
+[machineA] % dtpdmd \-d machineA[:dispNum] [\-l /tmp/dtpdmd.log] &
Lucio Andrés Illanes Albornoz bbde6e
+.fi
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+The dtpdmd will maintain an X-Selection on the X-Server,
Lucio Andrés Illanes Albornoz bbde6e
+and will start dtpdm's as required to service requests.
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+In all but the per-user session model, the machine running the dtpdmd
Lucio Andrés Illanes Albornoz bbde6e
+(thus dtpdm's) will need display authorization to the users video
Lucio Andrés Illanes Albornoz bbde6e
+display.
Lucio Andrés Illanes Albornoz bbde6e
+.SH "CLIENT CONFIGURATION"
Lucio Andrés Illanes Albornoz bbde6e
+Once a X Print Server and dtpdmd have been started -- many of them
Lucio Andrés Illanes Albornoz bbde6e
+in some cases -- clients will need to find and use them. There are
Lucio Andrés Illanes Albornoz bbde6e
+two mechanisms that allow clients to discover X Print Servers and
Lucio Andrés Illanes Albornoz bbde6e
+printers.
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.2i
Lucio Andrés Illanes Albornoz bbde6e
+\(bu
Lucio Andrés Illanes Albornoz bbde6e
+"X Print Specifier" - assuming usage of the DtPrint/XprintUtils-based print
Lucio Andrés Illanes Albornoz bbde6e
+applications, the following notation is understood:
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+.nf
Lucio Andrés Illanes Albornoz bbde6e
+printer_name@machine[:dispNum]
Lucio Andrés Illanes Albornoz bbde6e
+.fi
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+For example:
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+.nf
Lucio Andrés Illanes Albornoz bbde6e
+colorlj7@printhub:2
Lucio Andrés Illanes Albornoz bbde6e
+.fi
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+In the above example, the X Print Server running at `printhub:2'
Lucio Andrés Illanes Albornoz bbde6e
+is assumed to support the printer named `colorlj7'.
Lucio Andrés Illanes Albornoz bbde6e
+.TP 0.2i
Lucio Andrés Illanes Albornoz bbde6e
+\(bu
Lucio Andrés Illanes Albornoz bbde6e
+\fB${XPSERVERLIST}\fR - assuming usage of the DtPrint print dialogs,
Lucio Andrés Illanes Albornoz bbde6e
+the environment variable \fB${XPSERVERLIST}\fR can contain a list
Lucio Andrés Illanes Albornoz bbde6e
+of X Print Servers. For example:
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+.nf
Lucio Andrés Illanes Albornoz bbde6e
+XPSERVERLIST="printhub:2 printhub:3 otherdept:0"
Lucio Andrés Illanes Albornoz bbde6e
+.fi
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+Then in the dialogs, only a printer name needs to be entered.
Lucio Andrés Illanes Albornoz bbde6e
+The dialog will then search the X Print Servers in \fB${XPSERVERLIST}\fR
Lucio Andrés Illanes Albornoz bbde6e
+for a server than supports the printer, and then establish
Lucio Andrés Illanes Albornoz bbde6e
+contact.
Lucio Andrés Illanes Albornoz bbde6e
+.PP
Lucio Andrés Illanes Albornoz bbde6e
+.SH "END-USER SEQUENCE"
Lucio Andrés Illanes Albornoz bbde6e
+From most CDEnext applications, printing is accomplished by bringing
Lucio Andrés Illanes Albornoz bbde6e
+down the <File> menu and selecting <Print...>. This will result in
Lucio Andrés Illanes Albornoz bbde6e
+the DtPrintSetupBox dialog, which will request the name of a printer,
Lucio Andrés Illanes Albornoz bbde6e
+and offer limited capability to configure print options (e.g. number
Lucio Andrés Illanes Albornoz bbde6e
+of copies). If the user wishes, they can select <Setup...>, which
Lucio Andrés Illanes Albornoz bbde6e
+will start a dtpdm capable of modifying additional print options.
Lucio Andrés Illanes Albornoz bbde6e
+Finally, the user should select <Print>.
Lucio Andrés Illanes Albornoz bbde6e
+.SH ENVIRONMENT
Lucio Andrés Illanes Albornoz bbde6e
+.TP
Lucio Andrés Illanes Albornoz bbde6e
+\fB${XPCONFIGDIR}\fR
Lucio Andrés Illanes Albornoz bbde6e
+This environment variable points to the root
Lucio Andrés Illanes Albornoz bbde6e
+of the Xprint server configuration directory hierarchy.
Lucio Andrés Illanes Albornoz bbde6e
+If the variable is not defined, the default
Lucio Andrés Illanes Albornoz bbde6e
+path is be assumed. The default path may be
Lucio Andrés Illanes Albornoz bbde6e
+\fB/usr/X11R6/lib/X11/xserver/\fR,
Lucio Andrés Illanes Albornoz bbde6e
+\fB/usr/lib/X11/xserver/\fR,
Lucio Andrés Illanes Albornoz bbde6e
+\fB/usr/share/Xprint/xserver/\fR or
Lucio Andrés Illanes Albornoz bbde6e
+\fB/usr/openwin/server/etc/XpConfig\fR, depending on the
Lucio Andrés Illanes Albornoz bbde6e
+system, and may be configured in \fB/etc/init.d/xprint\fR.
Lucio Andrés Illanes Albornoz bbde6e
+.TP
Lucio Andrés Illanes Albornoz bbde6e
+\fB${LANG}\fR
Lucio Andrés Illanes Albornoz bbde6e
+This environment variable selects the locale settings used by the Xprint server.
Lucio Andrés Illanes Albornoz bbde6e
+Xprt allows language-specific settings (stored in \fB${XPCONFIGDIR}/${LANG}/print/\fR)
Lucio Andrés Illanes Albornoz bbde6e
+which will override the default settings (stored in \fB${XPCONFIGDIR}/C/print/\fR).
Lucio Andrés Illanes Albornoz bbde6e
+If \fB${LANG}\fR is not set "C" is assumed.
Lucio Andrés Illanes Albornoz bbde6e
+.TP
Lucio Andrés Illanes Albornoz bbde6e
+\fB${XPSERVERLIST}\fR
Lucio Andrés Illanes Albornoz bbde6e
+The environment variable \fB${XPSERVERLIST}\fR contains a list
Lucio Andrés Illanes Albornoz bbde6e
+of display identifiers (separated by whitespace) which tell an
Lucio Andrés Illanes Albornoz bbde6e
+application where it can find the Xprint servers. Usually
Lucio Andrés Illanes Albornoz bbde6e
+\fB${XPSERVERLIST}\fR is set by the profile startup scripts (e.g.
Lucio Andrés Illanes Albornoz bbde6e
+\fB/etc/profile\fR or \fB/etc/profile.d/xprint.sh\fR) using the output of
Lucio Andrés Illanes Albornoz bbde6e
+\fB/etc/init.d/xprint get_xpserverlist\fR.
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+Example:
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+.nf
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+		export XPSERVERLIST="`/etc/init.d/xprint get_xpserverlist`"
Lucio Andrés Illanes Albornoz bbde6e
+.fi
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+Alternatively \fB${XPSERVERLIST}\fR can be set
Lucio Andrés Illanes Albornoz bbde6e
+manually. Example:
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+.nf
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+		export XPSERVERLIST="littlecat:80 bitdog:72"
Lucio Andrés Illanes Albornoz bbde6e
+.fi
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+instructs an application to find an Xprint server at display
Lucio Andrés Illanes Albornoz bbde6e
+80 on the machine "littlecat" and at display 72 on the
Lucio Andrés Illanes Albornoz bbde6e
+machine bigdog.
Lucio Andrés Illanes Albornoz bbde6e
+.TP
Lucio Andrés Illanes Albornoz bbde6e
+\fB${XPRINTER}\fR
Lucio Andrés Illanes Albornoz bbde6e
+The environment variable \fB${XPRINTER}\fR
Lucio Andrés Illanes Albornoz bbde6e
+defines the default printer used by print
Lucio Andrés Illanes Albornoz bbde6e
+applications. The syntax is either
Lucio Andrés Illanes Albornoz bbde6e
+\fIprintername\fR or
Lucio Andrés Illanes Albornoz bbde6e
+\fIprintername\fR@\fIdisplay\fR.
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+Examples:
Lucio Andrés Illanes Albornoz bbde6e
+.RS
Lucio Andrés Illanes Albornoz bbde6e
+.TP
Lucio Andrés Illanes Albornoz bbde6e
+\fBXPRINTER=ps003\fR
Lucio Andrés Illanes Albornoz bbde6e
+tells an application to look for the
Lucio Andrés Illanes Albornoz bbde6e
+first printer named "ps003" on all Xprint
Lucio Andrés Illanes Albornoz bbde6e
+servers.
Lucio Andrés Illanes Albornoz bbde6e
+.TP
Lucio Andrés Illanes Albornoz bbde6e
+\fBXPRINTER=hplaser19@littlecat:80\fR
Lucio Andrés Illanes Albornoz bbde6e
+tells an application to use the printer "hplaser19"
Lucio Andrés Illanes Albornoz bbde6e
+on the Xprint server at display
Lucio Andrés Illanes Albornoz bbde6e
+"littlecat:80".
Lucio Andrés Illanes Albornoz bbde6e
+.RE
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+
Lucio Andrés Illanes Albornoz bbde6e
+If \fB${XPRINTER}\fR is not set the applications
Lucio Andrés Illanes Albornoz bbde6e
+will examine the values of the \fB${PDPRINTER}\fR,
Lucio Andrés Illanes Albornoz bbde6e
+\fB${LPDEST}\fR, and
Lucio Andrés Illanes Albornoz bbde6e
+\fB${PRINTER}\fR environment variables (in that order).
Lucio Andrés Illanes Albornoz bbde6e
+.SH "SEE ALSO"
Lucio Andrés Illanes Albornoz bbde6e
+\fBX11\fR(__miscmansuffix__), \fBxplsprinters\fR(__appmansuffix__), \fBxprehashprinterlist\fR(__appmansuffix__), \fBxphelloworld\fR(__appmansuffix__), \fBxpxmhelloworld\fR(__appmansuffix__), \fBxpawhelloworld\fR(__appmansuffix__), \fBxpxthelloworld\fR(__appmansuffix__), \fBxpsimplehelloworld\fR(__appmansuffix__), \fBXserver\fR(__appmansuffix__), \fBXprt\fR(__appmansuffix__), \fBlibXp\fR(__libmansuffix__), \fBlibXprintUtils\fR(__libmansuffix__), \fBlibXprintAppUtils\fR(__libmansuffix__), \fBXmPrintShell\fR(__libmansuffix__), \fBXawPrintShell\fR(__libmansuffix__), Xprint FAQ (http://xprint.mozdev.org/docs/Xprint_FAQ.html), Xprint main site (http://xprint.mozdev.org/)
Lucio Andrés Illanes Albornoz bbde6e
+.SH AUTHORS
Lucio Andrés Illanes Albornoz bbde6e
+This manual page was written by
Lucio Andrés Illanes Albornoz bbde6e
+Roland Mainz <roland.mainz@nrubsig.org> based on the original X11R6.6
Lucio Andrés Illanes Albornoz bbde6e
+\fBxc/programs/Xserver/XpConfig/README\fR.