Attachment 196 Details for Bug 462 – Patch to fix misc. nits after landing

[patch] Patch to fix misc. nits after landing

patch.gudiff (text/plain), 56.21 KB, created by Roland Mainz on 2004-04-12 22:05:23 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Roland Mainz

Created: 2004-04-12 22:05:23 UTC

Size: 56.21 KB

patch

obsolete

>Index: xc/Imakefile
>===================================================================
>RCS file: /cvs/xorg/xc/Imakefile,v
>retrieving revision 1.1.4.2.6.1.6.1
>diff -u -r1.1.4.2.6.1.6.1 Imakefile
>--- a/xc/Imakefile	10 Apr 2004 09:03:31 -0000	1.1.4.2.6.1.6.1
>+++ b/xc/Imakefile	13 Apr 2004 05:01:07 -0000
>@@ -27,7 +27,8 @@
> #endif
> 
>         SUBDIRS = include config lib $(NLSSUBDIR) \
>-                  programs $(FONTSDIR) $(DOCSDIR)
>+                  programs $(FONTSDIR) $(DOCSDIR) \
>+                  packager
>   LNINSTALLDIRS = lib
> 
> #if HasParallelMake
>Index: xc/config/cf/xprint_site.def
>===================================================================
>RCS file: /cvs/xorg/xc/config/cf/Attic/xprint_site.def,v
>retrieving revision 1.1.2.1
>diff -u -r1.1.2.1 xprint_site.def
>--- a/xc/config/cf/xprint_site.def	13 Apr 2004 03:16:30 -0000	1.1.2.1
>+++ b/xc/config/cf/xprint_site.def	13 Apr 2004 05:01:07 -0000
>@@ -320,6 +320,6 @@
> #ifndef InstallXpPMFFontsDir
> #define InstallXpPMFFontsDir(destmodelfontdir)			@@\
> install::							@@\
>-	(cd $(DESTDIR)destmodelfontdir ; PATH=$(DESTDIR)/$(PROJECTROOT)/bin:$(PROJECTROOT)/bin:$${PATH} mkfontdir)
>+	(cd $(DESTDIR)destmodelfontdir ; $(DESTDIR)$(BINDIR)/mkfontscale -b -s -l)
> #endif /* InstallXpPMFFontsDir */
> 
>Index: xc/programs/xphelloworld/Imakefile
>===================================================================
>RCS file: /cvs/xorg/xc/programs/xphelloworld/Attic/Imakefile,v
>retrieving revision 1.1.2.1
>diff -u -r1.1.2.1 Imakefile
>--- a/xc/programs/xphelloworld/Imakefile	13 Apr 2004 03:16:48 -0000	1.1.2.1
>+++ b/xc/programs/xphelloworld/Imakefile	13 Apr 2004 05:01:31 -0000
>@@ -1,20 +1,29 @@
>-XCOMM $Xorg: Imakefile,v 1.3 2002/02/10 19:54:53 gisburn Exp $
>-
>-LOCAL_LIBRARIES = $(XLIB) -lXp -lXprintAppUtil -lXprintUtil
>-SYS_LIBRARIES = MathLibrary
>-DEPLIBS = $(DEPXLIB)
>-
>-DEFINES         = 
>-           SRCS = xphelloworld.c
>-           OBJS = xphelloworld.o
>-
>-ComplexProgramTarget(xphelloworld)
>-
>-#ifdef HasDocBookTools
>-all:: xphelloworld.man xphelloworld.html
>-
>-ConvertDocBookToManPage(xphelloworld.sgml, xphelloworld.man)
>-ConvertDocBookToHTML(xphelloworld.sgml, xphelloworld.html)
>-#endif /* HasDocBookTools */
>-
>+XCOMM $Xorg: Imakefile,v 1.1 2002/02/10 19:44:00 gisburn Exp $
>+#define IHaveSubdirs
>+#define PassCDebugFlags
>+
>+XCOMM xpxmprintshell and xpawprintshell use Motif widgets
>+#if HasMotif2
>+XCOMM Solaris's Motif version is broken and misses XmPrintShell
>+XCOMM (see http://xprint.mozdev.org/bugs/show_bug.cgi?id=1366)
>+#ifndef SunArchitecture
>+    XPXMHELLOWORLDDIR = xpxmhelloworld
>+#endif /* SunArchitecture */
>+    XPAWHELLOWORLDDIR = xpawhelloworld
>+#endif /* HasMotif2 */
>+    XPXTHELLOWORLDDIR = xpxthelloworld
>+      XPHELLOWORLDDIR = xphelloworld
>+XPSIMPLEHELLOWORLDDIR = xpsimplehelloworld
>+
>+SUBDIRS = \
>+	$(XPXMHELLOWORLDDIR) \
>+	$(XPAWHELLOWORLDDIR) \
>+	$(XPXTHELLOWORLDDIR) \
>+	$(XPHELLOWORLDDIR) \
>+	$(XPSIMPLEHELLOWORLDDIR)
>+
>+MakeSubdirs($(SUBDIRS))
>+DependSubdirs($(SUBDIRS))
>+MakeLintLibSubdirs($(LINTSUBDIRS))
>+MakeLintSubdirs($(LINTSUBDIRS),install.ln,install.ln)
> 
>Index: xc/programs/xphelloworld/xphelloworld.c
>===================================================================
>RCS file: xc/programs/xphelloworld/xphelloworld.c
>diff -N xc/programs/xphelloworld/xphelloworld.c
>--- a/xc/programs/xphelloworld/xphelloworld.c	13 Apr 2004 03:16:48 -0000	1.1.2.1
>+++ /dev/null	1 Jan 1970 00:00:00 -0000
>@@ -1,273 +0,0 @@
>-/*
>- * $Xorg: xphelloworld.c,v 1.1 2002/02/10 22:54:18 gisburn Exp $
>- * 
>- * xphelloworld - Xprint version of hello world
>- *
>- * 
>-Copyright 2002-2004 Roland Mainz <roland.mainz@nrubsig.org>
>-
>-All Rights Reserved.
>-
>-The above copyright notice and this permission notice shall be included in
>-all copies or substantial portions of the Software.
>-
>-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
>-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
>-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
>-OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
>-AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
>-CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
>-
>-Except as contained in this notice, the name of The Open Group shall not be
>-used in advertising or otherwise to promote the sale, use or other dealings
>-in this Software without prior written authorization from The Open Group.
>- *
>- * Author:  Roland Mainz <roland.mainz@nrubsig.org>
>- */
>-
>-#include <X11/Xlib.h>
>-#include <X11/Xutil.h>
>-#include <X11/XprintAppUtil/xpapputil.h>
>-
>-#include <stdlib.h>
>-#include <stdio.h>
>-#include <string.h>
>-
>-/* Turn a NULL pointer string into an empty string */
>-#define NULLSTR(x) (((x)!=NULL)?(x):(""))
>-
>-#define Log(x) { if(verbose) printf x; }
>-
>-const char *ProgramName;      /* program name (from argv[0]) */
>-Bool        verbose = False;  /* verbose output what the program is doing */
>-
>-static 
>-void usage( void )
>-{
>-    fprintf (stderr, "usage:  %s [options]\n", ProgramName);
>-    fprintf (stderr, "-printer printernname\tprinter to use\n");
>-    fprintf (stderr, "-printargs args\t[ arg=value , ... ]\n");
>-    fprintf (stderr, "\targs:\ttofile=<filename>\n");
>-    fprintf (stderr, "\t\tpapersize=<paper name>\n");
>-    fprintf (stderr, "\t\torientation=<orientation>\n");
>-    fprintf (stderr, "\t\tresolution=<DPI>\n");
>-    fprintf (stderr, "\t\tplex=<plex>\n");
>-    fprintf (stderr, "\t\ttitle=<string>\n");
>-    fprintf (stderr, "-v\tverbose output\n");
>-    fprintf (stderr, "-text <string>\ttext to print (in ISO-8859-1)\n");
>-    fprintf (stderr, "\n");
>-    exit(EXIT_FAILURE);
>-}
>-
>-static
>-int do_hello_world( const char *printername, const char *printerargs, const char *hello_world_message )
>-{
>-    char            *printerfile = NULL;
>-    Window           pwin;
>-    XGCValues        gcvalues;
>-    XEvent           ev;
>-    GC               pgc;
>-    unsigned short   dummy;
>-    XRectangle       winrect;
>-    char             fontname[256]; /* BUG: is this really big enougth ? */
>-    XFontStruct      *font;
>-    XpauContext      *context;
>-    XpauFlags         docvalueflags = 0UL;
>-    XpauDocValues  x_docvalues;
>-    XpauDocValues *docvalues = &x_docvalues;
>-    XpAuErrorValue   result;
>-    
>-    XpauFlags         jobvalueflags = 0UL;
>-    XpauJobValues  x_jobvalues;
>-    XpauJobValues *jobvalues = &x_jobvalues;
>-    memset(&x_jobvalues, 0, sizeof(x_jobvalues));
>-    memset(&x_docvalues, 0, sizeof(x_docvalues));
>-     
>-    context = XpauGetContext(printername);
>-    if( !context )
>-    {
>-      fprintf(stderr, "XpauGetContext() failure.\n");
>-      return(EXIT_FAILURE);
>-    }
>-
>-    if( (result = XpauParseArgs(context, &jobvalueflags, jobvalues, &docvalueflags, docvalues, &printerfile, printerargs)) != XpAuError_success )
>-    {
>-      fprintf(stderr, "XpuParseArgs() failure: %s.\n", XpAuErrorValueToString(result));
>-      XpauReleaseContext(context);
>-      return(EXIT_FAILURE);
>-    }
>-    
>-    if( (result = XpauSetJobValues(context, jobvalueflags, jobvalues)) != XpAuError_success )
>-    {
>-      fprintf(stderr, "XpauSetJobValues() failure: %s.\n", XpAuErrorValueToString(result));
>-      XpauReleaseContext(context);
>-      return(EXIT_FAILURE);
>-    }
>-    
>-    if( (result = XpauSetDocValues(context, docvalueflags, docvalues)) != XpAuError_success )
>-    {
>-      fprintf(stderr, "XpauSetDocValues() failure: %s.\n", XpAuErrorValueToString(result));
>-      XpauReleaseContext(context);
>-      return(EXIT_FAILURE);
>-    }        
>-    
>-    /* Listen to XP(Start|End)(Job|Doc|Page)Notify events).
>-     * This is mantatory as Xp(Start|End)(Job|Doc|Page) functions are _not_ 
>-     * syncronous !!
>-     * Not waiting for such events may cause that subsequent data may be 
>-     * destroyed/corrupted!!
>-     */
>-    XpSelectInput(context->pdpy, context->pcontext, XPPrintMask);
>-         
>-    if( printerfile )
>-    {
>-      Log(("starting job (to file '%s').\n", printerfile));
>-    }
>-    else
>-    {
>-      Log(("starting job.\n"));
>-    }
>-
>-    if( (result = XpauStartJob(context, printerfile)) != XpAuError_success )
>-    {
>-      fprintf(stderr, "%s: Error: %s while trying to print.\n", 
>-              ProgramName, XpAuErrorValueToString(result));
>-      XpauReleaseContext(context);
>-      return(EXIT_FAILURE);
>-    }
>-
>-    XpauWaitForPrintNotify(context, XPStartJobNotify);
>-  
>-    /* Obtain some info about page geometry */
>-    XpGetPageDimensions(context->pdpy, context->pcontext, &dummy, &dummy, &winrect);
>-
>-    pwin = XCreateSimpleWindow(context->pdpy,  XRootWindowOfScreen(context->pscreen),
>-                               winrect.x, winrect.y, winrect.width, winrect.height,
>-                               10,
>-                               XBlackPixel(context->pdpy, context->pscreennumber),
>-                               XWhitePixel(context->pdpy, context->pscreennumber));
>-
>-    gcvalues.background = XWhitePixel(context->pdpy, context->pscreennumber);
>-    gcvalues.foreground = XBlackPixel(context->pdpy, context->pscreennumber);
>-            
>-    pgc = XCreateGC(context->pdpy, pwin, GCBackground|GCForeground, &gcvalues);
>-      
>-    Log(("start page.\n"));
>-    XpauStartPage(context, pwin);
>-    XpauWaitForPrintNotify(context, XPStartPageNotify);
>-
>-    /* Mapping the window inside XpStartPage()/XpEndPage()
>-     * Set XCreateWindow/border_width to 0 or move XMapWindow in front of 
>-     * XpStartPage() to get rid of the surrounding black border lines.
>-     * (This is usually done before XpStartPage() in real applications)
>-     */     
>-    XMapWindow(context->pdpy, pwin);
>-      
>-    /* usual rendering stuff..... */
>-
>-    sprintf(fontname, "-*-*-*-*-*-*-*-180-%ld-%ld-*-*-iso8859-1", context->document_dpi, context->document_dpi);
>-    font = XLoadQueryFont(context->pdpy, fontname);
>-    XSetFont(context->pdpy, pgc, font->fid);
>-    if (!hello_world_message)
>-      hello_world_message = "hello world from X11 print system";
>-    XDrawString(context->pdpy, pwin, pgc, 100, 100, hello_world_message, strlen(hello_world_message));
>-    
>-    XpauEndPage(context);
>-    XpauWaitForPrintNotify(context, XPEndPageNotify);
>-    Log(("end page.\n"));
>-    
>-    Log(("end job.\n"));
>-
>-    if( (result = XpauEndJob(context)) != XpAuError_success )
>-    {
>-      fprintf(stderr, "%s: Error while printing: %s.\n", 
>-              ProgramName, XpAuErrorValueToString(result));
>-      XpauReleaseContext(context);
>-      return(EXIT_FAILURE);
>-    }
>-
>-    XpauWaitForPrintNotify(context, XPEndJobNotify);    
>-    
>-    XpauReleaseContext(context);
>-    return(EXIT_SUCCESS);
>-}
>-
>-int main (int argc, char *argv[])
>-{
>-    const char    *printername         = NULL;  /* printer to query */
>-    const char    *printargs           = NULL;
>-    const char    *hello_world_message = NULL;
>-    Bool           use_threadsafe_api = False;  /* Use threadsafe API (for debugging) */
>-    XPPrinterList  plist;               /* list of printers */
>-    int            plist_count;         /* number of entries in |plist|-array */
>-    int            i;
>-    int            retval;
>-
>-    ProgramName = argv[0];
>-
>-    for (i = 1; i < argc; i++)
>-    {
>-      char *arg = argv[i];
>-      int len = strlen(arg);
>-    
>-      if (!strncmp("-printer", arg, len))
>-      {
>-        if (++i >= argc)
>-          usage();
>-        printername = argv[i];
>-      }
>-      else if (!strncmp("-printargs", arg, len))
>-      {
>-        if (++i >= argc)
>-          usage();
>-                 
>-        printargs = argv[i];
>-      }
>-      else if (!strncmp("-text", arg, len))
>-      {
>-        if (++i >= argc)
>-          usage();
>-                 
>-        hello_world_message = argv[i];
>-      }
>-      else if( !strncmp("-debug_use_threadsafe_api", arg, len) )
>-      {
>-        use_threadsafe_api = True;
>-      }
>-      else if (!strncmp("-v", arg, len))
>-      {
>-        verbose = True;
>-      }
>-      else
>-      {
>-        usage();
>-      }  
>-    }
>-
>-    if( use_threadsafe_api )
>-    {
>-      if( !XInitThreads() )
>-      {
>-        fprintf(stderr, "%s: XInitThreads() failure.\n", ProgramName);
>-        exit(EXIT_FAILURE);
>-      }
>-    }
>-        
>-    plist = XpuGetPrinterList(printername, &plist_count);
>-
>-    if (!plist) {
>-      fprintf(stderr, "%s:  no printers found for printer spec \"%s\".\n",
>-              ProgramName, NULLSTR(printername));
>-      exit(EXIT_FAILURE);
>-    }
>-    
>-    Log(("Using printer '%s'\n", plist[0].name));
>-    
>-    retval = do_hello_world(plist[0].name, printargs, hello_world_message);
>-    
>-    XpuFreePrinterList(plist);
>-    
>-    return(retval);
>-}
>-
>-
>Index: xc/programs/xphelloworld/xphelloworld.html
>===================================================================
>RCS file: xc/programs/xphelloworld/xphelloworld.html
>diff -N xc/programs/xphelloworld/xphelloworld.html
>--- a/xc/programs/xphelloworld/xphelloworld.html	13 Apr 2004 03:16:48 -0000	1.1.2.1
>+++ /dev/null	1 Jan 1970 00:00:00 -0000
>@@ -1,15 +0,0 @@
>-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>xphelloworld</title><meta name="generator" content="DocBook XSL Stylesheets V1.62.4"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="id2590201"></a><div class="titlepage"><div></div><div></div></div><div class="refnamediv"><h2>Name</h2><p>xphelloworld &#8212; sends a test page to an Xprint printer</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><tt class="command">xphelloworld</tt>  [<tt class="option">-printer <i class="replaceable"><tt>printernname</tt></i></tt>] [<tt class="option">-printargs
>-      <i class="replaceable"><tt>arg</tt></i>=<i class="replaceable"><tt>value</tt></i> [,...]</tt>] [<tt class="option">-v</tt>] [<tt class="option">-text <i class="replaceable"><tt>text</tt></i></tt>] [<tt class="option">-h</tt>]</p></div></div><div class="refsect1" lang="en"><a name="id2804938"></a><h2>DESCRIPTION</h2><p><span><b class="command">xphelloworld</b></span> is a utility for Xprint, the
>-      printing system for the X Window system. It sends a test page to
>-      the specified printer (or the default printer, if none is specified).
>-    </p></div><div class="refsect1" lang="en"><a name="id2804964"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term"><tt class="option">-printer <i class="replaceable"><tt>printernname</tt></i></tt></span></dt><dd><p>printer to use</p></dd><dt><span class="term"><tt class="option">-printargs <i class="replaceable"><tt>arg</tt></i>=<i class="replaceable"><tt>value</tt></i> [,...]</tt></span></dt><dd xmlns:ns1=""><p>Args:
>-	    </p><div class="variablelist"><dl><dt><span class="term"><b class="userinput"><tt>tofile=<i class="replaceable"><tt>filename</tt></i></tt></b></span></dt><dd><p></p></dd><dt><span class="term"><b class="userinput"><tt>papersize=<i class="replaceable"><tt>paper name</tt></i></tt></b></span></dt><dd><p></p></dd><dt><span class="term"><b class="userinput"><tt>orientation=<i class="replaceable"><tt>orientation</tt></i></tt></b></span></dt><dd><p></p></dd><dt><span class="term"><b class="userinput"><tt>resolution=<i class="replaceable"><tt>DPI</tt></i></tt></b></span></dt><dd><p></p></dd><dt><span class="term"><b class="userinput"><tt>plex=<i class="replaceable"><tt>plex</tt></i></tt></b></span></dt><dd><p></p></dd><dt><span class="term"><b class="userinput"><tt>title=<i class="replaceable"><tt>string</tt></i></tt></b></span></dt><dd><p></p></dd></dl></div></dd><dt><span class="term"><tt class="option">-text <i class="replaceable"><tt>text</tt></i></tt></span></dt><dd><p>Sample text to print. Default is &quot;hello world from X11 print system&quot;.</p></dd><dt><span class="term"><tt class="option">-v</tt></span></dt><dd><p>verbose output</p></dd><dt><span class="term"><tt class="option">-h</tt></span></dt><dd><p>print usage</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2805099"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl><dt><span class="term"><tt class="envar">XPSERVERLIST</tt></span></dt><dd><p><tt class="envar">${XPSERVERLIST}</tt> must be set,
>-	      identifying the available Xprint servers.
>-              See <span class="citerefentry"><span class="refentrytitle">Xprint</span>(7)</span>
>-	      for more details.
>-	  </p></dd></dl></div></div><div xmlns:ns2="" class="refsect1" lang="en"><a name="id2805129"></a><h2>KNOWN BUGS</h2><table class="simplelist" border="0" summary="Simple list"><tr><td>
>-          The <tt class="option">-text</tt> option assumes that the text is in ISO8859-1 encoding
>-          (the <tt class="envar">${LANG}</tt> environment variable is not honored in this case).
>-        </td></tr></table><p>
>-      A full list of bugs can be obtained from the Xprint.org bug database (<a href="http://xprint.mozdev.org/xprint_bugs.html" target="_top">http://xprint.mozdev.org/xprint_bugs.html</a>).
>-    </p></div><div class="refsect1" lang="en"><a name="id2805158"></a><h2>SEE ALSO</h2><p><span class="simplelist"><span class="citerefentry"><span class="refentrytitle">Xprint</span>(7)</span>, <span class="citerefentry"><span class="refentrytitle">X11</span>(7)</span>, <span class="citerefentry"><span class="refentrytitle">xplsprinters</span>(1x)</span>, <span class="citerefentry"><span class="refentrytitle">xpxmhelloworld</span>(1x)</span>, <span class="citerefentry"><span class="refentrytitle">xpawhelloworld</span>(1x)</span>, <span class="citerefentry"><span class="refentrytitle">xpxthelloworld</span>(1x)</span>, <span class="citerefentry"><span class="refentrytitle">xpsimplehelloworld</span>(1x)</span>, <span class="citerefentry"><span class="refentrytitle">Xserver</span>(1x)</span>, <span class="citerefentry"><span class="refentrytitle">Xprt</span>(1x)</span>, <span class="citerefentry"><span class="refentrytitle">libXp</span>(3x)</span>, <span class="citerefentry"><span class="refentrytitle">libXprintUtils</span>(3x)</span>, <span class="citerefentry"><span class="refentrytitle">libXprintAppUtils</span>(3x)</span>, <span class="citerefentry"><span class="refentrytitle">XmPrintShell</span>(3x)</span>, <span class="citerefentry"><span class="refentrytitle">XawPrintShell</span>(3x)</span>, Xprint FAQ (<a href="http://xprint.mozdev.org/docs/Xprint_FAQ.html" target="_top">http://xprint.mozdev.org/docs/Xprint_FAQ.html</a>), Xprint main site (<a href="http://xprint.mozdev.org/" target="_top">http://xprint.mozdev.org/</a>)</span></p></div></div></body></html>
>Index: xc/programs/xphelloworld/xphelloworld.man
>===================================================================
>RCS file: xc/programs/xphelloworld/xphelloworld.man
>diff -N xc/programs/xphelloworld/xphelloworld.man
>--- a/xc/programs/xphelloworld/xphelloworld.man	13 Apr 2004 03:16:48 -0000	1.1.2.1
>+++ /dev/null	1 Jan 1970 00:00:00 -0000
>@@ -1,64 +0,0 @@
>-.\" This manpage has been automatically generated by docbook2man 
>-.\" from a DocBook document.  This tool can be found at:
>-.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
>-.\" Please send any bug reports, improvements, comments, patches, 
>-.\" etc. to Steve Cheng <steve@ggi-project.org>.
>-.TH "XPHELLOWORLD" "__mansuffix__" "13 February 2004" "" ""
>-.SH NAME
>-xphelloworld \- sends a test page to an Xprint printer
>-.SH SYNOPSIS
>-
>-\fBxphelloworld\fR [ \fB-printer \fIprinternname\fB\fR]  [ \fB-printargs
>-\fIarg\fB=\fIvalue\fB [,...]\fR]  [ \fB-v\fR]  [ \fB-text \fItext\fB\fR]  [ \fB-h\fR] 
>-
>-.SH "DESCRIPTION"
>-.PP
>-\fBxphelloworld\fR is a utility for Xprint, the
>-printing system for the X Window system. It sends a test page to
>-the specified printer (or the default printer, if none is specified).
>-.SH "OPTIONS"
>-.TP
>-\fB-printer \fIprinternname\fB \fR
>-printer to use
>-.TP
>-\fB-printargs \fIarg\fB=\fIvalue\fB [,...] \fR
>-Args:
>-.RS
>-.TP
>-\fBtofile=\fIfilename\fB\fR
>-.TP
>-\fBpapersize=\fIpaper name\fB\fR
>-.TP
>-\fBorientation=\fIorientation\fB\fR
>-.TP
>-\fBresolution=\fIDPI\fB\fR
>-.TP
>-\fBplex=\fIplex\fB\fR
>-.TP
>-\fBtitle=\fIstring\fB\fR
>-.RE
>-.TP
>-\fB-text \fItext\fB \fR
>-Sample text to print. Default is "hello world from X11 print system".
>-.TP
>-\fB-v \fR
>-verbose output
>-.TP
>-\fB-h \fR
>-print usage
>-.SH "ENVIRONMENT"
>-.TP
>-\fBXPSERVERLIST \fR
>-\fB${XPSERVERLIST}\fR must be set,
>-identifying the available Xprint servers.
>-See \fBXprint\fR(__miscmansuffix__)
>-for more details.
>-.SH "KNOWN BUGS"
>-.PP
>-
>-The \fB-text\fR option assumes that the text is in ISO8859-1 encoding
>-(the \fB${LANG}\fR environment variable is not honored in this case).
>-A full list of bugs can be obtained from the Xprint.org bug database (http://xprint.mozdev.org/xprint_bugs.html <URL:http://xprint.mozdev.org/xprint_bugs.html>).
>-.SH "SEE ALSO"
>-.PP
>-\fBXprint\fR(__miscmansuffix__), \fBX11\fR(__miscmansuffix__), \fBxplsprinters\fR(__mansuffix__), \fBxpxmhelloworld\fR(__mansuffix__), \fBxpawhelloworld\fR(__mansuffix__), \fBxpxthelloworld\fR(__mansuffix__), \fBxpsimplehelloworld\fR(__mansuffix__), \fBXserver\fR(__mansuffix__), \fBXprt\fR(__mansuffix__), \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 <URL:http://xprint.mozdev.org/docs/Xprint_FAQ.html>), Xprint main site (http://xprint.mozdev.org/ <URL:http://xprint.mozdev.org/>)
>Index: xc/programs/xphelloworld/xphelloworld.sgml
>===================================================================
>RCS file: xc/programs/xphelloworld/xphelloworld.sgml
>diff -N xc/programs/xphelloworld/xphelloworld.sgml
>--- a/xc/programs/xphelloworld/xphelloworld.sgml	13 Apr 2004 03:16:48 -0000	1.1.2.1
>+++ /dev/null	1 Jan 1970 00:00:00 -0000
>@@ -1,187 +0,0 @@
>-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.2//EN" '/usr/share/sgml/docbook_4.2/docbook.dtd'>
>-
>-
>-
>-<refentry>
>-  <refmeta>
>-    <refentrytitle>xphelloworld</refentrytitle>
>-    <manvolnum>__mansuffix__</manvolnum>
>-  </refmeta>
>-  <refnamediv>
>-    <refname>xphelloworld</refname>
>-
>-    <refpurpose>sends a test page to an Xprint printer</refpurpose>
>-  </refnamediv>
>-  <refsynopsisdiv>
>-    <cmdsynopsis>
>-      <command>xphelloworld</command>
>-
>-      <arg><option>-printer <replaceable>printernname</replaceable></option></arg>
>-
>-      <arg><option>-printargs
>-      <replaceable>arg</replaceable>=<replaceable>value</replaceable> [,...]</option></arg>
>-
>-      <arg><option>-v</option></arg>
>-
>-      <arg><option>-text <replaceable>text</replaceable></option></arg>
>-
>-      <arg><option>-h</option></arg>
>-      
>-    </cmdsynopsis>
>-  </refsynopsisdiv>
>-  <refsect1>
>-    <title>DESCRIPTION</title>
>-
>-    <para><command>xphelloworld</command> is a utility for Xprint, the
>-      printing system for the X Window system. It sends a test page to
>-      the specified printer (or the default printer, if none is specified).
>-    </para>
>-
>-  </refsect1>
>-
>-  <refsect1>
>-    <title>OPTIONS</title>
>-
>-    <variablelist>
>-      <varlistentry>
>-        <term><option>-printer <replaceable>printernname</replaceable></option>
>-        </term>
>-        <listitem>
>-          <para>printer to use</para>
>-        </listitem>
>-      </varlistentry>
>-      <varlistentry>
>-        <term><option>-printargs <replaceable>arg</replaceable>=<replaceable>value</replaceable> [,...]</option>
>-        </term>
>-        <listitem>
>-          <para>Args:
>-	    <variablelist>
>-	      <varlistentry>
>-		<term><userinput>tofile=<replaceable>filename</replaceable></userinput></term>
>-		<listitem><para></para></listitem>
>-	      </varlistentry>
>-	      <varlistentry>
>-		<term><userinput>papersize=<replaceable>paper name</replaceable></userinput></term>
>-		<listitem><para></para></listitem>
>-	      </varlistentry>
>-	      <varlistentry>
>-		<term><userinput>orientation=<replaceable>orientation</replaceable></userinput></term>
>-		<listitem><para></para></listitem>
>-	      </varlistentry>
>-	      <varlistentry>
>-		<term><userinput>resolution=<replaceable>DPI</replaceable></userinput></term>
>-		<listitem><para></para></listitem>
>-	      </varlistentry>
>-	      <varlistentry>
>-		<term><userinput>plex=<replaceable>plex</replaceable></userinput></term>
>-		<listitem><para></para></listitem>
>-	      </varlistentry>
>-	      <varlistentry>
>-		<term><userinput>title=<replaceable>string</replaceable></userinput></term>
>-		<listitem><para></para></listitem>
>-	      </varlistentry>
>-	    </variablelist>
>-	  </para>
>-        </listitem>
>-      </varlistentry>
>-      <varlistentry>
>-        <term><option>-text <replaceable>text</replaceable></option>
>-        </term>
>-        <listitem>
>-          <para>Sample text to print. Default is "hello world from X11 print system".</para>
>-        </listitem>
>-      </varlistentry>
>-      <varlistentry>
>-        <term><option>-v</option>
>-        </term>
>-        <listitem>
>-          <para>verbose output</para>
>-        </listitem>
>-      </varlistentry>
>-      <varlistentry>
>-        <term><option>-h</option>
>-        </term>
>-        <listitem>
>-          <para>print usage</para>
>-        </listitem>
>-      </varlistentry>      
>-    </variablelist>
>-  </refsect1>
>-
>-  <refsect1>
>-    <title>ENVIRONMENT</title>
>-    <variablelist>
>-      <varlistentry>
>-        <term><envar>XPSERVERLIST</envar>
>-        </term>
>-        <listitem>
>-	    <para>
>-              <envar>${XPSERVERLIST}</envar> must be set,
>-	      identifying the available Xprint servers.
>-              See <citerefentry><refentrytitle>Xprint</refentrytitle><manvolnum>__miscmansuffix__</manvolnum></citerefentry>
>-	      for more details.
>-	  </para>
>-	</listitem>
>-      </varlistentry>
>-    </variablelist>
>-  </refsect1>
>-
>-  <refsect1>
>-    <title>KNOWN BUGS</title>
>-    <para>
>-      <simplelist type="vert">
>-        <member>
>-          The <option>-text</option> option assumes that the text is in ISO8859-1 encoding
>-          (the <envar>${LANG}</envar> environment variable is not honored in this case).
>-        </member>
>-      </simplelist>
>-      A full list of bugs can be obtained from the Xprint.org bug database (<ulink url="http://xprint.mozdev.org/xprint_bugs.html">http://xprint.mozdev.org/xprint_bugs.html</ulink>).
>-    </para>
>-  </refsect1>
>-
>-  <refsect1>
>-    <title>SEE ALSO</title>
>-    <para>
>-      <simplelist type="inline">
>-        
>-        
>-        
>-        
>-        <member><citerefentry><refentrytitle>Xprint</refentrytitle><manvolnum>__miscmansuffix__</manvolnum></citerefentry></member>
>-        <member><citerefentry><refentrytitle>X11</refentrytitle><manvolnum>__miscmansuffix__</manvolnum></citerefentry></member>
>-        <member><citerefentry><refentrytitle>xplsprinters</refentrytitle><manvolnum>__mansuffix__</manvolnum></citerefentry></member>
>-
>-        <member><citerefentry><refentrytitle>xpxmhelloworld</refentrytitle><manvolnum>__mansuffix__</manvolnum></citerefentry></member>
>-        <member><citerefentry><refentrytitle>xpawhelloworld</refentrytitle><manvolnum>__mansuffix__</manvolnum></citerefentry></member>
>-        <member><citerefentry><refentrytitle>xpxthelloworld</refentrytitle><manvolnum>__mansuffix__</manvolnum></citerefentry></member>
>-        <member><citerefentry><refentrytitle>xpsimplehelloworld</refentrytitle><manvolnum>__mansuffix__</manvolnum></citerefentry></member>
>-        <member><citerefentry><refentrytitle>Xserver</refentrytitle><manvolnum>__mansuffix__</manvolnum></citerefentry></member>
>-        <member><citerefentry><refentrytitle>Xprt</refentrytitle><manvolnum>__mansuffix__</manvolnum></citerefentry></member>
>-        
>-        <member><citerefentry><refentrytitle>libXp</refentrytitle><manvolnum>__libmansuffix__</manvolnum></citerefentry></member>
>-        <member><citerefentry><refentrytitle>libXprintUtils</refentrytitle><manvolnum>__libmansuffix__</manvolnum></citerefentry></member>
>-        <member><citerefentry><refentrytitle>libXprintAppUtils</refentrytitle><manvolnum>__libmansuffix__</manvolnum></citerefentry></member>
>-        <member><citerefentry><refentrytitle>XmPrintShell</refentrytitle><manvolnum>__libmansuffix__</manvolnum></citerefentry></member>
>-        <member><citerefentry><refentrytitle>XawPrintShell</refentrytitle><manvolnum>__libmansuffix__</manvolnum></citerefentry></member>
>-        <member>Xprint FAQ (<ulink url="http://xprint.mozdev.org/docs/Xprint_FAQ.html">http://xprint.mozdev.org/docs/Xprint_FAQ.html</ulink>)</member>
>-        <member>Xprint main site (<ulink url="http://xprint.mozdev.org/">http://xprint.mozdev.org/</ulink>)</member>
>-      </simplelist>
>-    </para>
>-  </refsect1>
>-
>-</refentry>
>-
>-
>-
>Index: xc/programs/xphelloworld/xphelloworld/Imakefile
>===================================================================
>RCS file: xc/programs/xphelloworld/xphelloworld/Imakefile
>diff -N xc/programs/xphelloworld/xphelloworld/Imakefile
>--- /dev/null	1 Jan 1970 00:00:00 -0000
>+++ b/xc/programs/xphelloworld/xphelloworld/Imakefile	13 Apr 2004 05:01:31 -0000
>@@ -0,0 +1,20 @@
>+XCOMM $Xorg: Imakefile,v 1.3 2002/02/10 19:54:53 gisburn Exp $
>+
>+LOCAL_LIBRARIES = $(XLIB) -lXp -lXprintAppUtil -lXprintUtil
>+SYS_LIBRARIES = MathLibrary
>+DEPLIBS = $(DEPXLIB)
>+
>+DEFINES         = 
>+           SRCS = xphelloworld.c
>+           OBJS = xphelloworld.o
>+
>+ComplexProgramTarget(xphelloworld)
>+
>+#ifdef HasDocBookTools
>+all:: xphelloworld.man xphelloworld.html
>+
>+ConvertDocBookToManPage(xphelloworld.sgml, xphelloworld.man)
>+ConvertDocBookToHTML(xphelloworld.sgml, xphelloworld.html)
>+#endif /* HasDocBookTools */
>+
>+
>Index: xc/programs/xphelloworld/xphelloworld/xphelloworld.c
>===================================================================
>RCS file: xc/programs/xphelloworld/xphelloworld/xphelloworld.c
>diff -N xc/programs/xphelloworld/xphelloworld/xphelloworld.c
>--- /dev/null	1 Jan 1970 00:00:00 -0000
>+++ b/xc/programs/xphelloworld/xphelloworld/xphelloworld.c	13 Apr 2004 05:01:31 -0000
>@@ -0,0 +1,273 @@
>+/*
>+ * $Xorg: xphelloworld.c,v 1.1 2002/02/10 22:54:18 gisburn Exp $
>+ * 
>+ * xphelloworld - Xprint version of hello world
>+ *
>+ * 
>+Copyright 2002-2004 Roland Mainz <roland.mainz@nrubsig.org>
>+
>+All Rights Reserved.
>+
>+The above copyright notice and this permission notice shall be included in
>+all copies or substantial portions of the Software.
>+
>+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
>+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
>+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
>+OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
>+AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
>+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
>+
>+Except as contained in this notice, the name of The Open Group shall not be
>+used in advertising or otherwise to promote the sale, use or other dealings
>+in this Software without prior written authorization from The Open Group.
>+ *
>+ * Author:  Roland Mainz <roland.mainz@nrubsig.org>
>+ */
>+
>+#include <X11/Xlib.h>
>+#include <X11/Xutil.h>
>+#include <X11/XprintAppUtil/xpapputil.h>
>+
>+#include <stdlib.h>
>+#include <stdio.h>
>+#include <string.h>
>+
>+/* Turn a NULL pointer string into an empty string */
>+#define NULLSTR(x) (((x)!=NULL)?(x):(""))
>+
>+#define Log(x) { if(verbose) printf x; }
>+
>+const char *ProgramName;      /* program name (from argv[0]) */
>+Bool        verbose = False;  /* verbose output what the program is doing */
>+
>+static 
>+void usage( void )
>+{
>+    fprintf (stderr, "usage:  %s [options]\n", ProgramName);
>+    fprintf (stderr, "-printer printernname\tprinter to use\n");
>+    fprintf (stderr, "-printargs args\t[ arg=value , ... ]\n");
>+    fprintf (stderr, "\targs:\ttofile=<filename>\n");
>+    fprintf (stderr, "\t\tpapersize=<paper name>\n");
>+    fprintf (stderr, "\t\torientation=<orientation>\n");
>+    fprintf (stderr, "\t\tresolution=<DPI>\n");
>+    fprintf (stderr, "\t\tplex=<plex>\n");
>+    fprintf (stderr, "\t\ttitle=<string>\n");
>+    fprintf (stderr, "-v\tverbose output\n");
>+    fprintf (stderr, "-text <string>\ttext to print (in ISO-8859-1)\n");
>+    fprintf (stderr, "\n");
>+    exit(EXIT_FAILURE);
>+}
>+
>+static
>+int do_hello_world( const char *printername, const char *printerargs, const char *hello_world_message )
>+{
>+    char            *printerfile = NULL;
>+    Window           pwin;
>+    XGCValues        gcvalues;
>+    XEvent           ev;
>+    GC               pgc;
>+    unsigned short   dummy;
>+    XRectangle       winrect;
>+    char             fontname[256]; /* BUG: is this really big enougth ? */
>+    XFontStruct      *font;
>+    XpauContext      *context;
>+    XpauFlags         docvalueflags = 0UL;
>+    XpauDocValues  x_docvalues;
>+    XpauDocValues *docvalues = &x_docvalues;
>+    XpAuErrorValue   result;
>+    
>+    XpauFlags         jobvalueflags = 0UL;
>+    XpauJobValues  x_jobvalues;
>+    XpauJobValues *jobvalues = &x_jobvalues;
>+    memset(&x_jobvalues, 0, sizeof(x_jobvalues));
>+    memset(&x_docvalues, 0, sizeof(x_docvalues));
>+     
>+    context = XpauGetContext(printername);
>+    if( !context )
>+    {
>+      fprintf(stderr, "XpauGetContext() failure.\n");
>+      return(EXIT_FAILURE);
>+    }
>+
>+    if( (result = XpauParseArgs(context, &jobvalueflags, jobvalues, &docvalueflags, docvalues, &printerfile, printerargs)) != XpAuError_success )
>+    {
>+      fprintf(stderr, "XpuParseArgs() failure: %s.\n", XpAuErrorValueToString(result));
>+      XpauReleaseContext(context);
>+      return(EXIT_FAILURE);
>+    }
>+    
>+    if( (result = XpauSetJobValues(context, jobvalueflags, jobvalues)) != XpAuError_success )
>+    {
>+      fprintf(stderr, "XpauSetJobValues() failure: %s.\n", XpAuErrorValueToString(result));
>+      XpauReleaseContext(context);
>+      return(EXIT_FAILURE);
>+    }
>+    
>+    if( (result = XpauSetDocValues(context, docvalueflags, docvalues)) != XpAuError_success )
>+    {
>+      fprintf(stderr, "XpauSetDocValues() failure: %s.\n", XpAuErrorValueToString(result));
>+      XpauReleaseContext(context);
>+      return(EXIT_FAILURE);
>+    }        
>+    
>+    /* Listen to XP(Start|End)(Job|Doc|Page)Notify events).
>+     * This is mantatory as Xp(Start|End)(Job|Doc|Page) functions are _not_ 
>+     * syncronous !!
>+     * Not waiting for such events may cause that subsequent data may be 
>+     * destroyed/corrupted!!
>+     */
>+    XpSelectInput(context->pdpy, context->pcontext, XPPrintMask);
>+         
>+    if( printerfile )
>+    {
>+      Log(("starting job (to file '%s').\n", printerfile));
>+    }
>+    else
>+    {
>+      Log(("starting job.\n"));
>+    }
>+
>+    if( (result = XpauStartJob(context, printerfile)) != XpAuError_success )
>+    {
>+      fprintf(stderr, "%s: Error: %s while trying to print.\n", 
>+              ProgramName, XpAuErrorValueToString(result));
>+      XpauReleaseContext(context);
>+      return(EXIT_FAILURE);
>+    }
>+
>+    XpauWaitForPrintNotify(context, XPStartJobNotify);
>+  
>+    /* Obtain some info about page geometry */
>+    XpGetPageDimensions(context->pdpy, context->pcontext, &dummy, &dummy, &winrect);
>+
>+    pwin = XCreateSimpleWindow(context->pdpy,  XRootWindowOfScreen(context->pscreen),
>+                               winrect.x, winrect.y, winrect.width, winrect.height,
>+                               10,
>+                               XBlackPixel(context->pdpy, context->pscreennumber),
>+                               XWhitePixel(context->pdpy, context->pscreennumber));
>+
>+    gcvalues.background = XWhitePixel(context->pdpy, context->pscreennumber);
>+    gcvalues.foreground = XBlackPixel(context->pdpy, context->pscreennumber);
>+            
>+    pgc = XCreateGC(context->pdpy, pwin, GCBackground|GCForeground, &gcvalues);
>+      
>+    Log(("start page.\n"));
>+    XpauStartPage(context, pwin);
>+    XpauWaitForPrintNotify(context, XPStartPageNotify);
>+
>+    /* Mapping the window inside XpStartPage()/XpEndPage()
>+     * Set XCreateWindow/border_width to 0 or move XMapWindow in front of 
>+     * XpStartPage() to get rid of the surrounding black border lines.
>+     * (This is usually done before XpStartPage() in real applications)
>+     */     
>+    XMapWindow(context->pdpy, pwin);
>+      
>+    /* usual rendering stuff..... */
>+
>+    sprintf(fontname, "-*-*-*-*-*-*-*-180-%ld-%ld-*-*-iso8859-1", context->document_dpi, context->document_dpi);
>+    font = XLoadQueryFont(context->pdpy, fontname);
>+    XSetFont(context->pdpy, pgc, font->fid);
>+    if (!hello_world_message)
>+      hello_world_message = "hello world from X11 print system";
>+    XDrawString(context->pdpy, pwin, pgc, 100, 100, hello_world_message, strlen(hello_world_message));
>+    
>+    XpauEndPage(context);
>+    XpauWaitForPrintNotify(context, XPEndPageNotify);
>+    Log(("end page.\n"));
>+    
>+    Log(("end job.\n"));
>+
>+    if( (result = XpauEndJob(context)) != XpAuError_success )
>+    {
>+      fprintf(stderr, "%s: Error while printing: %s.\n", 
>+              ProgramName, XpAuErrorValueToString(result));
>+      XpauReleaseContext(context);
>+      return(EXIT_FAILURE);
>+    }
>+
>+    XpauWaitForPrintNotify(context, XPEndJobNotify);    
>+    
>+    XpauReleaseContext(context);
>+    return(EXIT_SUCCESS);
>+}
>+
>+int main (int argc, char *argv[])
>+{
>+    const char    *printername         = NULL;  /* printer to query */
>+    const char    *printargs           = NULL;
>+    const char    *hello_world_message = NULL;
>+    Bool           use_threadsafe_api = False;  /* Use threadsafe API (for debugging) */
>+    XPPrinterList  plist;               /* list of printers */
>+    int            plist_count;         /* number of entries in |plist|-array */
>+    int            i;
>+    int            retval;
>+
>+    ProgramName = argv[0];
>+
>+    for (i = 1; i < argc; i++)
>+    {
>+      char *arg = argv[i];
>+      int len = strlen(arg);
>+    
>+      if (!strncmp("-printer", arg, len))
>+      {
>+        if (++i >= argc)
>+          usage();
>+        printername = argv[i];
>+      }
>+      else if (!strncmp("-printargs", arg, len))
>+      {
>+        if (++i >= argc)
>+          usage();
>+                 
>+        printargs = argv[i];
>+      }
>+      else if (!strncmp("-text", arg, len))
>+      {
>+        if (++i >= argc)
>+          usage();
>+                 
>+        hello_world_message = argv[i];
>+      }
>+      else if( !strncmp("-debug_use_threadsafe_api", arg, len) )
>+      {
>+        use_threadsafe_api = True;
>+      }
>+      else if (!strncmp("-v", arg, len))
>+      {
>+        verbose = True;
>+      }
>+      else
>+      {
>+        usage();
>+      }  
>+    }
>+
>+    if( use_threadsafe_api )
>+    {
>+      if( !XInitThreads() )
>+      {
>+        fprintf(stderr, "%s: XInitThreads() failure.\n", ProgramName);
>+        exit(EXIT_FAILURE);
>+      }
>+    }
>+        
>+    plist = XpuGetPrinterList(printername, &plist_count);
>+
>+    if (!plist) {
>+      fprintf(stderr, "%s:  no printers found for printer spec \"%s\".\n",
>+              ProgramName, NULLSTR(printername));
>+      exit(EXIT_FAILURE);
>+    }
>+    
>+    Log(("Using printer '%s'\n", plist[0].name));
>+    
>+    retval = do_hello_world(plist[0].name, printargs, hello_world_message);
>+    
>+    XpuFreePrinterList(plist);
>+    
>+    return(retval);
>+}
>+
>+
>Index: xc/programs/xphelloworld/xphelloworld/xphelloworld.html
>===================================================================
>RCS file: xc/programs/xphelloworld/xphelloworld/xphelloworld.html
>diff -N xc/programs/xphelloworld/xphelloworld/xphelloworld.html
>--- /dev/null	1 Jan 1970 00:00:00 -0000
>+++ b/xc/programs/xphelloworld/xphelloworld/xphelloworld.html	13 Apr 2004 05:01:31 -0000
>@@ -0,0 +1,15 @@
>+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>xphelloworld</title><meta name="generator" content="DocBook XSL Stylesheets V1.62.4"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="id2590201"></a><div class="titlepage"><div></div><div></div></div><div class="refnamediv"><h2>Name</h2><p>xphelloworld &#8212; sends a test page to an Xprint printer</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><tt class="command">xphelloworld</tt>  [<tt class="option">-printer <i class="replaceable"><tt>printernname</tt></i></tt>] [<tt class="option">-printargs
>+      <i class="replaceable"><tt>arg</tt></i>=<i class="replaceable"><tt>value</tt></i> [,...]</tt>] [<tt class="option">-v</tt>] [<tt class="option">-text <i class="replaceable"><tt>text</tt></i></tt>] [<tt class="option">-h</tt>]</p></div></div><div class="refsect1" lang="en"><a name="id2804938"></a><h2>DESCRIPTION</h2><p><span><b class="command">xphelloworld</b></span> is a utility for Xprint, the
>+      printing system for the X Window system. It sends a test page to
>+      the specified printer (or the default printer, if none is specified).
>+    </p></div><div class="refsect1" lang="en"><a name="id2804964"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term"><tt class="option">-printer <i class="replaceable"><tt>printernname</tt></i></tt></span></dt><dd><p>printer to use</p></dd><dt><span class="term"><tt class="option">-printargs <i class="replaceable"><tt>arg</tt></i>=<i class="replaceable"><tt>value</tt></i> [,...]</tt></span></dt><dd xmlns:ns1=""><p>Args:
>+	    </p><div class="variablelist"><dl><dt><span class="term"><b class="userinput"><tt>tofile=<i class="replaceable"><tt>filename</tt></i></tt></b></span></dt><dd><p></p></dd><dt><span class="term"><b class="userinput"><tt>papersize=<i class="replaceable"><tt>paper name</tt></i></tt></b></span></dt><dd><p></p></dd><dt><span class="term"><b class="userinput"><tt>orientation=<i class="replaceable"><tt>orientation</tt></i></tt></b></span></dt><dd><p></p></dd><dt><span class="term"><b class="userinput"><tt>resolution=<i class="replaceable"><tt>DPI</tt></i></tt></b></span></dt><dd><p></p></dd><dt><span class="term"><b class="userinput"><tt>plex=<i class="replaceable"><tt>plex</tt></i></tt></b></span></dt><dd><p></p></dd><dt><span class="term"><b class="userinput"><tt>title=<i class="replaceable"><tt>string</tt></i></tt></b></span></dt><dd><p></p></dd></dl></div></dd><dt><span class="term"><tt class="option">-text <i class="replaceable"><tt>text</tt></i></tt></span></dt><dd><p>Sample text to print. Default is &quot;hello world from X11 print system&quot;.</p></dd><dt><span class="term"><tt class="option">-v</tt></span></dt><dd><p>verbose output</p></dd><dt><span class="term"><tt class="option">-h</tt></span></dt><dd><p>print usage</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2805099"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl><dt><span class="term"><tt class="envar">XPSERVERLIST</tt></span></dt><dd><p><tt class="envar">${XPSERVERLIST}</tt> must be set,
>+	      identifying the available Xprint servers.
>+              See <span class="citerefentry"><span class="refentrytitle">Xprint</span>(7)</span>
>+	      for more details.
>+	  </p></dd></dl></div></div><div xmlns:ns2="" class="refsect1" lang="en"><a name="id2805129"></a><h2>KNOWN BUGS</h2><table class="simplelist" border="0" summary="Simple list"><tr><td>
>+          The <tt class="option">-text</tt> option assumes that the text is in ISO8859-1 encoding
>+          (the <tt class="envar">${LANG}</tt> environment variable is not honored in this case).
>+        </td></tr></table><p>
>+      A full list of bugs can be obtained from the Xprint.org bug database (<a href="http://xprint.mozdev.org/xprint_bugs.html" target="_top">http://xprint.mozdev.org/xprint_bugs.html</a>).
>+    </p></div><div class="refsect1" lang="en"><a name="id2805158"></a><h2>SEE ALSO</h2><p><span class="simplelist"><span class="citerefentry"><span class="refentrytitle">Xprint</span>(7)</span>, <span class="citerefentry"><span class="refentrytitle">X11</span>(7)</span>, <span class="citerefentry"><span class="refentrytitle">xplsprinters</span>(1x)</span>, <span class="citerefentry"><span class="refentrytitle">xpxmhelloworld</span>(1x)</span>, <span class="citerefentry"><span class="refentrytitle">xpawhelloworld</span>(1x)</span>, <span class="citerefentry"><span class="refentrytitle">xpxthelloworld</span>(1x)</span>, <span class="citerefentry"><span class="refentrytitle">xpsimplehelloworld</span>(1x)</span>, <span class="citerefentry"><span class="refentrytitle">Xserver</span>(1x)</span>, <span class="citerefentry"><span class="refentrytitle">Xprt</span>(1x)</span>, <span class="citerefentry"><span class="refentrytitle">libXp</span>(3x)</span>, <span class="citerefentry"><span class="refentrytitle">libXprintUtils</span>(3x)</span>, <span class="citerefentry"><span class="refentrytitle">libXprintAppUtils</span>(3x)</span>, <span class="citerefentry"><span class="refentrytitle">XmPrintShell</span>(3x)</span>, <span class="citerefentry"><span class="refentrytitle">XawPrintShell</span>(3x)</span>, Xprint FAQ (<a href="http://xprint.mozdev.org/docs/Xprint_FAQ.html" target="_top">http://xprint.mozdev.org/docs/Xprint_FAQ.html</a>), Xprint main site (<a href="http://xprint.mozdev.org/" target="_top">http://xprint.mozdev.org/</a>)</span></p></div></div></body></html>
>Index: xc/programs/xphelloworld/xphelloworld/xphelloworld.man
>===================================================================
>RCS file: xc/programs/xphelloworld/xphelloworld/xphelloworld.man
>diff -N xc/programs/xphelloworld/xphelloworld/xphelloworld.man
>--- /dev/null	1 Jan 1970 00:00:00 -0000
>+++ b/xc/programs/xphelloworld/xphelloworld/xphelloworld.man	13 Apr 2004 05:01:31 -0000
>@@ -0,0 +1,64 @@
>+.\" This manpage has been automatically generated by docbook2man 
>+.\" from a DocBook document.  This tool can be found at:
>+.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
>+.\" Please send any bug reports, improvements, comments, patches, 
>+.\" etc. to Steve Cheng <steve@ggi-project.org>.
>+.TH "XPHELLOWORLD" "__mansuffix__" "13 February 2004" "" ""
>+.SH NAME
>+xphelloworld \- sends a test page to an Xprint printer
>+.SH SYNOPSIS
>+
>+\fBxphelloworld\fR [ \fB-printer \fIprinternname\fB\fR]  [ \fB-printargs
>+\fIarg\fB=\fIvalue\fB [,...]\fR]  [ \fB-v\fR]  [ \fB-text \fItext\fB\fR]  [ \fB-h\fR] 
>+
>+.SH "DESCRIPTION"
>+.PP
>+\fBxphelloworld\fR is a utility for Xprint, the
>+printing system for the X Window system. It sends a test page to
>+the specified printer (or the default printer, if none is specified).
>+.SH "OPTIONS"
>+.TP
>+\fB-printer \fIprinternname\fB \fR
>+printer to use
>+.TP
>+\fB-printargs \fIarg\fB=\fIvalue\fB [,...] \fR
>+Args:
>+.RS
>+.TP
>+\fBtofile=\fIfilename\fB\fR
>+.TP
>+\fBpapersize=\fIpaper name\fB\fR
>+.TP
>+\fBorientation=\fIorientation\fB\fR
>+.TP
>+\fBresolution=\fIDPI\fB\fR
>+.TP
>+\fBplex=\fIplex\fB\fR
>+.TP
>+\fBtitle=\fIstring\fB\fR
>+.RE
>+.TP
>+\fB-text \fItext\fB \fR
>+Sample text to print. Default is "hello world from X11 print system".
>+.TP
>+\fB-v \fR
>+verbose output
>+.TP
>+\fB-h \fR
>+print usage
>+.SH "ENVIRONMENT"
>+.TP
>+\fBXPSERVERLIST \fR
>+\fB${XPSERVERLIST}\fR must be set,
>+identifying the available Xprint servers.
>+See \fBXprint\fR(__miscmansuffix__)
>+for more details.
>+.SH "KNOWN BUGS"
>+.PP
>+
>+The \fB-text\fR option assumes that the text is in ISO8859-1 encoding
>+(the \fB${LANG}\fR environment variable is not honored in this case).
>+A full list of bugs can be obtained from the Xprint.org bug database (http://xprint.mozdev.org/xprint_bugs.html <URL:http://xprint.mozdev.org/xprint_bugs.html>).
>+.SH "SEE ALSO"
>+.PP
>+\fBXprint\fR(__miscmansuffix__), \fBX11\fR(__miscmansuffix__), \fBxplsprinters\fR(__mansuffix__), \fBxpxmhelloworld\fR(__mansuffix__), \fBxpawhelloworld\fR(__mansuffix__), \fBxpxthelloworld\fR(__mansuffix__), \fBxpsimplehelloworld\fR(__mansuffix__), \fBXserver\fR(__mansuffix__), \fBXprt\fR(__mansuffix__), \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 <URL:http://xprint.mozdev.org/docs/Xprint_FAQ.html>), Xprint main site (http://xprint.mozdev.org/ <URL:http://xprint.mozdev.org/>)
>Index: xc/programs/xphelloworld/xphelloworld/xphelloworld.sgml
>===================================================================
>RCS file: xc/programs/xphelloworld/xphelloworld/xphelloworld.sgml
>diff -N xc/programs/xphelloworld/xphelloworld/xphelloworld.sgml
>--- /dev/null	1 Jan 1970 00:00:00 -0000
>+++ b/xc/programs/xphelloworld/xphelloworld/xphelloworld.sgml	13 Apr 2004 05:01:32 -0000
>@@ -0,0 +1,187 @@
>+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.2//EN" '/usr/share/sgml/docbook_4.2/docbook.dtd'>
>+
>+
>+
>+<refentry>
>+  <refmeta>
>+    <refentrytitle>xphelloworld</refentrytitle>
>+    <manvolnum>__mansuffix__</manvolnum>
>+  </refmeta>
>+  <refnamediv>
>+    <refname>xphelloworld</refname>
>+
>+    <refpurpose>sends a test page to an Xprint printer</refpurpose>
>+  </refnamediv>
>+  <refsynopsisdiv>
>+    <cmdsynopsis>
>+      <command>xphelloworld</command>
>+
>+      <arg><option>-printer <replaceable>printernname</replaceable></option></arg>
>+
>+      <arg><option>-printargs
>+      <replaceable>arg</replaceable>=<replaceable>value</replaceable> [,...]</option></arg>
>+
>+      <arg><option>-v</option></arg>
>+
>+      <arg><option>-text <replaceable>text</replaceable></option></arg>
>+
>+      <arg><option>-h</option></arg>
>+      
>+    </cmdsynopsis>
>+  </refsynopsisdiv>
>+  <refsect1>
>+    <title>DESCRIPTION</title>
>+
>+    <para><command>xphelloworld</command> is a utility for Xprint, the
>+      printing system for the X Window system. It sends a test page to
>+      the specified printer (or the default printer, if none is specified).
>+    </para>
>+
>+  </refsect1>
>+
>+  <refsect1>
>+    <title>OPTIONS</title>
>+
>+    <variablelist>
>+      <varlistentry>
>+        <term><option>-printer <replaceable>printernname</replaceable></option>
>+        </term>
>+        <listitem>
>+          <para>printer to use</para>
>+        </listitem>
>+      </varlistentry>
>+      <varlistentry>
>+        <term><option>-printargs <replaceable>arg</replaceable>=<replaceable>value</replaceable> [,...]</option>
>+        </term>
>+        <listitem>
>+          <para>Args:
>+	    <variablelist>
>+	      <varlistentry>
>+		<term><userinput>tofile=<replaceable>filename</replaceable></userinput></term>
>+		<listitem><para></para></listitem>
>+	      </varlistentry>
>+	      <varlistentry>
>+		<term><userinput>papersize=<replaceable>paper name</replaceable></userinput></term>
>+		<listitem><para></para></listitem>
>+	      </varlistentry>
>+	      <varlistentry>
>+		<term><userinput>orientation=<replaceable>orientation</replaceable></userinput></term>
>+		<listitem><para></para></listitem>
>+	      </varlistentry>
>+	      <varlistentry>
>+		<term><userinput>resolution=<replaceable>DPI</replaceable></userinput></term>
>+		<listitem><para></para></listitem>
>+	      </varlistentry>
>+	      <varlistentry>
>+		<term><userinput>plex=<replaceable>plex</replaceable></userinput></term>
>+		<listitem><para></para></listitem>
>+	      </varlistentry>
>+	      <varlistentry>
>+		<term><userinput>title=<replaceable>string</replaceable></userinput></term>
>+		<listitem><para></para></listitem>
>+	      </varlistentry>
>+	    </variablelist>
>+	  </para>
>+        </listitem>
>+      </varlistentry>
>+      <varlistentry>
>+        <term><option>-text <replaceable>text</replaceable></option>
>+        </term>
>+        <listitem>
>+          <para>Sample text to print. Default is "hello world from X11 print system".</para>
>+        </listitem>
>+      </varlistentry>
>+      <varlistentry>
>+        <term><option>-v</option>
>+        </term>
>+        <listitem>
>+          <para>verbose output</para>
>+        </listitem>
>+      </varlistentry>
>+      <varlistentry>
>+        <term><option>-h</option>
>+        </term>
>+        <listitem>
>+          <para>print usage</para>
>+        </listitem>
>+      </varlistentry>      
>+    </variablelist>
>+  </refsect1>
>+
>+  <refsect1>
>+    <title>ENVIRONMENT</title>
>+    <variablelist>
>+      <varlistentry>
>+        <term><envar>XPSERVERLIST</envar>
>+        </term>
>+        <listitem>
>+	    <para>
>+              <envar>${XPSERVERLIST}</envar> must be set,
>+	      identifying the available Xprint servers.
>+              See <citerefentry><refentrytitle>Xprint</refentrytitle><manvolnum>__miscmansuffix__</manvolnum></citerefentry>
>+	      for more details.
>+	  </para>
>+	</listitem>
>+      </varlistentry>
>+    </variablelist>
>+  </refsect1>
>+
>+  <refsect1>
>+    <title>KNOWN BUGS</title>
>+    <para>
>+      <simplelist type="vert">
>+        <member>
>+          The <option>-text</option> option assumes that the text is in ISO8859-1 encoding
>+          (the <envar>${LANG}</envar> environment variable is not honored in this case).
>+        </member>
>+      </simplelist>
>+      A full list of bugs can be obtained from the Xprint.org bug database (<ulink url="http://xprint.mozdev.org/xprint_bugs.html">http://xprint.mozdev.org/xprint_bugs.html</ulink>).
>+    </para>
>+  </refsect1>
>+
>+  <refsect1>
>+    <title>SEE ALSO</title>
>+    <para>
>+      <simplelist type="inline">
>+        
>+        
>+        
>+        
>+        <member><citerefentry><refentrytitle>Xprint</refentrytitle><manvolnum>__miscmansuffix__</manvolnum></citerefentry></member>
>+        <member><citerefentry><refentrytitle>X11</refentrytitle><manvolnum>__miscmansuffix__</manvolnum></citerefentry></member>
>+        <member><citerefentry><refentrytitle>xplsprinters</refentrytitle><manvolnum>__mansuffix__</manvolnum></citerefentry></member>
>+
>+        <member><citerefentry><refentrytitle>xpxmhelloworld</refentrytitle><manvolnum>__mansuffix__</manvolnum></citerefentry></member>
>+        <member><citerefentry><refentrytitle>xpawhelloworld</refentrytitle><manvolnum>__mansuffix__</manvolnum></citerefentry></member>
>+        <member><citerefentry><refentrytitle>xpxthelloworld</refentrytitle><manvolnum>__mansuffix__</manvolnum></citerefentry></member>
>+        <member><citerefentry><refentrytitle>xpsimplehelloworld</refentrytitle><manvolnum>__mansuffix__</manvolnum></citerefentry></member>
>+        <member><citerefentry><refentrytitle>Xserver</refentrytitle><manvolnum>__mansuffix__</manvolnum></citerefentry></member>
>+        <member><citerefentry><refentrytitle>Xprt</refentrytitle><manvolnum>__mansuffix__</manvolnum></citerefentry></member>
>+        
>+        <member><citerefentry><refentrytitle>libXp</refentrytitle><manvolnum>__libmansuffix__</manvolnum></citerefentry></member>
>+        <member><citerefentry><refentrytitle>libXprintUtils</refentrytitle><manvolnum>__libmansuffix__</manvolnum></citerefentry></member>
>+        <member><citerefentry><refentrytitle>libXprintAppUtils</refentrytitle><manvolnum>__libmansuffix__</manvolnum></citerefentry></member>
>+        <member><citerefentry><refentrytitle>XmPrintShell</refentrytitle><manvolnum>__libmansuffix__</manvolnum></citerefentry></member>
>+        <member><citerefentry><refentrytitle>XawPrintShell</refentrytitle><manvolnum>__libmansuffix__</manvolnum></citerefentry></member>
>+        <member>Xprint FAQ (<ulink url="http://xprint.mozdev.org/docs/Xprint_FAQ.html">http://xprint.mozdev.org/docs/Xprint_FAQ.html</ulink>)</member>
>+        <member>Xprint main site (<ulink url="http://xprint.mozdev.org/">http://xprint.mozdev.org/</ulink>)</member>
>+      </simplelist>
>+    </para>
>+  </refsect1>
>+
>+</refentry>
>+
>+
>+

Actions: View | Splinter Review

Attachments on bug 462: 192 | 193 | 194 | 195 | 196

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.