file xpapputil.h was initially added on branch XPRINT.

16 files changed, 916 insertions, 0 deletions

diff --git a/.cvsignore b/.cvsignore
new file mode 100644
index 0000000..87414d5
--- /dev/null
+++ b/.cvsignore
@@ -0,0 +1,20 @@
+aclocal.m4
+autom4te.cache
+compile
+config.guess
+config.h
+config.h.in
+config.log
+config.status
+config.sub
+configure
+depcomp
+install-sh
+libtool
+ltmain.sh
+Makefile
+Makefile.in
+missing
+mkinstalldirs
+stamp-h1
+xprintapputil.pc
diff --git a/AUTHORS b/AUTHORS
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/AUTHORS
diff --git a/COPYING b/COPYING
new file mode 100644
index 0000000..7f33cbf
--- /dev/null
+++ b/COPYING
@@ -0,0 +1,12 @@
+This is a stub file.  This package has not yet had its complete licensing
+information compiled.  Please see the individual source files for details on
+your rights to use and modify this software.
+
+Please submit updated COPYING files to the Xorg bugzilla:
+
+https://bugs.freedesktop.org/enter_bug.cgi?product=xorg
+
+All licensing questions regarding this software should be directed at the
+Xorg mailing list:
+
+http://lists.freedesktop.org/mailman/listinfo/xorg
diff --git a/ChangeLog b/ChangeLog
new file mode 100644
index 0000000..8e5428f
--- /dev/null
+++ b/ChangeLog
@@ -0,0 +1,37 @@
+2005-12-20  Kevin E. Martin  <kem-at-freedesktop-dot-org>
+
+	* configure.ac:
+	Update package version for X11R7 release.
+
+2005-12-14  Kevin E. Martin  <kem-at-freedesktop-dot-org>
+
+	* configure.ac:
+	Update package version number for final X11R7 release candidate.
+
+2005-12-03  Kevin E. Martin  <kem-at-freedesktop-dot-org>
+
+	* configure.ac:
+	Update package version number for X11R7 RC3 release.
+
+2005-11-19  Kevin E. Martin  <kem-at-freedesktop-dot-org>
+
+	* xprintapputil.pc.in:
+	Update pkgconfig files to separate library build-time dependencies
+	from application build-time dependencies.
+	* configure.ac:
+	Update dependencies to work with separate build roots.
+
+2005-10-18  Kevin E. Martin  <kem-at-freedesktop-dot-org>
+
+	* configure.ac:
+	Update package version number for RC1 release.
+
+2005-07-08  Keith Packard  <keithp@keithp.com>
+
+	* .cvsignore:
+	* include/X11/.cvsignore:
+	* src/.cvsignore:
+	* src/Makefile.am:
+	Add .cvsignore files
+	Switch _la_CFLAGS for AM_CFLAGS to clean up directory
+
diff --git a/INSTALL b/INSTALL
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/INSTALL
diff --git a/Makefile.am b/Makefile.am
new file mode 100644
index 0000000..8d78643
--- /dev/null
+++ b/Makefile.am
@@ -0,0 +1,28 @@
+# 
+#  Copyright 2005  Red Hat, Inc.
+# 
+#  Permission to use, copy, modify, distribute, and sell this software and its
+#  documentation for any purpose is hereby granted without fee, provided that
+#  the above copyright notice appear in all copies and that both that
+#  copyright notice and this permission notice appear in supporting
+#  documentation, and that the name of Red Hat not be used in
+#  advertising or publicity pertaining to distribution of the software without
+#  specific, written prior permission.  Red Hat makes no
+#  representations about the suitability of this software for any purpose.  It
+#  is provided "as is" without express or implied warranty.
+# 
+#  RED HAT DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
+#  INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
+#  EVENT SHALL RED HAT BE LIABLE FOR ANY SPECIAL, INDIRECT OR
+#  CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
+#  DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+#  TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+#  PERFORMANCE OF THIS SOFTWARE.
+
+SUBDIRS = src
+
+pkgconfigdir = $(libdir)/pkgconfig
+pkgconfig_DATA = xprintapputil.pc
+
+EXTRA_DIST = xprintapputil.pc.in autogen.sh
+
diff --git a/NEWS b/NEWS
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/NEWS
diff --git a/README b/README
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/README
diff --git a/autogen.sh b/autogen.sh
new file mode 100755
index 0000000..904cd67
--- /dev/null
+++ b/autogen.sh
@@ -0,0 +1,12 @@
+#! /bin/sh
+
+srcdir=`dirname $0`
+test -z "$srcdir" && srcdir=.
+
+ORIGDIR=`pwd`
+cd $srcdir
+
+autoreconf -v --install || exit 1
+cd $ORIGDIR || exit $?
+
+$srcdir/configure --enable-maintainer-mode "$@"
diff --git a/configure.ac b/configure.ac
new file mode 100644
index 0000000..20f854d
--- /dev/null
+++ b/configure.ac
@@ -0,0 +1,46 @@
+
+dnl  Copyright 2005 Red Hat, Inc.
+dnl 
+dnl  Permission to use, copy, modify, distribute, and sell this software and its
+dnl  documentation for any purpose is hereby granted without fee, provided that
+dnl  the above copyright notice appear in all copies and that both that
+dnl  copyright notice and this permission notice appear in supporting
+dnl  documentation, and that the name of Red Hat not be used in
+dnl  advertising or publicity pertaining to distribution of the software without
+dnl  specific, written prior permission.  Red Hat makes no
+dnl  representations about the suitability of this software for any purpose.  It
+dnl  is provided "as is" without express or implied warranty.
+dnl 
+dnl  RED HAT DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
+dnl  INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
+dnl  EVENT SHALL RED HAT BE LIABLE FOR ANY SPECIAL, INDIRECT OR
+dnl  CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
+dnl  DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+dnl  TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+dnl  PERFORMANCE OF THIS SOFTWARE.
+dnl
+dnl Process this file with autoconf to create configure.
+
+AC_PREREQ([2.57])
+
+AC_INIT(libXprintAppUtil, 1.0.1, [https://bugs.freedesktop.org/enter_bug.cgi?product=xorg], libXprintAppUtil)
+AM_INIT_AUTOMAKE([dist-bzip2])
+AM_MAINTAINER_MODE
+
+AM_CONFIG_HEADER(config.h)
+
+# Check for progs
+AC_PROG_CC
+AC_PROG_LIBTOOL
+
+# Check for dependencies
+PKG_CHECK_MODULES(XPRINTAPPUTIL, x11 xp xprintutil printproto xau)
+
+AC_SUBST(XPRINTAPPUTIL_CFLAGS)
+AC_SUBST(XPRINTAPPUTIL_LIBS)
+		  
+XORG_RELEASE_VERSION
+
+AC_OUTPUT([Makefile
+	   src/Makefile
+           xprintapputil.pc])
diff --git a/include/X11/.cvsignore b/include/X11/.cvsignore
new file mode 100644
index 0000000..44389c5
--- /dev/null
+++ b/include/X11/.cvsignore
@@ -0,0 +1 @@
+XprintAppUtil
diff --git a/include/X11/XprintAppUtil/xpapputil.h b/include/X11/XprintAppUtil/xpapputil.h
new file mode 100644
index 0000000..174b71d
--- /dev/null
+++ b/include/X11/XprintAppUtil/xpapputil.h
@@ -0,0 +1,174 @@
+
+/*
+ * $Xorg:xpapputil.h,v 1.1 2002/06/10 02:54:18 gisburn Exp $
+ * 
+ * xpapputil - Application level utility library for Xprint
+ *
+ * 
+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>
+ */
+
+#ifndef XPAPPUTILS_H
+#define XPAPPUTILS_H 1
+ 
+#include <X11/X.h>
+#include <X11/Xlib.h>
+#include <X11/Xutil.h>
+#include <X11/XprintUtil/xprintutil.h>
+
+#ifdef DEBUG
+#define XPAU_RETURN_IF_FAIL(expr, return_code) \
+    if( !(expr) ) { \
+      printf("XPAU_RETURN_IF_FAIL(file %s, line %d): " #expr ", returning " #return_code "\n", __FILE__, __LINE__); \
+      return (return_code); \
+    }
+
+#define XPAU_DEBUG(x) x
+
+#else
+
+#define XPAU_RETURN_IF_FAIL(expr, return_code) \
+    if( !(expr) ) { \
+      return (return_code); \
+    }
+
+#define XPAU_DEBUG(x)
+#endif /* DEBUG */
+
+/*
+ * Struct for XpauGetContext(), XpauReleaseContext()
+ * 
+ */
+typedef struct
+{
+    Display                 *pdpy;
+    XPContext                pcontext;
+    int                      xp_event_base,
+                             xp_error_base;
+
+    Bool                     inJob;
+    Bool                     inDocument;
+    Bool                     inPage;
+
+    void                    *print_to_filehandle;
+    Screen                  *pscreen;
+    int                      pscreennumber;
+    long                     document_dpi;
+    
+    XpuSupportedFlags        supported_job_attributes;
+    XpuSupportedFlags        supported_doc_attributes;
+    XpuSupportedFlags        supported_page_attributes;
+    
+    XpuMediumSourceSizeList  medium_list;
+    int                      medium_num_list_entries;
+    XpuResolutionList        resolution_list;
+    int                      resolution_num_list_entries;
+    XpuOrientationList       orientation_list;
+    int                      orientation_num_list_entries;
+    XpuPlexList              plex_list;
+    int                      plex_num_list_entries;
+} XpauContext;
+
+
+#define XpauVFilename      (1L<<0)
+#define XpauVMedium        (1L<<1)
+#define XpauVResolution    (1L<<2)
+#define XpauVOrientation   (1L<<3)
+#define XpauVPlex          (1L<<4)
+#define XpauVCopies        (1L<<5)
+#define XpauVTitle         (1L<<6)
+#define XpauVAll (XpauVFilename    | \
+                  XpauVMedium      | \
+                  XpauVResolution  | \
+                  XpauVOrientation | \
+                  XpauVPlex        | \
+                  XpauVCopies      | \
+                  XpauVTitle)
+
+typedef unsigned long XpauFlags;
+
+typedef struct
+{
+  const char              *title;
+  long                     copies;
+} XpauJobValues;
+
+typedef struct
+{
+  XpuMediumSourceSizeRec  *medium;
+  XpuResolutionRec        *resolution;
+  XpuOrientationRec       *orientation;
+  XpuPlexRec              *plex;
+  long                     copies;
+} XpauDocValues;
+
+typedef struct
+{
+  XpuMediumSourceSizeRec  *medium;
+  XpuResolutionRec        *resolution;
+  XpuOrientationRec       *orientation;
+  XpuPlexRec              *plex;
+} XpauPageValues;
+
+typedef enum {
+  XpAuError_success = 0, 
+  XpAuError_unspecified_error, 
+  XpAuError_errno,      /* check |errno| for error */
+  XpAuError_error_no_memory, 
+  XpAuError_unexpected_eos, 
+  XpAuError_unknown_argument, 
+  XpAuError_unsupported_medium, 
+  XpAuError_unsupported_resolution, 
+  XpAuError_unsupported_orientation, 
+  XpAuError_unsupported_plex,
+  XpAuError_unsupported_copy_count,
+  XpAuError_unsupported_job_name,
+  XpAuError_no_dpi_set,
+  XpAuError_not_inside_job,
+  XpAuError_not_inside_document,
+  XpAuError_not_inside_page,
+  XpAuError_inside_job,
+  XpAuError_inside_document,
+  XpAuError_inside_page
+} XpAuErrorValue;
+
+/* Prototypes */
+XpauContext *  XpauGetContext( const char *printername );
+void           XpauReleaseContext( XpauContext *context );
+XpAuErrorValue XpauParseArgs( XpauContext *context,
+                              XpauFlags *jobvaluemask, XpauJobValues *jobvalues,
+                              XpauFlags *docvaluemask, XpauDocValues *docvalues,
+                              char **jobfilename,
+                              const char *argument_string );
+XpAuErrorValue XpauSetJobValues( XpauContext *context, XpauFlags valuemask, XpauJobValues *Xpaujobvalues );
+XpAuErrorValue XpauSetDocValues( XpauContext *context, XpauFlags valuemask, XpauDocValues *Xpaudocvalues );
+XpAuErrorValue XpauSetPageValues( XpauContext *context, XpauFlags valuemask, XpauPageValues *Xpaupagevalues );
+XpAuErrorValue XpauStartJob( XpauContext *context, const char *printerfile );
+XpAuErrorValue XpauEndJob( XpauContext *context );
+XpAuErrorValue XpauStartDocument( XpauContext *context, XPDocumentType type );
+XpAuErrorValue XpauEndDocument( XpauContext *context );
+XpAuErrorValue XpauStartPage( XpauContext *context, Window pwin );
+XpAuErrorValue XpauEndPage( XpauContext *context );
+void           XpauWaitForPrintNotify(XpauContext *context, int type);
+const char    *XpAuErrorValueToString(XpAuErrorValue value);
+#endif /* !XPAPPUTILS_H */
+
+
diff --git a/src/.cvsignore b/src/.cvsignore
new file mode 100644
index 0000000..0d5f4dd
--- /dev/null
+++ b/src/.cvsignore
@@ -0,0 +1,6 @@
+.deps
+.libs
+libXprintAppUtil.la
+*.lo
+Makefile
+Makefile.in
diff --git a/src/Makefile.am b/src/Makefile.am
new file mode 100644
index 0000000..494ea40
--- /dev/null
+++ b/src/Makefile.am
@@ -0,0 +1,17 @@
+lib_LTLIBRARIES = libXprintAppUtil.la
+
+libXprintAppUtil_la_SOURCES = \
+         xpapputil.c
+
+INCLUDES = -I$(top_srcdir)/include
+
+
+libXprintAppUtil_la_LIBADD = @XPRINTAPPUTIL_LIBS@
+AM_CFLAGS = @XPRINTAPPUTIL_CFLAGS@
+
+libXprintAppUtil_la_LDFLAGS = -version-number 1:0:0 -no-undefined
+
+
+libXprintAppUtilincludedir = $(includedir)/X11/XprintAppUtil
+libXprintAppUtilinclude_HEADERS = \
+    $(top_srcdir)/include/X11/XprintAppUtil/xpapputil.h
diff --git a/src/xpapputil.c b/src/xpapputil.c
new file mode 100644
index 0000000..7e86f8e
--- /dev/null
+++ b/src/xpapputil.c
@@ -0,0 +1,551 @@
+
+/*
+ * $Xorg:xpapputil.c,v 1.1 2002/06/10 02:54:18 gisburn Exp $
+ * 
+ * xpapputil - Application level utility library for Xprint
+ *
+ * 
+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 <stdlib.h>
+#include <stdio.h>
+ 
+#include <X11/XprintAppUtil/xpapputil.h>
+
+XpauContext *XpauGetContext( const char *printername )
+{
+  Display     *pdpy;
+  XPContext    pcontext;
+  XpauContext *context;
+  
+  if( XpuGetPrinter(printername, &pdpy, &pcontext) != 1 )
+    return NULL; 
+  
+  if( context = (XpauContext *)malloc(sizeof(XpauContext)) )
+  {
+    memset(context, 0, sizeof(XpauContext));
+    
+    context->pdpy     = pdpy;
+    context->pcontext = pcontext;
+
+    if( XpQueryExtension(pdpy, &context->xp_event_base, &context->xp_error_base) == False )
+    {
+      fprintf(stderr, "XpauGetContext: XpQueryExtension() failed.\n");
+      XpauReleaseContext(context);
+      return NULL;
+    }
+
+    /* It may be better to fetch all this info on demand... */
+    context->medium_list      = XpuGetMediumSourceSizeList(pdpy, pcontext, &context->medium_num_list_entries);
+    context->resolution_list  = XpuGetResolutionList(pdpy,       pcontext, &context->resolution_num_list_entries);
+    context->orientation_list = XpuGetOrientationList(pdpy,      pcontext, &context->orientation_num_list_entries);
+    context->plex_list        = XpuGetPlexList(pdpy,             pcontext, &context->plex_num_list_entries);
+    context->supported_job_attributes  =  XpuGetSupportedJobAttributes(pdpy, pcontext);
+    context->supported_doc_attributes  =  XpuGetSupportedDocAttributes(pdpy, pcontext);
+    context->supported_page_attributes =  XpuGetSupportedPageAttributes(pdpy, pcontext);
+                                                                                                                     
+    return context;
+  }
+  
+  XpuClosePrinterDisplay(pdpy, pcontext);
+  
+  return NULL;
+}
+
+void XpauReleaseContext( XpauContext *context )
+{
+  if( context )
+  {
+    if( context->medium_list )
+      XpuFreeMediumSourceSizeList(context->medium_list);
+
+    if( context->resolution_list )
+      XpuFreeResolutionList(context->resolution_list);
+
+    if( context->orientation_list )
+      XpuFreeOrientationList(context->orientation_list);
+
+    if( context->plex_list )
+      XpuFreePlexList(context->plex_list);
+      
+    XpuClosePrinterDisplay(context->pdpy, context->pcontext);
+
+    free(context);
+  }
+}
+
+static
+XpAuErrorValue XpauParseArg( const char *arg_name, const char *arg_value, XpauContext *context, 
+                             XpauFlags *jobvaluemask, XpauJobValues *jobvalues,
+                             XpauFlags *docvaluemask, XpauDocValues *docvalues,
+                             char **jobfilename )
+{
+  XPAU_DEBUG(printf("XpauParseArg: name='%s', value='%s'\n", arg_name, arg_value));
+
+  if( !strcasecmp(arg_name, "file") ||
+      !strcasecmp(arg_name, "tofile") )
+  {
+    if( *jobfilename )
+      free((char *)*jobfilename);
+      
+    *jobfilename = strdup(arg_value);
+    if( !*jobfilename )
+      return XpAuError_error_no_memory;
+      
+    return XpAuError_success;
+  }
+  else if( !strcasecmp(arg_name, "medium") ||
+           !strcasecmp(arg_name, "papersize"))
+  {
+    if( !(context->medium_list && (context->supported_doc_attributes & XPUATTRIBUTESUPPORTED_DEFAULT_MEDIUM)) )
+      return XpAuError_unsupported_medium;
+
+    /* XXX: What about the tray name ? */
+    docvalues->medium = XpuFindMediumSourceSizeByName(context->medium_list,
+                                                      context->medium_num_list_entries, 
+                                                      NULL, arg_value);
+
+    if( !docvalues->medium )
+      return XpAuError_unsupported_medium;
+
+    *docvaluemask |= XpauVMedium;
+    return XpAuError_success;
+  }  
+  else if( !strcasecmp(arg_name, "resolution") )
+  {
+    int arg_res = atoi(arg_value);
+    
+    if( !(context->resolution_list && (context->supported_doc_attributes & XPUATTRIBUTESUPPORTED_DEFAULT_PRINTER_RESOLUTION)) )
+      return XpAuError_unsupported_resolution;
+
+    docvalues->resolution = XpuFindResolution(context->resolution_list,
+                                              context->resolution_num_list_entries, 
+                                              arg_res, arg_res);
+
+    if( !docvalues->resolution )
+      return XpAuError_unsupported_resolution;
+
+    *docvaluemask |= XpauVResolution;
+    return XpAuError_success;
+  }
+  else if( !strcasecmp(arg_name, "orientation") )
+  {
+    if( !(context->orientation_list && (context->supported_doc_attributes & XPUATTRIBUTESUPPORTED_CONTENT_ORIENTATION)) )
+      return XpAuError_unsupported_orientation;
+
+    docvalues->orientation = XpuFindOrientationByName(context->orientation_list,
+                                                      context->orientation_num_list_entries, 
+                                                      arg_value);
+
+    if( !docvalues->orientation )
+      return XpAuError_unsupported_orientation;
+
+    *docvaluemask |= XpauVOrientation;
+    return XpAuError_success;
+  }
+  else if( !strcasecmp(arg_name, "plex") )
+  {
+    if( !(context->plex_list && (context->supported_doc_attributes & XPUATTRIBUTESUPPORTED_PLEX)) )
+      return XpAuError_unsupported_plex;
+      
+    docvalues->plex = XpuFindPlexByName(context->plex_list,
+                                        context->plex_num_list_entries, 
+                                        arg_value);
+
+    if( !docvalues->plex )
+      return XpAuError_unsupported_plex;
+
+    *docvaluemask |= XpauVPlex;
+    return XpAuError_success;  
+  }
+  else if( !strcasecmp(arg_name, "copies") )
+  {
+    if( !(context->supported_job_attributes & XPUATTRIBUTESUPPORTED_COPY_COUNT) )
+      return XpAuError_unsupported_copy_count;
+      
+    jobvalues->copies = atoi(arg_value);
+    if( jobvalues->copies <= 1 )
+      return XpAuError_unsupported_copy_count;
+
+    *jobvaluemask |= XpauVCopies;
+    return XpAuError_success;  
+  }
+  else if( !strcasecmp(arg_name, "title") )
+  {
+    if( !(context->supported_job_attributes & XPUATTRIBUTESUPPORTED_JOB_NAME) )
+      return XpAuError_unsupported_job_name;
+
+    if( jobvalues->title )
+      free((char *)jobvalues->title);
+      
+    jobvalues->title = strdup(arg_value);
+    if( !jobvalues->title )
+      return XpAuError_error_no_memory;
+      
+    *jobvaluemask |= XpauVTitle;
+    return XpAuError_success;
+  }
+
+  return XpAuError_unknown_argument;
+}
+
+XpAuErrorValue XpauParseArgs( XpauContext *context,
+                              XpauFlags *jobvaluemask, XpauJobValues *jobvalues,
+                              XpauFlags *docvaluemask, XpauDocValues *docvalues,
+                              char **jobfilename,
+                              const char *argument_string )
+{
+  char *args_string,
+       *arg_name,
+       *arg_value,
+       *start,
+       *s;
+  int   result;
+  
+  if( !argument_string )
+    return XpAuError_success;
+
+  args_string = strdup(argument_string); /* Create copy of read-only string that we can write into it... */
+  if( !args_string )
+    return XpAuError_error_no_memory;
+
+  s = args_string;
+  
+  while( s != NULL )
+  {
+    /* Fetch argument name */
+    start = s; 
+    while( *s != '\0' && *s != '=' )
+      s++;   
+    if( *s == '\0' )
+    {
+      free(args_string);
+      return XpAuError_unexpected_eos;
+    }
+    *s++ = '\0';
+    arg_name = start;
+  
+    /* Fetch argument value */
+    start = s; 
+    while( *s != '\0' && *s != ',' )
+      s++;
+    if( *s == '\0' )
+      s = NULL;
+    else
+      *s++ = '\0';
+    arg_value = start;
+    
+    result = XpauParseArg(arg_name, arg_value, context, jobvaluemask, jobvalues, docvaluemask, docvalues, jobfilename);
+    if( result != XpAuError_success )
+    {
+      free(args_string);
+      return result;
+    }
+  }
+
+  free(args_string);
+  return XpAuError_success;
+}
+
+XpAuErrorValue
+XpauSetJobValues( XpauContext *context, XpauFlags valuemask, XpauJobValues *jobvalues )
+{
+  /* "Dry-run" tests */
+
+  /* We can't change job attributes while we are at the "job level"
+   * (e.g. after |XpStartJob()| and before |XpEndJob()| */
+  XPAU_RETURN_IF_FAIL(context->inJob == False, XpAuError_inside_job);
+    
+  if( valuemask & XpauVTitle ) 
+    XPAU_RETURN_IF_FAIL(jobvalues->title && (context->supported_job_attributes & XPUATTRIBUTESUPPORTED_JOB_NAME), XpAuError_unsupported_job_name);
+    
+  if( valuemask & XpauVCopies )
+    XPAU_RETURN_IF_FAIL((jobvalues->copies > 0) && (context->supported_job_attributes & XPUATTRIBUTESUPPORTED_COPY_COUNT), XpAuError_unsupported_copy_count);
+
+  /* Set values */
+
+  if( valuemask & XpauVTitle )
+    XpuSetJobTitle(context->pdpy, context->pcontext, jobvalues->title);
+
+#ifdef NOTNOW
+  if( valuemask & XpauVResolution )
+    XpuJobDocumentCopies(context->pdpy, context->pcontext, jobvalues->copies);   
+#endif /* NOTNOW */
+
+  return XpAuError_success;
+}
+
+XpAuErrorValue
+XpauSetDocValues( XpauContext *context, XpauFlags valuemask, XpauDocValues *docvalues )
+{
+  /* "Dry-run" tests */
+
+  /* We can't change document attributes while we are at the "document level"
+   * (e.g. after |XpStartDoc()| and before |XpEndDoc()| */
+  XPAU_RETURN_IF_FAIL(context->inDocument == False, XpAuError_inside_document);
+    
+  if( valuemask & XpauVMedium )
+    XPAU_RETURN_IF_FAIL(docvalues->medium && (context->supported_doc_attributes & XPUATTRIBUTESUPPORTED_DEFAULT_MEDIUM), XpAuError_unsupported_medium);
+  
+  if( valuemask & XpauVOrientation )
+    XPAU_RETURN_IF_FAIL(docvalues->orientation && (context->supported_doc_attributes & XPUATTRIBUTESUPPORTED_CONTENT_ORIENTATION), XpAuError_unsupported_orientation);
+
+  if( valuemask & XpauVPlex )
+    XPAU_RETURN_IF_FAIL(docvalues->plex && (context->supported_doc_attributes & XPUATTRIBUTESUPPORTED_PLEX), XpAuError_unsupported_plex);
+
+  if( valuemask & XpauVResolution )
+    XPAU_RETURN_IF_FAIL(docvalues->resolution && (context->supported_doc_attributes & XPUATTRIBUTESUPPORTED_DEFAULT_PRINTER_RESOLUTION), XpAuError_unsupported_resolution);
+
+  if( valuemask & XpauVCopies )
+    XPAU_RETURN_IF_FAIL((docvalues->copies > 0) && (context->supported_doc_attributes & XPUATTRIBUTESUPPORTED_COPY_COUNT), XpAuError_unsupported_copy_count);
+        
+  /* Set values */
+
+  if( valuemask & XpauVMedium )
+    XpuSetDocMediumSourceSize(context->pdpy, context->pcontext, docvalues->medium);
+
+  if( valuemask & XpauVOrientation )
+    XpuSetDocOrientation(context->pdpy, context->pcontext, docvalues->orientation);
+
+  if( valuemask & XpauVPlex )
+    XpuSetDocPlex(context->pdpy, context->pcontext, docvalues->plex);
+
+  if( valuemask & XpauVResolution )
+    XpuSetDocResolution(context->pdpy, context->pcontext, docvalues->resolution);
+    
+  if( valuemask & XpauVCopies )
+    XpuSetDocumentCopies(context->pdpy, context->pcontext, docvalues->copies);   
+
+  return XpAuError_success;
+}
+
+XpAuErrorValue
+XpauSetPageValues( XpauContext *context, XpauFlags valuemask, XpauPageValues *pagevalues )
+{
+  /* "Dry-run" tests */
+  
+  /* We can't change page attributes while we are at the "page level"
+   * (e.g. after |XpStartPage()| and before |XpEndPage()| */
+  XPAU_RETURN_IF_FAIL(context->inPage == False, XpAuError_inside_page);
+
+  if( valuemask & XpauVMedium )
+     XPAU_RETURN_IF_FAIL(pagevalues->medium && (context->supported_page_attributes & XPUATTRIBUTESUPPORTED_DEFAULT_MEDIUM), XpAuError_unsupported_medium);
+  
+  if( valuemask & XpauVOrientation )
+     XPAU_RETURN_IF_FAIL(pagevalues->orientation && (context->supported_page_attributes & XPUATTRIBUTESUPPORTED_CONTENT_ORIENTATION), XpAuError_unsupported_orientation);
+
+  if( valuemask & XpauVPlex )
+     XPAU_RETURN_IF_FAIL(pagevalues->plex && (context->supported_page_attributes & XPUATTRIBUTESUPPORTED_PLEX), XpAuError_unsupported_plex);
+
+  if( valuemask & XpauVResolution )
+     XPAU_RETURN_IF_FAIL(pagevalues->resolution && (context->supported_page_attributes & XPUATTRIBUTESUPPORTED_DEFAULT_PRINTER_RESOLUTION), XpAuError_unsupported_resolution);
+       
+  /* Set values */
+
+  if( valuemask & XpauVMedium )
+    XpuSetPageMediumSourceSize(context->pdpy, context->pcontext, pagevalues->medium);
+
+  if( valuemask & XpauVOrientation )
+    XpuSetPageOrientation(context->pdpy, context->pcontext, pagevalues->orientation);
+
+  if( valuemask & XpauVPlex )
+    XpuSetPagePlex(context->pdpy, context->pcontext, pagevalues->plex);
+
+  if( valuemask & XpauVResolution )
+    XpuSetPageResolution(context->pdpy, context->pcontext, pagevalues->resolution);
+    
+  return XpAuError_success;
+}
+
+XpAuErrorValue XpauStartJob( XpauContext *context, const char *printerfile )
+{
+  void *handle;
+  XpAuErrorValue  result = XpAuError_unspecified_error;
+  
+  XPAU_RETURN_IF_FAIL(context->inJob == False, XpAuError_inside_job);
+
+  /* Set print context
+   * Note that this modifies the available fonts, including build-in printer prints.
+   * All XListFonts()/XLoadFont() stuff should be done _after_ setting the print 
+   * context to obtain the proper fonts.
+   */ 
+  XpSetContext(context->pdpy, context->pcontext);
+      
+  if( printerfile )
+  {
+    context->print_to_filehandle = XpuStartJobToFile(context->pdpy, context->pcontext, printerfile);
+    if( context->print_to_filehandle )
+    {
+      result = XpAuError_success;
+    }
+    else
+    {
+      result = XpAuError_errno;
+    }
+  }
+  else
+  {
+    XpuStartJobToSpooler(context->pdpy);
+    result = XpAuError_success;
+  }
+
+  /* Get default printer resolution */   
+  if( XpuGetResolution(context->pdpy, context->pcontext, &context->document_dpi) != 1 )
+  {
+    result = XpAuError_no_dpi_set;
+  }
+    
+  if( result == XpAuError_success )
+  {
+    context->inJob         = True;
+    context->pscreen       = XpGetScreenOfContext(context->pdpy, context->pcontext);
+    context->pscreennumber = XScreenNumberOfScreen(context->pscreen);
+  }
+  
+  return result;
+}
+
+XpAuErrorValue XpauEndJob( XpauContext *context )
+{
+  XPAU_RETURN_IF_FAIL(context->inJob, XpAuError_not_inside_job);
+  
+  /* End the print job - the final results are sent by the X print
+   * server to the spooler sub system.
+   */
+  XpEndJob(context->pdpy);
+  
+  /* Be sure to process the X traffic (remember that we registered a
+   * "consumer" hook via Xlib internal magic when we print to a
+   * file)
+   * FixMe: |XpuWaitForPrintFileChild()| should call XFlush() instead!
+   */
+  XFlush(context->pdpy);
+
+  context->inJob         = False;
+  context->pscreen       = NULL;
+  context->pscreennumber = -1;
+  context->document_dpi  = 0L;
+     
+  if( context->print_to_filehandle )
+  {
+    if( XpuWaitForPrintFileChild(context->print_to_filehandle) != XPGetDocFinished )
+    {
+      return XpAuError_errno;
+    }
+  } 
+  
+  return XpAuError_success;
+}
+
+XpAuErrorValue XpauStartDocument( XpauContext *context, XPDocumentType type )
+{ 
+  XPAU_RETURN_IF_FAIL(context->inJob      == True,  XpAuError_not_inside_job);
+  XPAU_RETURN_IF_FAIL(context->inDocument == False, XpAuError_inside_document);
+  XPAU_RETURN_IF_FAIL(context->inPage     == False, XpAuError_inside_page);
+  
+  XpStartDoc(context->pdpy, type);
+  context->inDocument = True;
+
+  return XpAuError_success;
+}
+
+XpAuErrorValue XpauEndDocument( XpauContext *context )
+{
+  XPAU_RETURN_IF_FAIL(context->inDocument, XpAuError_not_inside_document);
+     
+  XpEndDoc(context->pdpy);
+  context->inDocument = False;
+  
+  return XpAuError_success;
+}
+
+XpAuErrorValue XpauStartPage( XpauContext *context, Window pwin )
+{ 
+  XPAU_RETURN_IF_FAIL(context->inPage == False, XpAuError_inside_page);
+  XPAU_RETURN_IF_FAIL(context->inJob  == True,  XpAuError_not_inside_job);
+  
+  XpStartPage(context->pdpy, pwin);
+
+  /* |XpStartPage()| will generate a "synthetic" |XpStartDoc()|
+   * if it was not called yet */
+  if( context->inDocument == False )
+  {
+    context->inDocument = True;
+  }
+  
+  context->inPage = True; 
+
+  return XpAuError_success;
+}
+
+XpAuErrorValue XpauEndPage( XpauContext *context )
+{
+  XPAU_RETURN_IF_FAIL(context->inPage, XpAuError_not_inside_page);
+
+  XpEndPage(context->pdpy);
+  context->inPage = False;
+
+  return XpAuError_success;
+}
+
+void XpauWaitForPrintNotify(XpauContext *context, int type)
+{
+  XpuWaitForPrintNotify(context->pdpy, context->xp_event_base, type);
+}
+
+
+const char *XpAuErrorValueToString(XpAuErrorValue value)
+{
+  char *msg;
+
+  switch(value)
+  {
+    case XpAuError_success:                  msg = "success" ;                                           break;
+    case XpAuError_errno:                    msg = strerror(errno) ;                                     break;
+    case XpAuError_error_no_memory:          msg = "out of memory" ;                                     break;
+    case XpAuError_unexpected_eos:           msg = "unexpected end of string" ;                          break;
+    case XpAuError_unknown_argument:         msg = "unknown argument" ;                                  break;
+    case XpAuError_unsupported_medium:       msg = "unsupported print medium" ;                          break;
+    case XpAuError_unsupported_resolution:   msg = "unsupported print resolution" ;                      break;
+    case XpAuError_unsupported_orientation:  msg = "unsupported orientation" ;                           break;
+    case XpAuError_unsupported_plex:         msg = "unsupported plex" ;                                  break;
+    case XpAuError_unsupported_copy_count:   msg = "unsupported copy count" ;                            break;
+    case XpAuError_unsupported_job_name:     msg = "unsupported job name" ;                              break;
+    case XpAuError_no_dpi_set:               msg = "no DPI set (or no default DPI provided by server)" ; break;
+    case XpAuError_not_inside_job:           msg = "state error: not inside job" ;                       break;
+    case XpAuError_not_inside_document:      msg = "state error: not inside document" ;                  break;
+    case XpAuError_not_inside_page:          msg = "stage error: not inside page" ;                      break;
+    case XpAuError_inside_job:               msg = "state error: (already) inside job" ;                 break;
+    case XpAuError_inside_document:          msg = "state error: (already) inside document" ;            break;
+    case XpAuError_inside_page:              msg = "stage error: (already) inside page" ;                break;
+    case XpAuError_unspecified_error:        msg = "unspecified error" ;                                 break;
+    default:
+        msg = "unknown error" ;
+        break;
+  }
+  
+  return msg;
+}
+
+
+
+
diff --git a/xprintapputil.pc.in b/xprintapputil.pc.in
new file mode 100644
index 0000000..1cfa692
--- /dev/null
+++ b/xprintapputil.pc.in
@@ -0,0 +1,12 @@
+prefix=@prefix@
+exec_prefix=@exec_prefix@
+libdir=@libdir@
+includedir=@includedir@
+
+Name: XprintAppUtil
+Description: The XprintAppUtil Library
+Version: @PACKAGE_VERSION@
+Requires: xproto x11 xprintutil
+Requires.private: x11 xp xprintutil
+Cflags: -I${includedir}
+Libs: -L${libdir} -lXprintAppUtil