]> git.ipfire.org Git - thirdparty/cups.git/commitdiff
Merge changes from CUPS 1.4svn-r8067 (tentative CUPS 1.4b1)
authormsweet <msweet@a1ca3aef-8c08-0410-bb20-df032aa958be>
Fri, 17 Oct 2008 22:12:14 +0000 (22:12 +0000)
committermsweet <msweet@a1ca3aef-8c08-0410-bb20-df032aa958be>
Fri, 17 Oct 2008 22:12:14 +0000 (22:12 +0000)
git-svn-id: svn+ssh://src.apple.com/svn/cups/easysw/current@1021 a1ca3aef-8c08-0410-bb20-df032aa958be

34 files changed:
CHANGES-1.3.txt
Makefile
backend/usb-darwin.c
cups/conflicts.c
data/utf-8
doc/Makefile
doc/cups-printable.css
doc/cups.css
doc/help/postscript-driver.html [new file with mode: 0644]
doc/help/ppd-compiler.html [new file with mode: 0644]
doc/help/ref-ppdcfile.html
doc/images/cups-command-chain.png [new file with mode: 0644]
doc/images/cups-command-chain.svg [new file with mode: 0644]
doc/images/cups-postscript-chain.png [new file with mode: 0644]
doc/images/cups-postscript-chain.svg [new file with mode: 0644]
doc/images/cups-raster-chain.png [new file with mode: 0644]
doc/images/cups-raster-chain.svg [new file with mode: 0644]
examples/Makefile [new file with mode: 0644]
examples/color.drv [new file with mode: 0644]
examples/constraint.drv [new file with mode: 0644]
examples/custom.drv [new file with mode: 0644]
examples/grouping.drv [new file with mode: 0644]
examples/laserjet-basic.drv [new file with mode: 0644]
examples/laserjet-pjl.drv [new file with mode: 0644]
examples/minimum.drv [new file with mode: 0644]
examples/postscript.drv [new file with mode: 0644]
examples/r300-basic.drv [new file with mode: 0644]
examples/r300-colorman.drv [new file with mode: 0644]
examples/r300-remote.drv [new file with mode: 0644]
filter/bannertops.c
filter/image-png.c
filter/pstext.c
man/drv.man.in
packaging/cups.list.in

index 173fbfe2a4e0ca0cf6d57fc64a7912b26439d789..c9786957306915b50ff3d13bc3716795b392988d 100644 (file)
@@ -1,6 +1,13 @@
 CHANGES-1.3.txt
 ---------------
 
+CHANGES IN CUPS V1.3.10
+
+       - SECURITY: The PNG image reading code did not validate the
+         image size properly, leading to a potential buffer overflow
+         (STR #2974)
+
+
 CHANGES IN CUPS V1.3.9
 
        - SECURITY: The HP-GL/2 filter did not range check pen numbers
index cd19f8358d48b1cac7fd786ece98737697966066..44beff0a3a1560c289cdde0281c11cbe2a649f3d 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -30,7 +30,7 @@ include Makedefs
 DIRS   =       cups filter backend berkeley cgi-bin driver locale man monitor \
                notifier ppdc scheduler systemv test \
                $(PHPDIR) \
-               conf data doc $(FONTS) templates
+               conf data doc examples $(FONTS) templates
 
 
 #
index 3f12405f8259caa31c270d371e72570c66dbf925..f25fbe0177132c6591070eadece096ddcf6c2113 100644 (file)
@@ -1712,7 +1712,7 @@ static void setup_cfLanguage(void)
     lang[0] = CFStringCreateWithCString(kCFAllocatorDefault, requestedLang, kCFStringEncodingUTF8);
     langArray = CFArrayCreate(kCFAllocatorDefault, (const void **)lang, sizeof(lang) / sizeof(lang[0]), &kCFTypeArrayCallBacks);
 
-    CFPreferencesSetAppValue(CFSTR("AppleLanguages"), langArray, kCFPreferencesCurrentApplication);
+    CFPreferencesSetValue(CFSTR("AppleLanguages"), langArray, kCFPreferencesCurrentApplication, kCFPreferencesAnyUser, kCFPreferencesAnyHost);
     fprintf(stderr, "DEBUG: usb: AppleLanguages=\"%s\"\n", requestedLang);
 
     CFRelease(lang[0]);
index aab26d1e7ac7a5f8e966eff65ce31ba5afb7fd08..b05ecd57db709ee13a12098fd24a393fe95c7233 100644 (file)
@@ -544,213 +544,205 @@ ppd_load_constraints(ppd_file_t *ppd)   /* I - PPD file */
     installable = NULL;
 
  /*
-  * See what kind of constraint data we have in the PPD...
+  * Load old-style [Non]UIConstraints data...
   */
 
-  if ((constattr = ppdFindAttr(ppd, "cupsUIConstraints", NULL)) != NULL)
+  for (i = ppd->num_consts, oldconst = ppd->consts; i > 0; i --, oldconst ++)
   {
    /*
-    * Load new-style cupsUIConstraints data...
+    * Weed out nearby duplicates, since the PPD spec requires that you
+    * define both "*Foo foo *Bar bar" and "*Bar bar *Foo foo"...
     */
 
-    for (; constattr;
-         constattr = ppdFindNextAttr(ppd, "cupsUIConstraints", NULL))
-    {
-      if (!constattr->value)
-      {
-        DEBUG_puts("ppd_load_constraints: Bad cupsUIConstraints value!");
-        continue;
-      }
+    if (i > 1 &&
+       !strcasecmp(oldconst[0].option1, oldconst[1].option2) &&
+       !strcasecmp(oldconst[0].choice1, oldconst[1].choice2) &&
+       !strcasecmp(oldconst[0].option2, oldconst[1].option1) &&
+       !strcasecmp(oldconst[0].choice2, oldconst[1].choice1))
+      continue;
 
-      for (i = 0, vptr = strchr(constattr->value, '*');
-           vptr;
-          i ++, vptr = strchr(vptr + 1, '*'));
+   /*
+    * Allocate memory...
+    */
 
-      if (i == 0)
-      {
-        DEBUG_puts("ppd_load_constraints: Bad cupsUIConstraints value!");
-        continue;
-      }
+    if ((consts = calloc(1, sizeof(_ppd_cups_uiconsts_t))) == NULL)
+    {
+      DEBUG_puts("ppd_load_constraints: Unable to allocate memory for "
+                "UIConstraints!");
+      return;
+    }
 
-      if ((consts = calloc(1, sizeof(_ppd_cups_uiconsts_t))) == NULL)
-      {
-        DEBUG_puts("ppd_load_constraints: Unable to allocate memory for "
-                  "cupsUIConstraints!");
-        return;
-      }
+    if ((constptr = calloc(2, sizeof(_ppd_cups_uiconst_t))) == NULL)
+    {
+      free(consts);
+      DEBUG_puts("ppd_load_constraints: Unable to allocate memory for "
+                "UIConstraints!");
+      return;
+    }
 
-      if ((constptr = calloc(i, sizeof(_ppd_cups_uiconst_t))) == NULL)
-      {
-        free(consts);
-        DEBUG_puts("ppd_load_constraints: Unable to allocate memory for "
-                  "cupsUIConstraints!");
-        return;
-      }
+   /*
+    * Fill in the information...
+    */
 
-      consts->num_constraints = i;
-      consts->constraints     = constptr;
+    consts->num_constraints = 2;
+    consts->constraints     = constptr;
 
-      strlcpy(consts->resolver, constattr->spec, sizeof(consts->resolver));
+    if (!strncasecmp(oldconst->option1, "Custom", 6) &&
+       !strcasecmp(oldconst->choice1, "True"))
+    {
+      constptr[0].option      = ppdFindOption(ppd, oldconst->option1 + 6);
+      constptr[0].choice      = ppdFindChoice(constptr[0].option, "Custom");
+      constptr[0].installable = 0;
+    }
+    else
+    {
+      constptr[0].option      = ppdFindOption(ppd, oldconst->option1);
+      constptr[0].choice      = ppdFindChoice(constptr[0].option,
+                                             oldconst->choice1);
+      constptr[0].installable = ppd_is_installable(installable,
+                                                  oldconst->option1);
+    }
 
-      for (i = 0, vptr = strchr(constattr->value, '*');
-           vptr;
-          i ++, vptr = strchr(vptr, '*'), constptr ++)
-      {
-       /*
-        * Extract "*Option Choice" or just "*Option"...
-       */
+    if (!constptr[0].option || (!constptr[0].choice && oldconst->choice1[0]))
+    {
+      DEBUG_printf(("ppd_load_constraints: Unknown option *%s %s!\n",
+                   oldconst->option1, oldconst->choice1));
+      free(consts->constraints);
+      free(consts);
+      continue;
+    }
 
-        for (vptr ++, ptr = option; *vptr && !isspace(*vptr & 255); vptr ++)
-         if (ptr < (option + sizeof(option) - 1))
-           *ptr++ = *vptr;
+    if (!strncasecmp(oldconst->option2, "Custom", 6) &&
+       !strcasecmp(oldconst->choice2, "True"))
+    {
+      constptr[1].option      = ppdFindOption(ppd, oldconst->option2 + 6);
+      constptr[1].choice      = ppdFindChoice(constptr[1].option, "Custom");
+      constptr[1].installable = 0;
+    }
+    else
+    {
+      constptr[1].option      = ppdFindOption(ppd, oldconst->option2);
+      constptr[1].choice      = ppdFindChoice(constptr[1].option,
+                                             oldconst->choice2);
+      constptr[1].installable = ppd_is_installable(installable,
+                                                  oldconst->option2);
+    }
 
-        *ptr = '\0';
+    if (!constptr[1].option || (!constptr[1].choice && oldconst->choice2[0]))
+    {
+      DEBUG_printf(("ppd_load_constraints: Unknown option *%s %s!\n",
+                   oldconst->option2, oldconst->choice2));
+      free(consts->constraints);
+      free(consts);
+      continue;
+    }
 
-        while (isspace(*vptr & 255))
-         vptr ++;
+    consts->installable = constptr[0].installable || constptr[1].installable;
 
-        if (*vptr == '*')
-         choice[0] = '\0';
-       else
-       {
-         for (ptr = choice; *vptr && !isspace(*vptr & 255); vptr ++)
-           if (ptr < (choice + sizeof(choice) - 1))
-             *ptr++ = *vptr;
+   /*
+    * Add it to the constraints array...
+    */
 
-         *ptr = '\0';
-       }
+    cupsArrayAdd(ppd->cups_uiconstraints, consts);
+  }
 
-        if (!strncasecmp(option, "Custom", 6) && !strcasecmp(choice, "True"))
-       {
-         _cups_strcpy(option, option + 6);
-         strcpy(choice, "Custom");
-       }
+ /*
+  * Then load new-style constraints...
+  */
 
-        constptr->option      = ppdFindOption(ppd, option);
-        constptr->choice      = ppdFindChoice(constptr->option, choice);
-        constptr->installable = ppd_is_installable(installable, option);
-       consts->installable   |= constptr->installable;
+  for (constattr = ppdFindAttr(ppd, "cupsUIConstraints", NULL);
+       constattr;
+       constattr = ppdFindNextAttr(ppd, "cupsUIConstraints", NULL))
+  {
+    if (!constattr->value)
+    {
+      DEBUG_puts("ppd_load_constraints: Bad cupsUIConstraints value!");
+      continue;
+    }
 
-        if (!constptr->option || (!constptr->choice && choice[0]))
-       {
-         DEBUG_printf(("ppd_load_constraints: Unknown option *%s %s!\n",
-                       option, choice));
-         break;
-       }
-      }
+    for (i = 0, vptr = strchr(constattr->value, '*');
+        vptr;
+        i ++, vptr = strchr(vptr + 1, '*'));
 
-      if (!vptr)
-        cupsArrayAdd(ppd->cups_uiconstraints, consts);
-      else
-      {
-        free(consts->constraints);
-       free(consts);
-      }
+    if (i == 0)
+    {
+      DEBUG_puts("ppd_load_constraints: Bad cupsUIConstraints value!");
+      continue;
     }
-  }
-  else
-  {
-   /*
-    * Load old-style [Non]UIConstraints data...
-    */
 
-    for (i = ppd->num_consts, oldconst = ppd->consts; i > 0; i --, oldconst ++)
+    if ((consts = calloc(1, sizeof(_ppd_cups_uiconsts_t))) == NULL)
     {
-     /*
-      * Weed out nearby duplicates, since the PPD spec requires that you
-      * define both "*Foo foo *Bar bar" and "*Bar bar *Foo foo"...
-      */
-
-      if (i > 1 &&
-          !strcasecmp(oldconst[0].option1, oldconst[1].option2) &&
-         !strcasecmp(oldconst[0].choice1, oldconst[1].choice2) &&
-         !strcasecmp(oldconst[0].option2, oldconst[1].option1) &&
-         !strcasecmp(oldconst[0].choice2, oldconst[1].choice1))
-        continue;
+      DEBUG_puts("ppd_load_constraints: Unable to allocate memory for "
+                "cupsUIConstraints!");
+      return;
+    }
 
-     /*
-      * Allocate memory...
-      */
+    if ((constptr = calloc(i, sizeof(_ppd_cups_uiconst_t))) == NULL)
+    {
+      free(consts);
+      DEBUG_puts("ppd_load_constraints: Unable to allocate memory for "
+                "cupsUIConstraints!");
+      return;
+    }
 
-      if ((consts = calloc(1, sizeof(_ppd_cups_uiconsts_t))) == NULL)
-      {
-        DEBUG_puts("ppd_load_constraints: Unable to allocate memory for "
-                  "UIConstraints!");
-        return;
-      }
+    consts->num_constraints = i;
+    consts->constraints     = constptr;
 
-      if ((constptr = calloc(2, sizeof(_ppd_cups_uiconst_t))) == NULL)
-      {
-        free(consts);
-        DEBUG_puts("ppd_load_constraints: Unable to allocate memory for "
-                  "UIConstraints!");
-        return;
-      }
+    strlcpy(consts->resolver, constattr->spec, sizeof(consts->resolver));
 
+    for (i = 0, vptr = strchr(constattr->value, '*');
+        vptr;
+        i ++, vptr = strchr(vptr, '*'), constptr ++)
+    {
      /*
-      * Fill in the information...
+      * Extract "*Option Choice" or just "*Option"...
       */
 
-      consts->num_constraints = 2;
-      consts->constraints     = constptr;
+      for (vptr ++, ptr = option; *vptr && !isspace(*vptr & 255); vptr ++)
+       if (ptr < (option + sizeof(option) - 1))
+         *ptr++ = *vptr;
 
-      if (!strncasecmp(oldconst->option1, "Custom", 6) &&
-          !strcasecmp(oldconst->choice1, "True"))
-      {
-       constptr[0].option      = ppdFindOption(ppd, oldconst->option1 + 6);
-       constptr[0].choice      = ppdFindChoice(constptr[0].option, "Custom");
-        constptr[0].installable = 0;
-      }
-      else
-      {
-       constptr[0].option      = ppdFindOption(ppd, oldconst->option1);
-       constptr[0].choice      = ppdFindChoice(constptr[0].option,
-                                               oldconst->choice1);
-       constptr[0].installable = ppd_is_installable(installable,
-                                                    oldconst->option1);
-      }
+      *ptr = '\0';
 
-      if (!constptr[0].option || (!constptr[0].choice && oldconst->choice1[0]))
-      {
-        DEBUG_printf(("ppd_load_constraints: Unknown option *%s %s!\n",
-                     oldconst->option1, oldconst->choice1));
-        free(consts->constraints);
-       free(consts);
-       continue;
-      }
+      while (isspace(*vptr & 255))
+       vptr ++;
 
-      if (!strncasecmp(oldconst->option2, "Custom", 6) &&
-          !strcasecmp(oldconst->choice2, "True"))
-      {
-       constptr[1].option      = ppdFindOption(ppd, oldconst->option2 + 6);
-       constptr[1].choice      = ppdFindChoice(constptr[1].option, "Custom");
-        constptr[1].installable = 0;
-      }
+      if (*vptr == '*')
+       choice[0] = '\0';
       else
       {
-       constptr[1].option      = ppdFindOption(ppd, oldconst->option2);
-       constptr[1].choice      = ppdFindChoice(constptr[1].option,
-                                               oldconst->choice2);
-       constptr[1].installable = ppd_is_installable(installable,
-                                                    oldconst->option2);
+       for (ptr = choice; *vptr && !isspace(*vptr & 255); vptr ++)
+         if (ptr < (choice + sizeof(choice) - 1))
+           *ptr++ = *vptr;
+
+       *ptr = '\0';
       }
 
-      if (!constptr[1].option || (!constptr[1].choice && oldconst->choice2[0]))
+      if (!strncasecmp(option, "Custom", 6) && !strcasecmp(choice, "True"))
       {
-        DEBUG_printf(("ppd_load_constraints: Unknown option *%s %s!\n",
-                     oldconst->option2, oldconst->choice2));
-        free(consts->constraints);
-       free(consts);
-       continue;
+       _cups_strcpy(option, option + 6);
+       strcpy(choice, "Custom");
       }
 
-      consts->installable = constptr[0].installable || constptr[1].installable;
+      constptr->option      = ppdFindOption(ppd, option);
+      constptr->choice      = ppdFindChoice(constptr->option, choice);
+      constptr->installable = ppd_is_installable(installable, option);
+      consts->installable   |= constptr->installable;
 
-     /*
-      * Add it to the constraints array...
-      */
+      if (!constptr->option || (!constptr->choice && choice[0]))
+      {
+       DEBUG_printf(("ppd_load_constraints: Unknown option *%s %s!\n",
+                     option, choice));
+       break;
+      }
+    }
 
+    if (!vptr)
       cupsArrayAdd(ppd->cups_uiconstraints, consts);
+    else
+    {
+      free(consts->constraints);
+      free(consts);
     }
   }
 }
index 6a1667a9d0091c99f2d2bcc5df16d3419bef82d4..044691b46dcb8455ed0f5dbcb2102e7b1eb4eeba 100644 (file)
@@ -27,14 +27,14 @@ charset utf8
 # Each font that is listed will be downloaded to the printer when used.
 #
 
-0000 00FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique
-0100 01FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique
-0200 02FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique
-0300 03FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique
-0400 04FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique
-1E00 1EFF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique
-2000 20FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique
-2300 23FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique
-2400 24FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique
-2500 25FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique
-2600 26FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique
+0000 00FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique
+0100 01FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique
+0200 02FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique
+0300 03FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique
+0400 04FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique
+1E00 1EFF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique
+2000 20FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique
+2300 23FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique
+2400 24FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique
+2500 25FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique
+2600 26FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique
index 92a397f932f42603e1ca583291053fde13adbac0..016b1d2012423e6ba2d3c555456c4b64f9c8811b 100644 (file)
@@ -54,13 +54,10 @@ HELPFILES   =       \
                        help/man-cupsaccept.html \
                        help/man-backend.html \
                        help/man-cancel.html \
-                       help/man-classes.conf.html \
-                       help/man-client.conf.html \
                        help/man-cups-config.html \
                        help/man-cups-lpd.html \
                        help/man-cups-polld.html \
                        help/man-cupsaddsmb.html \
-                       help/man-cupsd.conf.html \
                        help/man-cupsd.html \
                        help/man-cupsenable.html \
                        help/man-cupstestdsc.html \
@@ -80,11 +77,17 @@ HELPFILES   =       \
                        help/man-lpstat.html \
                        help/man-mime.convs.html \
                        help/man-mime.types.html \
-                       help/man-printers.conf.html \
+                       help/man-ppdc.html \
+                       help/man-ppdhtml.html \
+                       help/man-ppdi.html \
+                       help/man-ppdmerge.html \
+                       help/man-ppdpo.html \
                        help/network.html \
                        help/options.html \
                        help/overview.html \
                        help/policies.html \
+                       help/postscript-driver.html \
+                       help/ppd-compiler.html \
                        help/ref-access_log.html \
                        help/ref-classes-conf.html \
                        help/ref-client-conf.html \
index 5256cae38375a7e838ce4830be650e617c4e281b..e4ad1fbff3a3452d4e26e0a11c63a4ec79f6e462 100644 (file)
@@ -19,6 +19,11 @@ PRE.command {
   margin-left: 36pt;
 }
 
+P.example {
+  font-style: italic;
+  margin-left: 36pt;
+}
+  
 PRE.example {
   background: #eeeeee;
   border: dotted thin #999999;
@@ -46,6 +51,16 @@ BLOCKQUOTE {
   padding: 10pt;
 }
 
+A IMG {
+  border: none;
+}
+
+A:link:hover IMG {
+  background: #f0f0f0;
+  border-radius: 10px;
+  -moz-border-radius: 10px;
+}
+
 A:link, A:visited {
   font-weight: normal;
   text-decoration: none;
@@ -59,6 +74,19 @@ SUB, SUP {
   font-size: 50%;
 }
 
+TR.data, TD.data, TR.data TD {
+  margin-top: 10pt;
+  padding: 5pt;
+  border-bottom: solid 1pt #999999;
+}
+
+TR.data TH {
+  border-bottom: solid 1pt #999999;
+  padding-top: 10pt;
+  padding-left: 5pt;
+  text-align: left;
+}
+
 DIV.table TABLE {
   border: solid thin #999999;
   border-collapse: collapse;
@@ -102,19 +130,23 @@ DIV.figure CAPTION {
 }
 
 TH.label {
-  padding-top: 5pt;
   text-align: right;
   vertical-align: top;
 }
 
+TH.sublabel {
+  text-align: right;
+  font-weight: normal;
+}
+
 HR {
   border: solid thin;
 }
 
 SPAN.info {
-  background: #000000;
-  border: thin solid #000000;
-  color: #ffffff;
+  background: black;
+  border: thin solid black;
+  color: white;
   font-size: 80%;
   font-style: italic;
   font-weight: bold;
@@ -130,6 +162,57 @@ H2.title, H3.title {
   border-bottom: solid 2pt #000000;
 }
 
+DIV.indent, TABLE.indent {
+  margin-top: 2em;
+  margin-left: auto;
+  margin-right: auto;
+  width: 90%;
+}
+
+TABLE.indent {
+  border-collapse: collapse;
+}
+
+TABLE.indent TD, TABLE.indent TH {
+  padding: 0;
+}
+
+TABLE.list {
+  border-collapse: collapse;
+  margin-left: auto;
+  margin-right: auto;
+  width: 90%;
+}
+
+TABLE.list TH {
+  background: white;
+  border-bottom: solid thin #cccccc;
+  color: #444444;
+  padding-top: 10pt;
+  padding-left: 5pt;
+  text-align: left;
+  vertical-align: bottom;
+  white-space: nowrap;
+}
+
+TABLE.list TH A {
+  color: #4444cc;
+}
+
+TABLE.list TD {
+  border-bottom: solid thin #eeeeee;
+  padding-top: 5pt;
+  padding-left: 5pt;
+}
+
+TABLE.list TR:nth-child(even) {
+  background: #f8f8f8;
+}
+
+TABLE.list TR:nth-child(odd) {
+  background: #f4f4f4;
+}
+
 DT {
   margin-left: 36pt;
   margin-top: 12pt;
@@ -148,11 +231,6 @@ P.summary {
   font-family: monaco, courier, monospace;
 }
 
-SPAN.message {
-  font-style: italic;
-  font-size: smaller;
-}
-
 DIV.summary TABLE {
   border: solid thin #999999;
   border-collapse: collapse;
index 44f8f7c65407db745a486e82ca1fd5b1e4d3bbe6..a12db9ca82b9f78fe1ec9d77b6fb60bdfc358598 100644 (file)
@@ -23,6 +23,11 @@ PRE.command {
   margin-left: 36pt;
 }
 
+P.example {
+  font-style: italic;
+  margin-left: 36pt;
+}
+  
 PRE.example {
   background: white;
   border: dotted thin #999999;
@@ -322,11 +327,9 @@ DIV.sidebar P.l2 {
 TABLE.inset {
   background: #f0f0f0;
   border: thin solid #e0e0e0;
-  margin-left: auto;
-  margin-right: auto;
   margin-top: 1em;
   padding: 0;
-  width: 90%;
+  width: 100%;
   /* These are not implemented by all browsers, but that's OK */
   border-radius: 5px;
   -moz-border-radius: 5px;
diff --git a/doc/help/postscript-driver.html b/doc/help/postscript-driver.html
new file mode 100644 (file)
index 0000000..89f2df9
--- /dev/null
@@ -0,0 +1,255 @@
+<HTML>
+<!-- SECTION: Programming -->
+<HEAD>
+       <TITLE>Developing PostScript Printer Drivers</TITLE>
+</HEAD>
+<BODY>
+
+<p>This document describes how to develop printer drivers for PostScript printers. Topics include: <a href='#BASICS'>printer driver basics</a>, <a href='#CREATE'>creating new PPD files</a>, <a href='#IMPORT'>importing existing PPD files</a>, <a href='#FILTERS'>using custom filters</a>, <a href='#COLOR'>implementing color management</a>, <a href='#MACOSX'>adding Mac OS X features</a>, and <a href='#DEPLOY'>deploying your driver</a>.</p>
+
+<div class='summary'><table summary='General Information'>
+<tbody>
+<tr>
+       <th>See Also</th>
+       <td>Programming: <a href='raster-driver.html'>Developing Raster Printer Drivers</a><br>
+       Programming: <a href='api-filter.html'>Filter and Backend Programming</a><br>
+       Programming: <a href='ppd-compiler.html'>Introduction to the PPD Compiler</a><br>
+       Programming: <a href='api-raster.html'>Raster API</a><br>
+       References: <a href='ref-ppdcfile.html'>PPD Compiler Driver Information File Reference</a><br>
+       Specifications: <a href='spec-ppd.html'>CUPS PPD Extensions</a></td>
+</tr>
+</tbody>
+</table></div>
+
+
+<h2 class='title'><a name='BASICS'>Printer Driver Basics</a></h2>
+
+<p>A CUPS PostScript printer driver consists of a PostScript Printer Description (PPD) file that describes the features and capabilities of the device, zero or more <em>filter</em> programs that prepare print data for the device, and zero or more support files for color management, online help, and so forth. The PPD file includes references to all of the filters and support files used by the driver.</p>
+
+<p>Every time a user prints something the scheduler program, <a href='man-cupsd.html'>cupsd(8)</a>, determines the format of the print job and the programs required to convert that job into something the printer understands. CUPS includes filter programs for many common formats, for example to convert Portable Document Format (PDF) files into device-independent PostScript, and then from device-independent PostScript to device-dependent PostScript. <a href='#FIGURE_1'>Figure 1</a> shows the data flow of a typical print job.</p>
+
+<div class='figure'><table summary='PostScript Filter Chain'>
+<caption>Figure 1: <a name='FIGURE_1'>PostScript Filter Chain</a></caption>
+<tr><td><img src='/images/cups-postscript-chain.png' width='700' height='150' alt='PostScript Filter Chain'></td></tr>
+</table></div>
+
+<p>The optional PostScript filter can be provided to add printer-specific commands to the PostScript output that cannot be represented in the PPD file or to reorganize the output for special printer features. Typically this is used to support advanced job management or finishing functions on the printer. CUPS includes a generic PostScript filter that handles all PPD-defined commands.</p>
+
+<p>The optional port monitor handles interface-specific protocol or encoding issues. For example, many PostScript printers support the Binary Communications Protocol (BCP) and Tagged Binary Communications Protocol (TBCP) to allow applications to print 8-bit ("binary") PostScript jobs. CUPS includes port monitors for BCP and TBCP, and you can supply your own port monitors as needed.</p>
+
+<p>The backend handles communications with the printer, sending print data from the last filter to the printer and relaying back-channel data from the printer to the upstream filters. CUPS includes backend programs for common direct-connect interfaces and network protocols, and you can provide your own backend to support custom interfaces and protocols.</p>
+
+<p>The scheduler also supports a special "command" file format for sending maintenance commands and status queries to a printer or printer driver. Command print jobs typically use a single command filter program defined in the PPD file to generate the appropriate printer commands and handle any responses from the printer. <a href='#FIGURE_2'>Figure 2</a> shows the data flow of a typical command job.</p>
+
+<div class='figure'><table summary='Command Filter Chain'>
+<caption>Figure 2: <a name='FIGURE_2'>Command Filter Chain</a></caption>
+<tr><td><img src='/images/cups-command-chain.png' width='575' height='150' alt='Command Filter Chain'></td></tr>
+</table></div>
+
+<p>PostScript printer drivers typically do not require their own command filter since CUPS includes a generic PostScript command filter that supports all of the standard functions using PPD-defined commands.</p>
+
+
+<h2 class='title'><a name='CREATING'>Creating New PPD Files</a></h2>
+
+<p>We recommend using the CUPS PPD compiler, <a href='man-ppdc.html'>ppdc(1)</a>, to create new PPD files since it manages many of the tedious (and error-prone!) details of paper sizes and localization for you. It also allows you to easily support multiple devices from a single source file. For more information see the "<a href='ppd-compiler.html'>Introduction to the PPD Compiler</a>" document. <a href='#LISTING_1'>Listing 1</a> shows a driver information file for a black-and-white PostScript printer.</p>
+
+<p class='example'>Listing 1: <a name='LISTING_1'>"examples/postscript.drv"</a></p>
+
+<pre class='example'>
+// Include standard font and media definitions
+<a href='ref-ppdcfile.html#_include'>#include</a> &lt;font.defs&gt;
+<a href='ref-ppdcfile.html#_include'>#include</a> &lt;media.defs&gt;
+
+// Specify this is a PostScript printer driver
+<a href='ref-ppdcfile.html#DriverType'>DriverType</a> ps
+
+// List the fonts that are supported, in this case all standard fonts
+<a href='ref-ppdcfile.html#Font'>Font</a> *
+
+// Manufacturer, model name, and version
+<a href='ref-ppdcfile.html#Manufacturer'>Manufacturer</a> "Foo"
+<a href='ref-ppdcfile.html#ModelName'>ModelName</a> "Foo LaserProofer 2000"
+<a href='ref-ppdcfile.html#Version'>Version</a> 1.0
+
+// PostScript printer attributes
+<a href='ref-ppdcfile.html#Attribute'>Attribute</a> DefaultColorSpace "" Gray
+<a href='ref-ppdcfile.html#Attribute'>Attribute</a> LandscapeOrientation "" Minus90
+<a href='ref-ppdcfile.html#Attribute'>Attribute</a> LanguageLevel "" "3"
+<a href='ref-ppdcfile.html#Attribute'>Attribute</a> Product "" "(Foo LaserProofer 2000)"
+<a href='ref-ppdcfile.html#Attribute'>Attribute</a> PSVersion "" "(3010) 0"
+<a href='ref-ppdcfile.html#Attribute'>Attribute</a> TTRasterizer "" Type42
+
+// Supported page sizes
+*<a href='ref-ppdcfile.html#MediaSize'>MediaSize</a> Letter
+<a href='ref-ppdcfile.html#MediaSize'>MediaSize</a> Legal
+<a href='ref-ppdcfile.html#MediaSize'>MediaSize</a> A4
+
+// Query command for page size
+<a href='ref-ppdcfile.html#Attribute'>Attribute</a> "?PageSize" "" "
+      save
+      currentpagedevice /PageSize get aload pop
+      2 copy gt {exch} if (Unknown)
+      23 dict
+              dup [612 792] (Letter) put
+              dup [612 1008] (Legal) put
+              dup [595 842] (A4) put
+              {exch aload pop 4 index sub abs 5 le exch 
+               5 index sub abs 5 le and
+              {exch pop exit} {pop} ifelse
+      } bind forall = flush pop pop
+      restore"
+
+// Specify the name of the PPD file we want to generate
+<a href='ref-ppdcfile.html#PCFileName'>PCFileName</a> "fooproof.ppd"
+</pre>
+
+<h3>Required Attributes</h3>
+
+<p>PostScript drivers require the attributes listed in <a href='#TABLE_1'>Table 1</a>. If not specified, the defaults for CUPS drivers are used. A typical PostScript driver information file would include the following attributes:</p>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#Attribute'>Attribute</a> DefaultColorSpace "" Gray
+<a href='ref-ppdcfile.html#Attribute'>Attribute</a> LandscapeOrientation "" Minus90
+<a href='ref-ppdcfile.html#Attribute'>Attribute</a> LanguageLevel "" "3"
+<a href='ref-ppdcfile.html#Attribute'>Attribute</a> Product "" "(Foo LaserProofer 2000)"
+<a href='ref-ppdcfile.html#Attribute'>Attribute</a> PSVersion "" "(3010) 0"
+<a href='ref-ppdcfile.html#Attribute'>Attribute</a> TTRasterizer "" Type42
+</pre>
+
+<div class='table'><table summary='Required PostScript Printer Driver Attributes'>
+<caption>Table 1: <a name='TABLE_1'>Required PostScript Printer Driver Attributes</a></caption>
+<thead>
+<tr>
+       <th>Attribute</th>
+       <th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+       <td><tt>DefaultColorSpace</tt></td>
+       <td>The default colorspace:
+       <tt>Gray</tt>, <tt>RGB</tt>, <tt>CMY</tt>, or
+       <tt>CMYK</tt>. If not specified, then <tt>RGB</tt> is
+       assumed.</td>
+</tr>
+<tr>
+       <td><tt>LandscapeOrientation</tt></td>
+       <td>The preferred landscape
+       orientation: <tt>Plus90</tt>, <tt>Minus90</tt>, or
+       <tt>Any</tt>. If not specified, <tt>Plus90</tt> is
+       assumed.</td>
+</tr>
+<tr>
+       <td><tt>LanguageLevel</tt></td>
+       <td>The PostScript language
+       level supported by the device: 1, 2, or 3. If not
+       specified, 2 is assumed.</td>
+</tr>
+<tr>
+       <td><tt>Product</tt></td>
+       <td>The string returned by
+       the PostScript <tt>product</tt> operator, which
+       <i>must</i> include parenthesis to conform with
+       PostScript syntax rules for strings. Multiple
+       <tt>Product</tt> attributes may be specified to support
+       multiple products with the same PPD file. If not
+       specified, "(ESP Ghostscript)" and "(GNU Ghostscript)"
+       are assumed.</td>
+</tr>
+<tr>
+       <td><tt>PSVersion</tt></td>
+       <td>The PostScript
+       interpreter version numbers as returned by the
+       <tt>version</tt> and <tt>revision</tt> operators. The
+       required format is "(version) revision". Multiple
+       <tt>PSVersion</tt> attributes may be specified to
+       support multiple interpreter version numbers. If not
+       specified, "(3010) 705" and "(3010) 707" are
+       assumed.</td>
+</tr>
+<tr>
+       <td><tt>TTRasterizer</tt></td>
+       <td>The type of TrueType
+       font rasterizer supported by the device, if any. The
+       supported values are <tt>None</tt>, <tt>Accept68k</tt>,
+       <tt>Type42</tt>, and <tt>TrueImage</tt>. If not
+       specified, <tt>None</tt> is assumed.</td>
+</tr>
+</table></div>
+
+<h3>Query Commands</h3>
+
+<p>Most PostScript printer PPD files include query commands (<tt>?PageSize</tt>, etc.) that allow applications to query the printer for its current settings and configuration. Query commands are included in driver information files as attributes. For example, the example in <a href='#LISTING_1'>Listing 1</a> uses the following definition for the <tt>PageSize</tt> query command:</p>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#Attribute'>Attribute</a> "?PageSize" "" "
+      save
+      currentpagedevice /PageSize get aload pop
+      2 copy gt {exch} if (Unknown)
+      23 dict
+              dup [612 792] (Letter) put
+              dup [612 1008] (Legal) put
+              dup [595 842] (A4) put
+              {exch aload pop 4 index sub abs 5 le exch 
+               5 index sub abs 5 le and
+              {exch pop exit} {pop} ifelse
+      } bind forall = flush pop pop
+      restore"
+</pre>
+
+<p>Query commands can span multiple lines, however no single line may contain more than 255 characters.</p>
+
+<h3><a name='IMPORT'>Importing Existing PPD Files</a></h3>
+
+<P>CUPS includes a utility called <a href='man-ppdi.html'>ppdi(1)</a>
+which allows you to import existing PPD files into the driver information file
+format used by the PPD compiler <a href='man-ppdc.html'>ppdc(1)</a>. Once
+imported, you can modify, localize, and regenerate the PPD files easily. Type
+the following command to import the PPD file <VAR>mydevice.ppd</VAR> into the
+driver information file <VAR>mydevice.drv</VAR>:</P>
+
+<pre class='command'>
+ppdi -o mydevice.drv mydevice.ppd
+</pre>
+
+<P>If you have a whole directory of PPD files that you would like to import,
+you can list multiple filenames or use shell wildcards to import more than one
+PPD file on the command-line:</P>
+
+<pre class='command'>
+ppdi -o mydevice.drv mydevice1.ppd mydevice2.ppd
+ppdi -o mydevice.drv *.ppd
+</pre>
+
+<P>If the driver information file already exists, the new PPD
+file entries are appended to the end of the file. Each PPD file
+is placed in its own group of curly braces within the driver
+information file.</P>
+
+
+<h2 class='title'><a name='FILTERS'>Using Custom Filters</a></h2>
+
+<p>Normally a PostScript printer driver will not utilize any additional print filters. For drivers that provide additional filters such as a CUPS command file filter for doing printer maintenance, you must also list the following <tt>Filter</tt> directive to handle printing PostScript files:</p>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#Filter'>Filter</a> application/vnd.cups-postscript 0 -
+</pre>
+
+
+<h2 class='title'><a name='COLOR'>Implementing Color Management</a></h2>
+
+<p>Talk about ICC color profiles and sRGB as two best options.</p>
+
+
+<h2 class='title'><a name='MACOSX'>Adding Mac OS X Features</a></h2>
+
+<p>Talk about help books, icons, and PDEs.</p>
+
+
+<h2 class='title'><a name='DEPLOY'>Deploying Your Driver</a></h2>
+
+<p>Talk about install locations, etc.</p>
+
+
+</body>
+</html>
diff --git a/doc/help/ppd-compiler.html b/doc/help/ppd-compiler.html
new file mode 100644 (file)
index 0000000..aa52b88
--- /dev/null
@@ -0,0 +1,839 @@
+<HTML>
+<!-- SECTION: Programming -->
+<HEAD>
+       <TITLE>Introduction to the PPD Compiler</TITLE>
+</HEAD>
+<BODY>
+
+<P>This document describes how to use the CUPS PostScript Printer Description
+(PPD) file compiler. The PPD compiler generates PPD files from simple text files
+that describe the features and capabilities of one or more printers.</P>
+
+<div class='summary'><table summary='General Information'>
+<tbody>
+<tr>
+       <th>See Also</th>
+       <td>Programming: <a href='raster-driver.html'>Developing Raster Printer Drivers</a><br>
+       Programming: <a href='postscript-driver.html'>Developing PostScript Printer Drivers</a><br>
+       Programming: <a href='api-filter.html'>Filter and Backend Programming</a><br>
+       Programming: <a href='api-raster.html'>Raster API</a><br>
+       References: <a href='ref-ppdcfile.html'>PPD Compiler Driver Information File Reference</a><br>
+       Specifications: <a href='spec-ppd.html'>CUPS PPD Extensions</a></td>
+</tr>
+</tbody>
+</table></div>
+
+
+<h2 class='title'><a name='BASICS'>The Basics</a></h2>
+
+<P>The PPD compiler, <a href='man-ppdc.html'><code>ppdc(1)</code></a>, is a
+simple command-line tool that takes a single <I>driver information file</I>,
+which by convention uses the extension <VAR>.drv</VAR>, and produces one or more
+PPD files that may be distributed with your printer drivers for use with CUPS.
+For example, you would run the following command to create the English language
+PPD files defined by the driver information file <VAR>mydrivers.drv</VAR>:</P>
+
+<pre class='command'>
+ppdc mydrivers.drv
+</pre>
+
+<P>The PPD files are placed in a subdirectory called
+<VAR>ppd</VAR>. The <TT>-d</TT> option is used to put the PPD
+files in a different location, for example:</p>
+
+<pre class='command'>
+ppdc -d myppds mydrivers.drv
+</pre>
+
+<P>places the PPD files in a subdirectory named
+<VAR>myppds</VAR>. Finally, use the <TT>-l</TT> option to
+specify the language localization for the PPD files that are
+created, for example:</P>
+
+<pre class='command'>
+ppdc -d myppds/de -l de mydrivers.drv
+ppdc -d myppds/en -l en mydrivers.drv
+ppdc -d myppds/es -l es mydrivers.drv
+ppdc -d myppds/fr -l fr mydrivers.drv
+ppdc -d myppds/it -l it mydrivers.drv
+</pre>
+
+<P>creates PPD files in German (de), English (en), Spanish (es),
+French (fr), and Italian (it) in the corresponding
+subdirectories. Specify multiple languages (separated by commas) to produce
+"globalized" PPD files:</p>
+
+<pre class='command'>
+ppdc -d myppds -l de,en,es,fr,it mydrivers.drv
+</pre>
+
+
+<h2 class='title'><a name='DRV'>Driver Information Files</a></h2>
+
+<P>The driver information files accepted by the PPD compiler are
+plain text files that define the various attributes and options
+that are included in the PPD files that are generated. A driver
+information file can define the information for one or more printers and
+their corresponding PPD files.</P>
+
+<p class='example'><a name="LISTING1">Listing 1: "examples/minimum.drv"</a></p>
+
+<pre class='example'>
+<I>// Include standard font and media definitions</I>
+<a href='ref-ppdcfile.html#_include'>#include</a> &lt;font.defs&gt;
+<a href='ref-ppdcfile.html#_include'>#include</a> &lt;media.defs&gt;
+
+<I>// List the fonts that are supported, in this case all standard fonts...</I>
+<a href='ref-ppdcfile.html#Font'>Font</a> *
+
+<I>// Manufacturer, model name, and version</I>
+<a href='ref-ppdcfile.html#Manufacturer'>Manufacturer</a> "Foo"
+<a href='ref-ppdcfile.html#ModelName'>ModelName</a> "FooJet 2000"
+<a href='ref-ppdcfile.html#Version'>Version</a> 1.0
+
+<I>// Each filter provided by the driver...</I>
+<a href='ref-ppdcfile.html#Filter'>Filter</a> application/vnd.cups-raster 100 rastertofoo
+
+<I>// Supported page sizes</I>
+*<a href='ref-ppdcfile.html#MediaSize'>MediaSize</a> Letter
+<a href='ref-ppdcfile.html#MediaSize'>MediaSize</a> A4
+
+<I>// Supported resolutions</I>
+*<a href='ref-ppdcfile.html#Resolution'>Resolution</a> k 8 0 0 0 "600dpi/600 DPI"
+
+<I>// Specify the name of the PPD file we want to generate...</I>
+<a href='ref-ppdcfile.html#PCFileName'>PCFileName</a> "foojet2k.ppd"
+</pre>
+
+
+<h3><a name='SIMPLE'>A Simple Example</a></h3>
+
+<P>The example in <A HREF="#LISTING1">Listing 1</A> shows a driver information
+file which defines the minimum required attributes to provide a valid PPD file.
+The first part of the file includes standard definition files for fonts and
+media sizes:</P>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#_include'>#include</a> &lt;font.defs&gt;
+<a href='ref-ppdcfile.html#_include'>#include</a> &lt;media.defs&gt;
+</pre>
+
+<P>The <TT>#include</TT> directive works just like the C/C++ include directive;
+files included using the angle brackets (<TT>&lt;filename&gt;</TT>) are found
+in any of the standard include directories and files included using quotes
+(<TT>"filename"</TT>) are found in the same directory as the source or include
+file. The <TT>&lt;font.defs&gt;</TT> include file defines the standard fonts
+which are included with GPL Ghostscript and the Apple PDF RIP, while the
+<TT>&lt;media.defs&gt;</TT> include file defines the standard media sizes
+listed in Appendix B of the Adobe PostScript Printer Description File Format
+Specification.</P>
+
+<P>CUPS provides several other standard include files:</P>
+
+<UL>
+
+       <LI><TT>&lt;epson.h&gt;</TT> - Defines all of the rastertoepson driver
+       constants.</LI>
+
+       <LI><TT>&lt;escp.h&gt;</TT> - Defines all of the rastertoescpx driver
+       constants.</LI>
+
+       <LI><TT>&lt;hp.h&gt;</TT> - Defines all of the rastertohp driver
+       constants.</LI>
+
+       <LI><TT>&lt;label.h&gt;</TT> - Defines all of the rastertolabel driver
+       constants.</LI>
+
+       <LI><TT>&lt;pcl.h&gt;</TT> - Defines all of the rastertopclx driver
+       constants.</LI>
+
+       <LI><TT>&lt;raster.defs&gt;</TT> - Defines all of the CUPS raster format
+       constants.</LI>
+
+</UL>
+
+<P>Next we list all of the fonts that are available in the driver; for CUPS
+raster drivers, the following line is all that is usually supplied:</P>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#Font'>Font</a> *
+</pre>
+
+<P>The <TT>Font</TT> directive specifies the name of a single font or the
+asterisk to specify all fonts. For example, you would use the following line to
+define an additional bar code font that you are supplying with your printer
+driver:</P>
+
+<pre class='example'>
+<I>//   name         encoding  version  charset  status</I>
+<a href='ref-ppdcfile.html#Font'>Font</a> Barcode-Foo  Special   "(1.0)"  Special  ROM
+</pre>
+
+<P>The name of the font is <TT>Barcode-Foo</TT>. Since it is not a standard
+text font, the encoding and charset name <TT>Special</TT> is used. The version
+number is <TT>1.0</TT> and the status (where the font is located) is
+<TT>ROM</TT> to indicate that the font does not need to be embedded in
+documents that use the font for this printer.</P>
+
+<P>Third comes the manufacturer, model name, and version number information
+strings:</P>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#Manufacturer'>Manufacturer</a> "Foo"
+<a href='ref-ppdcfile.html#ModelName'>ModelName</a> "FooJet 2000"
+<a href='ref-ppdcfile.html#Version'>Version</a> 1.0
+</pre>
+
+<P>These strings are used when the user (or auto-configuration program) selects
+the printer driver for a newly connected device.</p>
+
+<P>The list of filters comes after the information strings; for the example in
+<A HREF="#LISTING1">Listing 1</A>, we have a single filter that takes CUPS
+raster data:</P>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#Filter'>Filter</a> application/vnd.cups-raster 100 rastertofoo
+</pre>
+
+<P>Each filter specified in the driver information file is the equivalent of a
+printer driver for that format; if a user submits a print job in a different
+format, CUPS figures out the sequence of commands that will produce a supported
+format for the least relative cost.</P>
+
+<P>Once we have defined the driver information we specify the supported options.
+For the example driver we support a single resolution of 600 dots per inch and
+two media sizes, A4 and Letter:</P>
+
+<pre class='example'>
+*<a href='ref-ppdcfile.html#MediaSize'>MediaSize</a> Letter
+<a href='ref-ppdcfile.html#MediaSize'>MediaSize</a> A4
+
+*<a href='ref-ppdcfile.html#Resolution'>Resolution</a> k 8 0 0 0 "600dpi/600 DPI"
+</pre>
+
+<P>The asterisk in front of the <TT>MediaSize</TT> and <TT>Resolution</TT>
+directives specify that those option choices are the default. The
+<TT>MediaSize</TT> directive is followed by a media size name which is normally
+defined in the <TT>&lt;media.defs&gt;</TT> file and corresponds to a standard
+Adobe media size name. If the default media size is <TT>Letter</TT>, the PPD
+compiler will override it to be <TT>A4</TT> for non-English localizations for
+you automatically.</P>
+
+<P>The <TT>Resolution</TT> directive accepts several values after it as
+follows:</P>
+
+<OL>
+
+       <LI>Colorspace for this resolution, if any. In the example file, the
+       colorspace <TT>k</TT> is used which corresponds to black. For printer
+       drivers that support color printing, this field is usually specified as
+       "-" for "no change".</LI>
+
+       <LI>Bits per color. In the example file, we define 8 bits per color, for
+       a continuous-tone grayscale output. All versions of CUPS support 1 and
+       8 bits per color.  CUPS 1.2 and higher (Mac OS X 10.5 and higher) also
+       supports 16 bits per color.</LI>
+
+       <LI>Rows per band. In the example file, we define 0 rows per band to
+       indicate that our printer driver does not process the page in
+       bands.</LI>
+
+       <LI>Row feed. In the example, we define the feed value to be 0 to
+       indicate that our printer driver does not interleave the output.</LI>
+
+       <LI>Row step. In the example, we define the step value to be 0 to
+       indicate that our printer driver does not interleave the output. This
+       value normally indicates the spacing between the nozzles of an inkjet
+       printer - when combined with the previous two values, it informs the
+       driver how to stagger the output on the page to produce interleaved
+       lines on the page for higher-resolution output.</LI>
+
+       <LI>Choice name and text. In the example, we define the choice name and
+       text to be <TT>"600dpi/600 DPI"</TT>. The name and text are separated by
+       slash (<TT>/</TT>) character; if no text is specified, then the name is
+       used as the text. The PPD compiler parses the name to determine the
+       actual resolution; the name can be of the form
+       <TT><I>RESOLUTION</I>dpi</TT> for resolutions that are equal
+       horizontally and vertically or <TT><I>HRES</I>x<I>VRES</I>dpi</TT> for
+       isometric resolutions. Only integer resolution values are supported, so
+       a resolution name of <TT>300dpi</TT> is valid while <TT>300.1dpi</TT> is
+       not.</LI>
+
+</OL>
+
+<P>Finally, the <TT>PCFileName</TT> directive specifies that the named PPD file
+should be written for the current driver definitions:</P>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#PCFileName'>PCFileName</a> "foojet2k.ppd"
+</pre>
+
+<P>The filename follows the directive and <I>must</I> conform to the Adobe
+filename requirements in the Adobe Postscript Printer Description File Format
+Specification. Specifically, the filename may not exceed 8 characters followed
+by the extension <VAR>.ppd</VAR>. The <TT>FileName</TT> directive can be used to
+specify longer filenames:</P>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#FileName'>FileName</a> "FooJet 2000"
+</pre>
+
+
+<h3><a name='GROUPING'>Grouping and Inheritance</a></h3>
+
+<P>The previous example created a single PPD file. Driver information files can
+also define multiple printers by using the PPD compiler grouping functionality.
+Directives are grouped using the curly braces (<TT>{</TT> and <TT>}</TT>) and
+every group that uses the <TT>PCFileName</TT> or <TT>FileName</TT> directives
+produces a PPD file with that name. <A HREF="#LISTING2">Listing 2</A> shows a
+variation of the original example that uses two groups to define two printers
+that share the same printer driver filter but provide two different resolution
+options.</P>
+
+<p class='example'><a name="LISTING2">Listing 2: "examples/grouping.drv"</a></p>
+
+<pre class='example'>
+
+<I>// Include standard font and media definitions</I>
+<a href='ref-ppdcfile.html#_include'>#include</a> &lt;font.defs&gt;
+<a href='ref-ppdcfile.html#_include'>#include</a> &lt;media.defs&gt;
+
+<I>// List the fonts that are supported, in this case all standard fonts...</I>
+<a href='ref-ppdcfile.html#Font'>Font</a> *
+
+<I>// Manufacturer and version</I>
+<a href='ref-ppdcfile.html#Manufacturer'>Manufacturer</a> "Foo"
+<a href='ref-ppdcfile.html#Version'>Version</a> 1.0
+
+<I>// Each filter provided by the driver...</I>
+<a href='ref-ppdcfile.html#Filter'>Filter</a> application/vnd.cups-raster 100 rastertofoo
+
+<I>// Supported page sizes</I>
+*<a href='ref-ppdcfile.html#MediaSize'>MediaSize</a> Letter
+<a href='ref-ppdcfile.html#MediaSize'>MediaSize</a> A4
+
+{
+  <I>// Supported resolutions</I>
+  *<a href='ref-ppdcfile.html#Resolution'>Resolution</a> k 8 0 0 0 "600dpi/600 DPI"
+
+  <I>// Specify the model name and filename...</I>
+  <a href='ref-ppdcfile.html#ModelName'>ModelName</a> "FooJet 2000"
+  <a href='ref-ppdcfile.html#PCFileName'>PCFileName</a> "foojet2k.ppd"
+}
+
+{
+  <I>// Supported resolutions</I>
+  *<a href='ref-ppdcfile.html#Resolution'>Resolution</a> k 8 0 0 0 "1200dpi/1200 DPI"
+
+  <I>// Specify the model name and filename...</I>
+  <a href='ref-ppdcfile.html#ModelName'>ModelName</a> "FooJet 2001"
+  <a href='ref-ppdcfile.html#PCFileName'>PCFileName</a> "foojt2k1.ppd"
+}
+</pre>
+
+<P>The second example is essentially the same as the first, except that each
+printer model is defined inside of a pair of curly braces. For example, the
+first printer is defined using:</P>
+
+<pre class='example'>
+{
+  // Supported resolutions
+  *<a href='ref-ppdcfile.html#Resolution'>Resolution</a> k 8 0 0 0 "600dpi/600 DPI"
+
+  // Specify the model name and filename...
+  <a href='ref-ppdcfile.html#ModelName'>ModelName</a> "FooJet 2000"
+  <a href='ref-ppdcfile.html#PCFileName'>PCFileName</a> "foojet2k.ppd"
+}
+</pre>
+
+<P>The printer <I>inherits</I> all of the definitions from the parent group (the
+top part of the file) and adds the additional definitions inside the curly
+braces for that printer driver. When we define the second group, it also
+inherits the same definitions from the parent group but <I>none</I> of the
+definitions from the first driver. Groups can be nested to any number of levels
+to support variations of similar models without duplication of information.</P>
+
+
+<h3><a name='COLOR'>Color Support</a></h3>
+
+<P>For printer drivers that support color printing, the
+<TT>ColorDevice</TT> and <TT>ColorModel</TT> directives should be
+used to tell the printing system that color output is desired
+and in what formats. <A HREF="#LISTING3">Listing 3</A> shows a
+variation of the previous example which includes a color printer
+that supports printing at 300 and 600 DPI.</P>
+
+<P>The key changes are the addition of the <TT>ColorDevice</TT>
+directive:</P>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#ColorDevice'>ColorDevice</a> true
+</pre>
+
+<P>which tells the printing system that the printer supports
+color printing, and the <TT>ColorModel</TT> directives:</P>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#ColorModel'>ColorModel</a> Gray/Grayscale w chunky 0
+*<a href='ref-ppdcfile.html#ColorModel'>ColorModel</a> RGB/Color rgb chunky 0
+</pre>
+
+<P>which tell the printing system which colorspaces are supported by the printer
+driver for color printing. Each of the <TT>ColorModel</TT> directives is
+followed by the option name and text (<TT>Gray/Grayscale</TT> and
+<TT>RGB/Color</TT>), the colorspace name (<TT>w</TT> and <TT>rgb</TT>), the
+color organization (<TT>chunky</TT>), and the compression mode number
+(<TT>0</TT>) to be passed to the driver. The option name can be any of the
+standard Adobe <TT>ColorModel</TT> names:</P>
+
+<UL>
+
+       <LI><TT>Gray</TT> - Grayscale output.
+
+       <LI><TT>RGB</TT> - Color output, typically using the RGB
+       colorspace, but without a separate black channel.
+
+       <LI><TT>CMYK</TT> - Color output with a separate black
+       channel.
+
+</UL>
+
+<P>Custom names can be used, however it is recommended that you use your vendor
+prefix for any custom names, for example "fooName".</P>
+
+<P>The colorspace name can be any of the following universally supported
+colorspaces:</P>
+
+<UL>
+       <LI><TT>w</TT> - Luminance</LI>
+
+       <LI><TT>rgb</TT> - Red, green, blue</LI>
+
+       <LI><TT>k</TT> - Black</LI>
+
+       <LI><TT>cmy</TT> - Cyan, magenta, yellow</LI>
+
+       <LI><TT>cmyk</TT> - Cyan, magenta, yellow, black</LI>
+
+</UL>
+
+<P>The color organization can be any of the following values:</P>
+
+<UL>
+
+       <LI><TT>chunky</TT> - Color values are passed together on a line
+       as RGB RGB RGB RGB</LI>
+
+       <LI><TT>banded</TT> - Color values are passed separately
+       on a line as RRRR GGGG BBBB; not supported by the Apple
+       RIP filters</LI>
+
+       <LI><TT>planar</TT> - Color values are passed separately
+       on a page as RRRR RRRR RRRR ... GGGG GGGG GGGG ... BBBB
+       BBBB BBBB; not supported by the Apple RIP filters</LI>
+
+</UL>
+
+<P>The compression mode value is passed to the driver in the
+<TT>cupsCompression</TT> attribute. It is traditionally used to select an
+appropriate compression mode for the color model but can be used for any
+purpose, such as specifying a photo mode vs. standard mode.</P>
+
+<p class='example'><a name="LISTING3">Listing 3: "examples/color.drv"</a></p>
+
+<pre class='example'>
+
+<I>// Include standard font and media definitions</I>
+<a href='ref-ppdcfile.html#_include'>#include</a> &lt;font.defs&gt;
+<a href='ref-ppdcfile.html#_include'>#include</a> &lt;media.defs&gt;
+
+<I>// List the fonts that are supported, in this case all standard fonts...</I>
+<a href='ref-ppdcfile.html#Font'>Font</a> *
+
+<I>// Manufacturer and version</I>
+<a href='ref-ppdcfile.html#Manufacturer'>Manufacturer</a> "Foo"
+<a href='ref-ppdcfile.html#Version'>Version</a> 1.0
+
+<I>// Each filter provided by the driver...</I>
+<a href='ref-ppdcfile.html#Filter'>Filter</a> application/vnd.cups-raster 100 rastertofoo
+
+<I>// Supported page sizes</I>
+*<a href='ref-ppdcfile.html#MediaSize'>MediaSize</a> Letter
+<a href='ref-ppdcfile.html#MediaSize'>MediaSize</a> A4
+
+{
+  <I>// Supported resolutions</I>
+  *<a href='ref-ppdcfile.html#Resolution'>Resolution</a> k 8 0 0 0 "600dpi/600 DPI"
+
+  <I>// Specify the model name and filename...</I>
+  <a href='ref-ppdcfile.html#ModelName'>ModelName</a> "FooJet 2000"
+  <a href='ref-ppdcfile.html#PCFileName'>PCFileName</a> "foojet2k.ppd"
+}
+
+{
+  <I>// Supports color printing</I>
+  <a href='ref-ppdcfile.html#ColorDevice'>ColorDevice</a> true
+
+  <I>// Supported colorspaces</I>
+  <a href='ref-ppdcfile.html#ColorModel'>ColorModel</a> Gray/Grayscale w chunky 0
+  *<a href='ref-ppdcfile.html#ColorModel'>ColorModel</a> RGB/Color rgb chunky 0
+
+  <I>// Supported resolutions</I>
+  *<a href='ref-ppdcfile.html#Resolution'>Resolution</a> - 8 0 0 0 "300dpi/300 DPI"
+  <a href='ref-ppdcfile.html#Resolution'>Resolution</a> - 8 0 0 0 "600dpi/600 DPI"
+
+  <I>// Specify the model name and filename...</I>
+  <a href='ref-ppdcfile.html#ModelName'>ModelName</a> "FooJet Color"
+  <a href='ref-ppdcfile.html#PCFileName'>PCFileName</a> "foojetco.ppd"
+}
+</pre>
+
+
+<h3><a name='OPTIONS'>Defining Custom Options and Option Groups</a></h3>
+
+<P>The <TT>Group</TT>, <TT>Option</TT>, and <TT>Choice</TT>
+directives are used to define or select a group, option, or
+choice. <A HREF="#LISTING4">Listing 4</A> shows a variation of
+the first example that provides two custom options in a group
+named "Footasm".</P>
+
+<p class='example'><a name="LISTING4">Listing 4: "examples/custom.drv"</a></p>
+
+<pre class='example'>
+
+<I>// Include standard font and media definitions</I>
+<a href='ref-ppdcfile.html#_include'>#include</a> &lt;font.defs&gt;
+<a href='ref-ppdcfile.html#_include'>#include</a> &lt;media.defs&gt;
+
+<I>// List the fonts that are supported, in this case all standard fonts...</I>
+<a href='ref-ppdcfile.html#Font'>Font</a> *
+
+<I>// Manufacturer, model name, and version</I>
+<a href='ref-ppdcfile.html#Manufacturer'>Manufacturer</a> "Foo"
+<a href='ref-ppdcfile.html#ModelName'>ModelName</a> "FooJet 2000"
+<a href='ref-ppdcfile.html#Version'>Version</a> 1.0
+
+<I>// Each filter provided by the driver...</I>
+<a href='ref-ppdcfile.html#Filter'>Filter</a> application/vnd.cups-raster 100 rastertofoo
+
+<I>// Supported page sizes</I>
+*<a href='ref-ppdcfile.html#MediaSize'>MediaSize</a> Letter
+<a href='ref-ppdcfile.html#MediaSize'>MediaSize</a> A4
+
+<I>// Supported resolutions</I>
+*<a href='ref-ppdcfile.html#Resolution'>Resolution</a> k 8 0 0 0 "600dpi/600 DPI"
+
+<I>// Option Group</I>
+<a href='ref-ppdcfile.html#Group'>Group</a> "Footasm"
+
+  <I>// Boolean option</I>
+  <a href='ref-ppdcfile.html#Option'>Option</a> "fooEnhance/Resolution Enhancement" Boolean AnySetup 10
+    *<a href='ref-ppdcfile.html#Choice'>Choice</a> True/Yes "&lt;&lt;/cupsCompression 1&gt;&gt;setpagedevice"
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> False/No "&lt;&lt;/cupsCompression 0&gt;&gt;setpagedevice"
+
+  <I>// Multiple choice option</I>
+  <a href='ref-ppdcfile.html#Option'>Option</a> "fooOutputType/Output Quality" PickOne AnySetup 10
+    *<a href='ref-ppdcfile.html#Choice'>Choice</a> "Auto/Automatic Selection"
+            "&lt;&lt;/OutputType(Auto)&gt;&gt;setpagedevice""
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "Text/Optimize for Text"
+            "&lt;&lt;/OutputType(Text)&gt;&gt;setpagedevice""
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "Graph/Optimize for Graphics"
+            "&lt;&lt;/OutputType(Graph)&gt;&gt;setpagedevice""
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "Photo/Optimize for Photos"
+            "&lt;&lt;/OutputType(Photo)&gt;&gt;setpagedevice""
+
+<I>// Specify the name of the PPD file we want to generate...</I>
+<a href='ref-ppdcfile.html#PCFileName'>PCFileName</a> "foojet2k.ppd"
+</pre>
+
+<P>The custom group is introduced by the <TT>Group</TT>
+directive which is followed by the name and optionally text for
+the user:</P>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#Group'>Group</a> "Footasm/Footastic Options"
+</pre>
+
+<P>The group name must conform to the PPD specification and
+cannot exceed 40 characters in length. If you specify user text,
+it cannot exceed 80 characters in length. The groups
+<TT>General</TT>, <TT>Extra</TT>, and
+<TT>InstallableOptions</TT> are predefined by CUPS; the general
+and extra groups are filled by the UI options defined by the PPD
+specification. The <TT>InstallableOptions</TT> group is reserved
+for options that define whether accessories for the printer
+(duplexer unit, finisher, stapler, etc.) are installed.</P>
+
+<P>Once the group is specified, the <TT>Option</TT> directive is
+used to introduce a new option:</P>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#Option'>Option</a> "fooEnhance/Resolution Enhancement" Boolean AnySetup 10
+</pre>
+
+<P>The directive is followed by the name of the option and any
+optional user text, the option type, the PostScript document group, and
+the sort order number. The option name must conform to the PPD specification
+and cannot exceed 40 characters in length. If you specify user text, it
+cannot exceed 80 characters in length.</P>
+
+<P>The option type can be <TT>Boolean</TT> for true/false
+selections, <TT>PickOne</TT> for picking one of many choices, or
+<TT>PickMany</TT> for picking zero or more choices. Boolean
+options can have at most two choices with the names
+<TT>False</TT> and <TT>True</TT>. Pick options can have any
+number of choices, although for Windows compatibility reasons
+the number of choices should not exceed 255.</P>
+
+<P>The PostScript document group is typically <TT>AnySetup</TT>,
+meaning that the option can be introduced at any point in the
+PostScript document. Other values include <TT>PageSetup</TT> to
+include the option before each page and <TT>DocumentSetup</TT>
+to include the option once at the beginning of the document.</P>
+
+<P>The sort order number is used to sort the printer commands
+associated with each option choice within the PostScript
+document. This allows you to setup certain options before others
+as required by the printer. For most CUPS raster printer
+drivers, the value <TT>10</TT> can be used for all options.</P>
+
+<P>Once the option is specified, each option choice can be
+listed using the <TT>Choice</TT> directive:</P>
+
+<pre class='example'>
+*<a href='ref-ppdcfile.html#Choice'>Choice</a> True/Yes "&lt;&lt;/cupsCompression 1&gt;&gt;setpagedevice"
+<a href='ref-ppdcfile.html#Choice'>Choice</a> False/No "&lt;&lt;/cupsCompression 0&gt;&gt;setpagedevice"
+</pre>
+
+<P>The directive is followed by the choice name and optionally
+user text, and the PostScript commands that should be inserted
+when printing a file to this printer. The option name must
+conform to the PPD specification and cannot exceed 40 characters
+in length. If you specify user text, it cannot exceed 80
+characters in length.</P>
+
+<P>The PostScript commands are also interpreted by any RIP
+filters, so these commands typically must be present for all
+option choices. Most commands take the form:</P>
+
+<pre class='example'>
+&lt;&lt;/name value&gt;&gt;setpagedevice
+</pre>
+
+<P>where <TT>name</TT> is the name of the PostScript page device
+attribute and <TT>value</TT> is the numeric or string value for
+that attribute.</P>
+
+
+<h3><a name='DEFINE'>Defining Constants</a></h3>
+
+<P>Sometimes you will want to define constants for your drivers
+so that you can share values in different groups within the same
+driver information file, or to share values between different
+driver information files using the <TT>#include</TT> directive.
+The <TT>#define</TT> directive is used to define constants for
+use in your printer definitions:</P>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#_define'>#define</a> NAME value
+</pre>
+
+<P>The <TT>NAME</TT> is any sequence of letters, numbers, and
+the underscore. The <TT>value</TT> is a number or string; if the
+value contains spaces you must put double quotes around it, for
+example:</P>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#_define'>#define</a> FOO "My String Value"
+</pre>
+
+<P>Constants can also be defined on the command-line using the <tt>-D</tt>
+option:</P>
+
+<pre class='command'>
+ppdc -DNAME="value" filename.drv
+</pre>
+
+<P>Once defined, you use the notation <TT>$NAME</TT> to substitute the value of
+the constant in the file, for example:</P>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#_define'>#define</a> MANUFACTURER "Foo"
+<a href='ref-ppdcfile.html#_define'>#define</a> FOO_600      0
+<a href='ref-ppdcfile.html#_define'>#define</a> FOO_1200     1
+
+{
+  <a href='ref-ppdcfile.html#Manufacturer'>Manufacturer</a> "$MANUFACTURER"
+  <a href='ref-ppdcfile.html#ModelNumber'>ModelNumber</a> $FOO_600
+  <a href='ref-ppdcfile.html#ModelName'>ModelName</a> "FooJet 2000"
+  ...
+}
+
+{
+  <a href='ref-ppdcfile.html#Manufacturer'>Manufacturer</a> "$MANUFACTURER"
+  <a href='ref-ppdcfile.html#ModelNumber'>ModelNumber</a> $FOO_1200
+  <a href='ref-ppdcfile.html#ModelName'>ModelName</a> "FooJet 2001"
+  ...
+}
+</pre>
+
+<P>Numeric constants can be bitwise OR'd together by placing the constants
+inside parenthesis, for example:</P>
+
+<pre class='example'>
+<I>// ModelNumber capability bits</I>
+<a href='ref-ppdcfile.html#_define'>#define</a> DUPLEX 1
+<a href='ref-ppdcfile.html#_define'>#define</a> COLOR  2
+
+...
+
+{
+  <I>// Define a model number specifying the capabilities of the printer...</I>
+  <a href='ref-ppdcfile.html#ModelNumber'>ModelNumber</a> ($DUPLEX $COLOR)
+  ...
+}
+</pre>
+
+
+<h3><a name='CONDITIONAL'>Conditional Statements</a></h3>
+
+<p>The PPD compiler supports conditional compilation using the <tt>#if</tt>,
+<tt>#elif</tt>, <tt>#else</tt>, and <tt>#endif</tt> directives. The <tt>#if</tt>
+and <tt>#elif</tt> directives are followed by a constant name or an expression.
+For example, to include a group of options when "ADVANCED" is defined:</p>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#_if'>#if</a> ADVANCED
+<a href='ref-ppdcfile.html#Group'>Group</a> "Advanced/Advanced Options"
+  <a href='ref-ppdcfile.html#Option'>Option</a> "fooCyanAdjust/Cyan Adjustment"
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "plus10/+10%" ""
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "plus5/+5%" ""
+    *<a href='ref-ppdcfile.html#Choice'>Choice</a> "none/No Adjustment" ""
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "minus5/-5%" ""
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "minus10/-10%" ""
+  <a href='ref-ppdcfile.html#Option'>Option</a> "fooMagentaAdjust/Magenta Adjustment"
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "plus10/+10%" ""
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "plus5/+5%" ""
+    *<a href='ref-ppdcfile.html#Choice'>Choice</a> "none/No Adjustment" ""
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "minus5/-5%" ""
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "minus10/-10%" ""
+  <a href='ref-ppdcfile.html#Option'>Option</a> "fooYellowAdjust/Yellow Adjustment"
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "plus10/+10%" ""
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "plus5/+5%" ""
+    *<a href='ref-ppdcfile.html#Choice'>Choice</a> "none/No Adjustment" ""
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "minus5/-5%" ""
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "minus10/-10%" ""
+  <a href='ref-ppdcfile.html#Option'>Option</a> "fooBlackAdjust/Black Adjustment"
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "plus10/+10%" ""
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "plus5/+5%" ""
+    *<a href='ref-ppdcfile.html#Choice'>Choice</a> "none/No Adjustment" ""
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "minus5/-5%" ""
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "minus10/-10%" ""
+<a href='ref-ppdcfile.html#_endif'>#endif</a>
+</pre>
+
+
+<h3><a name='CONSTRAINTS'>Defining Constraints</a></h3>
+
+<P>Constraints are strings that are used to specify that one or more option
+choices are incompatible, for example two-sided printing on transparency media.
+Constraints are also used to prevent the use of uninstalled features such as the
+duplexer unit, additional media trays, and so forth.</P>
+
+<P>The <TT>UIConstraints</TT> directive is used to specify a constraint that is
+placed in the PPD file. The directive is followed by a string using one of the
+following formats:</P>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#UIConstraints'>UIConstraints</a> "*Option1 *Option2"
+<a href='ref-ppdcfile.html#UIConstraints'>UIConstraints</a> "*Option1 Choice1 *Option2"
+<a href='ref-ppdcfile.html#UIConstraints'>UIConstraints</a> "*Option1 *Option2 Choice2"
+<a href='ref-ppdcfile.html#UIConstraints'>UIConstraints</a> "*Option1 Choice1 *Option2 Choice2"
+</pre>
+
+<P>Each option name is preceded by the asterisk (<TT>*</TT>). If no choice is
+given for an option, then all choices <I>except</I> <TT>False</TT> and
+<TT>None</TT> will conflict with the other option and choice(s). Since the PPD
+compiler automatically adds reciprocal constraints (option A conflicts with
+option B, so therefore option B conflicts with option A), you need only specify
+the constraint once.</P>
+
+<p class='example'><a name="LISTING5">Listing 5: "examples/constraint.drv"</a></p>
+
+<pre class='example'>
+
+<I>// Include standard font and media definitions</I>
+<a href='ref-ppdcfile.html#_include'>#include</a> &lt;font.defs&gt;
+<a href='ref-ppdcfile.html#_include'>#include</a> &lt;media.defs&gt;
+
+<I>// List the fonts that are supported, in this case all standard fonts...</I>
+<a href='ref-ppdcfile.html#Font'>Font</a> *
+
+<I>// Manufacturer, model name, and version</I>
+<a href='ref-ppdcfile.html#Manufacturer'>Manufacturer</a> "Foo"
+<a href='ref-ppdcfile.html#ModelName'>ModelName</a> "FooJet 2000"
+<a href='ref-ppdcfile.html#Version'>Version</a> 1.0
+
+<I>// Each filter provided by the driver...</I>
+<a href='ref-ppdcfile.html#Filter'>Filter</a> application/vnd.cups-raster 100 rastertofoo
+
+<I>// Supported page sizes</I>
+*<a href='ref-ppdcfile.html#MediaSize'>MediaSize</a> Letter
+<a href='ref-ppdcfile.html#MediaSize'>MediaSize</a> A4
+
+<I>// Supported resolutions</I>
+*<a href='ref-ppdcfile.html#Resolution'>Resolution</a> k 8 0 0 0 "600dpi/600 DPI"
+
+<I>// Installable Option Group</I>
+<a href='ref-ppdcfile.html#Group'>Group</a> "InstallableOptions/Options Installed"
+
+  <I>// Duplexing unit option</I>
+  <a href='ref-ppdcfile.html#Option'>Option</a> "OptionDuplexer/Duplexing Unit" Boolean AnySetup 10
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> True/Installed ""
+    *<a href='ref-ppdcfile.html#Choice'>Choice</a> "False/Not Installed" ""
+
+<I>// General Option Group</I>
+<a href='ref-ppdcfile.html#Group'>Group</a> General
+
+  <I>// Duplexing option</I>
+  <a href='ref-ppdcfile.html#Option'>Option</a> "Duplex/Two-Sided Printing" PickOne AnySetup 10
+    *<a href='ref-ppdcfile.html#Choice'>Choice</a> "None/No" "&lt;&lt;/Duplex false&gt;&gt;setpagedevice""
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "DuplexNoTumble/Long Edge Binding"
+           "&lt;&lt;/Duplex true/Tumble false&gt;&gt;setpagedevice""
+    <a href='ref-ppdcfile.html#Choice'>Choice</a> "DuplexTumble/Short Edge Binding"
+           "&lt;&lt;/Duplex true/Tumble true&gt;&gt;setpagedevice""
+
+<I>// Only allow duplexing if the duplexer is installed</I>
+<a href='ref-ppdcfile.html#UIConstraints'>UIConstraints</a> "*Duplex *OptionDuplexer False"
+
+<I>// Specify the name of the PPD file we want to generate...</I>
+<a href='ref-ppdcfile.html#PCFileName'>PCFileName</a> "foojet2k.ppd"
+</pre>
+
+<P><A HREF="#LISTING5">Listing 5</A> shows a variation of the first example with
+an added <TT>Duplex</TT> option and installable option for the duplexer,
+<TT>OptionDuplex</TT>. A constraint is added at the end to specify that any
+choice of the <TT>Duplex</TT> option that is not <TT>None</TT> is incompatible
+with the "Duplexer Installed" option set to "Not Installed"
+(<TT>False</TT>):</P>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#UIConstraints'>UIConstraints</a> "*Duplex *OptionDuplexer False"
+</pre>
+
+<h4>Enhanced Constraints</h4>
+
+<p>CUPS 1.4 supports constraints between 2 or more options using the
+<TT>Attribute</TT> directive. <TT>cupsUIConstraints</TT> attributes define
+the constraints, while <TT>cupsUIResolver</TT> attributes define option changes
+to resolve constraints. For example, we can specify the previous duplex
+constraint with a resolver that turns off duplexing with the following two
+lines:</p>
+
+<pre class='example'>
+<a href='ref-ppdcfile.html#Attribute'>Attribute</a> cupsUIConstraints DuplexOff "*Duplex *OptionDuplexer False"
+<a href='ref-ppdcfile.html#Attribute'>Attribute</a> cupsUIResolver DuplexOff "*Duplex None"
+</pre>
+
+</BODY>
+</HTML>
index 86619e3efd26170d95579807ad0b014048ed672f..4549586b6fbaa7852be62bcac89d04bda2d0183c 100644 (file)
@@ -2404,7 +2404,7 @@ supported keywords for each type.</p>
        <BR><A NAME="REF_COLOR_APPLE2">*</A> = This color order
        is not supported by the current Apple RIP filters and
        should not be used when developing printer drivers for
-       MacOS X 10.2 or 10.3.</LI>
+       Mac OS X.</LI>
 
 </UL>
 
diff --git a/doc/images/cups-command-chain.png b/doc/images/cups-command-chain.png
new file mode 100644 (file)
index 0000000..a7218e5
Binary files /dev/null and b/doc/images/cups-command-chain.png differ
diff --git a/doc/images/cups-command-chain.svg b/doc/images/cups-command-chain.svg
new file mode 100644 (file)
index 0000000..7eb3617
--- /dev/null
@@ -0,0 +1,439 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="517.5"
+   height="135"
+   id="svg2"
+   sodipodi:version="0.32"
+   inkscape:version="0.46"
+   version="1.0"
+   sodipodi:docname="cups-command-chain.svg"
+   inkscape:output_extension="org.inkscape.output.svg.inkscape"
+   inkscape:export-filename="/Users/msweet/c/cups-trunk/doc/images/cups-command-chain.png"
+   inkscape:export-xdpi="100"
+   inkscape:export-ydpi="100">
+  <defs
+     id="defs4">
+    <marker
+       inkscape:stockid="TriangleInS"
+       orient="auto"
+       refY="0.0"
+       refX="0.0"
+       id="TriangleInS"
+       style="overflow:visible">
+      <path
+         id="path4263"
+         d="M 5.77,0.0 L -2.88,5.0 L -2.88,-5.0 L 5.77,0.0 z "
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1.0pt;marker-start:none"
+         transform="scale(-0.2)" />
+    </marker>
+    <marker
+       inkscape:stockid="TriangleOutS"
+       orient="auto"
+       refY="0.0"
+       refX="0.0"
+       id="TriangleOutS"
+       style="overflow:visible">
+      <path
+         id="path4272"
+         d="M 5.77,0.0 L -2.88,5.0 L -2.88,-5.0 L 5.77,0.0 z "
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1.0pt;marker-start:none"
+         transform="scale(0.2)" />
+    </marker>
+    <marker
+       inkscape:stockid="TriangleOutM"
+       orient="auto"
+       refY="0.0"
+       refX="0.0"
+       id="TriangleOutM"
+       style="overflow:visible">
+      <path
+         id="path4269"
+         d="M 5.77,0.0 L -2.88,5.0 L -2.88,-5.0 L 5.77,0.0 z "
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1.0pt;marker-start:none"
+         transform="scale(0.4)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Mend"
+       orient="auto"
+       refY="0.0"
+       refX="0.0"
+       id="Arrow1Mend"
+       style="overflow:visible;">
+      <path
+         id="path4132"
+         d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1.0pt;marker-start:none;"
+         transform="scale(0.4) rotate(180) translate(10,0)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Sstart"
+       orient="auto"
+       refY="0.0"
+       refX="0.0"
+       id="Arrow1Sstart"
+       style="overflow:visible">
+      <path
+         id="path4135"
+         d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1.0pt;marker-start:none"
+         transform="scale(0.2) translate(6,0)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow2Lstart"
+       orient="auto"
+       refY="0.0"
+       refX="0.0"
+       id="Arrow2Lstart"
+       style="overflow:visible">
+      <path
+         id="path4141"
+         style="font-size:12.0;fill-rule:evenodd;stroke-width:0.62500000;stroke-linejoin:round"
+         d="M 8.7185878,4.0337352 L -2.2072895,0.016013256 L 8.7185884,-4.0017078 C 6.9730900,-1.6296469 6.9831476,1.6157441 8.7185878,4.0337352 z "
+         transform="scale(1.1) translate(1,0)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Lstart"
+       orient="auto"
+       refY="0.0"
+       refX="0.0"
+       id="Arrow1Lstart"
+       style="overflow:visible">
+      <path
+         id="path4123"
+         d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1.0pt;marker-start:none"
+         transform="scale(0.8) translate(12.5,0)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow2Mstart"
+       orient="auto"
+       refY="0.0"
+       refX="0.0"
+       id="Arrow2Mstart"
+       style="overflow:visible">
+      <path
+         id="path4147"
+         style="font-size:12.0;fill-rule:evenodd;stroke-width:0.62500000;stroke-linejoin:round"
+         d="M 8.7185878,4.0337352 L -2.2072895,0.016013256 L 8.7185884,-4.0017078 C 6.9730900,-1.6296469 6.9831476,1.6157441 8.7185878,4.0337352 z "
+         transform="scale(0.6) translate(0,0)" />
+    </marker>
+    <inkscape:perspective
+       sodipodi:type="inkscape:persp3d"
+       inkscape:vp_x="-490.8657 : 919.3427 : 1"
+       inkscape:vp_y="9.6977444e-14 : 1482.3941 : 0"
+       inkscape:vp_z="687.60276 : 919.3427 : 1"
+       inkscape:persp3d-origin="98.368532 : 659.34009 : 1"
+       id="perspective10" />
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     gridtolerance="10"
+     guidetolerance="10"
+     objecttolerance="10"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="1.810628"
+     inkscape:cx="258.75"
+     inkscape:cy="67.5"
+     inkscape:document-units="in"
+     inkscape:current-layer="layer1"
+     showgrid="true"
+     units="in"
+     inkscape:snap-bbox="true"
+     inkscape:object-paths="true"
+     inkscape:object-nodes="true"
+     inkscape:bbox-paths="true"
+     inkscape:bbox-nodes="true"
+     inkscape:snap-intersection-line-segments="true"
+     inkscape:window-width="1073"
+     inkscape:window-height="701"
+     inkscape:window-x="747"
+     inkscape:window-y="9">
+    <inkscape:grid
+       type="xygrid"
+       id="grid2383"
+       visible="true"
+       enabled="true"
+       units="in"
+       spacingx="0.125in"
+       spacingy="0.125in"
+       dotted="false"
+       empspacing="8" />
+  </sodipodi:namedview>
+  <metadata
+     id="metadata7">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1">
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:2.25;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="M 135,56.25 L 135,78.75"
+       id="path10785" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:8.12441158;stroke-linecap:butt;stroke-linejoin:miter;marker-start:none;marker-mid:none;marker-end:url(#TriangleOutS);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="M 55.812205,101.25 L 89.77536,101.25"
+       id="path4118" />
+    <path
+       id="path10220"
+       d="M 403.15192,101.25 L 429.50524,101.25"
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:7.40767479;stroke-linecap:butt;stroke-linejoin:miter;marker-start:url(#TriangleInS);marker-mid:none;marker-end:url(#TriangleOutS);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:7.32613468;stroke-linecap:butt;stroke-linejoin:miter;marker-start:url(#TriangleInS);marker-mid:none;marker-end:url(#TriangleOutS);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="M 290.97054,101.25 L 316.53195,101.25"
+       id="path10781" />
+    <path
+       id="path10783"
+       d="M 178.34513,101.80229 L 203.90654,101.80229"
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:7.32613468;stroke-linecap:butt;stroke-linejoin:miter;marker-start:url(#TriangleInS);marker-mid:none;marker-end:url(#TriangleOutS);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+    <g
+       id="g3596"
+       transform="matrix(0.5,0,0,0.5,67.958488,-33.525)">
+      <rect
+         y="100.83127"
+         x="90"
+         height="67.22084"
+         width="90"
+         id="rect3582"
+         style="fill:#e8e8e8;fill-opacity:1;stroke:none;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1" />
+      <path
+         d="M 180,101.25 A 45,11.25 0 1 1 90,101.25 A 45,11.25 0 1 1 180,101.25 z"
+         sodipodi:ry="11.25"
+         sodipodi:rx="45"
+         sodipodi:cy="101.25"
+         sodipodi:cx="135"
+         id="path3580"
+         style="fill:#e8e8e8;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+         sodipodi:type="arc" />
+      <path
+         sodipodi:end="3.1415927"
+         sodipodi:start="0"
+         transform="matrix(1,0,0,1.0799999,0,58.500006)"
+         sodipodi:type="arc"
+         style="fill:#e8e8e8;fill-opacity:1;stroke:none;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+         id="path3584"
+         sodipodi:cx="135"
+         sodipodi:cy="101.25"
+         sodipodi:rx="45"
+         sodipodi:ry="11.25"
+         d="M 180,101.25 A 45,11.25 0 1 1 90,101.25 L 135,101.25 z" />
+      <path
+         sodipodi:open="true"
+         d="M 180,101.25 A 45,11.25 0 1 1 90,101.25"
+         sodipodi:ry="11.25"
+         sodipodi:rx="45"
+         sodipodi:cy="101.25"
+         sodipodi:cx="135"
+         id="path3586"
+         style="fill:none;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+         sodipodi:type="arc"
+         transform="translate(-0.45,67.05)"
+         sodipodi:start="0"
+         sodipodi:end="3.1415927" />
+      <path
+         id="path3588"
+         d="M 90,99.9365 L 89.583023,168.73466"
+         style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" />
+      <path
+         style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+         d="M 180,100.94936 L 179.58302,169.74752"
+         id="path3590" />
+      <text
+         sodipodi:linespacing="125%"
+         id="text3592"
+         y="149.58008"
+         x="134.30273"
+         style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:125%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+         xml:space="preserve"><tspan
+           y="149.58008"
+           x="134.30273"
+           id="tspan3594"
+           sodipodi:role="line">PPD</tspan></text>
+    </g>
+    <g
+       id="g4096"
+       transform="translate(0.2249985,-11.025002)">
+      <rect
+         style="fill:#e8e8e8;fill-opacity:1;stroke:#000000;stroke-width:0.44999999;stroke-miterlimit:4;stroke-dasharray:0.45, 0.45;stroke-dashoffset:0;stroke-opacity:1"
+         id="rect3608"
+         width="67.5"
+         height="45"
+         x="101.025"
+         y="89.775002" />
+      <flowRoot
+         xml:space="preserve"
+         style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:100%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+         id="flowRoot3610"
+         transform="matrix(0.5,0,0,0.5,134.70508,106.84766)"><flowRegion
+           id="flowRegion3612" /><flowPara
+           id="flowPara3616">Optional</flowPara><flowPara
+           id="flowPara3620">Command</flowPara><flowPara
+           id="flowPara3618">Filter</flowPara></flowRoot>    </g>
+    <g
+       id="g3724"
+       transform="matrix(0.5,0,0,0.5,-33.291512,33.75)">
+      <g
+         id="g3744">
+        <rect
+           y="100.83127"
+           x="90"
+           height="67.22084"
+           width="90"
+           id="rect3726"
+           style="fill:#e8e8e8;fill-opacity:1;stroke:none;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1" />
+        <path
+           d="M 180,101.25 A 45,11.25 0 1 1 90,101.25 A 45,11.25 0 1 1 180,101.25 z"
+           sodipodi:ry="11.25"
+           sodipodi:rx="45"
+           sodipodi:cy="101.25"
+           sodipodi:cx="135"
+           id="path3728"
+           style="fill:#e8e8e8;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+           sodipodi:type="arc" />
+        <path
+           sodipodi:end="3.1415927"
+           sodipodi:start="0"
+           transform="matrix(1,0,0,1.0799999,0,58.500006)"
+           sodipodi:type="arc"
+           style="fill:#e8e8e8;fill-opacity:1;stroke:none;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+           id="path3730"
+           sodipodi:cx="135"
+           sodipodi:cy="101.25"
+           sodipodi:rx="45"
+           sodipodi:ry="11.25"
+           d="M 180,101.25 A 45,11.25 0 1 1 90,101.25 L 135,101.25 z" />
+        <path
+           sodipodi:open="true"
+           d="M 180,101.25 A 45,11.25 0 1 1 90,101.25"
+           sodipodi:ry="11.25"
+           sodipodi:rx="45"
+           sodipodi:cy="101.25"
+           sodipodi:cx="135"
+           id="path3732"
+           style="fill:none;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+           sodipodi:type="arc"
+           transform="translate(-0.45,67.05)"
+           sodipodi:start="0"
+           sodipodi:end="3.1415927" />
+        <path
+           id="path3734"
+           d="M 90,99.9365 L 89.583023,168.73466"
+           style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" />
+        <path
+           style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+           d="M 180,100.94936 L 179.58302,169.74752"
+           id="path3736" />
+        <text
+           sodipodi:linespacing="100%"
+           id="text3738"
+           y="139.58008"
+           x="134.30273"
+           style="font-size:16px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:100%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+           xml:space="preserve"><tspan
+             y="139.58008"
+             x="134.30273"
+             id="tspan3740"
+             sodipodi:role="line">Command</tspan><tspan
+             id="tspan3742"
+             y="155.58008"
+             x="134.30273"
+             sodipodi:role="line">File</tspan></text>
+      </g>
+    </g>
+    <g
+       transform="matrix(0.5,0,0,0.5,202.63501,-10.934996)"
+       id="g3893">
+      <rect
+         style="fill:#e8e8e8;fill-opacity:1;stroke:#747474;stroke-width:0.38684496;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+         id="rect3887"
+         width="90"
+         height="51.961464"
+         x="611.20306"
+         y="207.32623"
+         transform="matrix(1,0,-0.4999983,0.8660264,0,0)" />
+      <rect
+         style="fill:#e8e8e8;fill-opacity:1;stroke:#747474;stroke-width:0.36000001;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+         id="rect3885"
+         width="135"
+         height="67.5"
+         x="472.04999"
+         y="202.05"
+         rx="10"
+         ry="10" />
+      <text
+         xml:space="preserve"
+         style="font-size:32px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+         x="481.96405"
+         y="246.4836"
+         id="text3889"
+         sodipodi:linespacing="125%"><tspan
+           sodipodi:role="line"
+           id="tspan3891"
+           x="481.96405"
+           y="246.4836">Printer</tspan></text>
+    </g>
+    <g
+       id="g3853"
+       transform="matrix(0.5,0,0,0.5,191.7,-1.5199184e-6)">
+      <g
+         id="g4104">
+        <rect
+           y="157.5"
+           x="44.099995"
+           height="90"
+           width="135"
+           id="rect3855"
+           style="fill:#e8e8e8;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:0.9, 0.9;stroke-dashoffset:0;stroke-opacity:1" />
+        <flowRoot
+           transform="translate(111.78164,191.19532)"
+           id="flowRoot3857"
+           style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:100%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+           xml:space="preserve"><flowRegion
+             id="flowRegion3859" /><flowPara
+             id="flowPara3863">Optional</flowPara><flowPara
+             id="flowPara3865">Port</flowPara><flowPara
+             id="flowPara3867">Monitor</flowPara></flowRoot>      </g>
+    </g>
+    <g
+       id="g4083"
+       transform="translate(22.725,-0.225)">
+      <g
+         id="g4112"
+         transform="translate(-0.45,-10.8)">
+        <rect
+           y="90"
+           x="303.75"
+           height="45"
+           width="67.5"
+           id="rect3814"
+           style="fill:#7fff00;fill-opacity:1;stroke:#000000;stroke-width:0.44999999;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+        <flowRoot
+           transform="matrix(0.5,0,0,0.5,338.14944,116.67659)"
+           id="flowRoot3816"
+           style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:100%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+           xml:space="preserve"><flowRegion
+             id="flowRegion3818" /><flowPara
+             id="flowPara3822">Backend</flowPara></flowRoot>      </g>
+    </g>
+  </g>
+</svg>
diff --git a/doc/images/cups-postscript-chain.png b/doc/images/cups-postscript-chain.png
new file mode 100644 (file)
index 0000000..41f8bce
Binary files /dev/null and b/doc/images/cups-postscript-chain.png differ
diff --git a/doc/images/cups-postscript-chain.svg b/doc/images/cups-postscript-chain.svg
new file mode 100644 (file)
index 0000000..d1e2d3e
--- /dev/null
@@ -0,0 +1,531 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="630"
+   height="135"
+   id="svg2"
+   sodipodi:version="0.32"
+   inkscape:version="0.46"
+   version="1.0"
+   sodipodi:docname="cups-postscript-chain.svg"
+   inkscape:output_extension="org.inkscape.output.svg.inkscape"
+   inkscape:export-filename="/Users/msweet/c/cups-trunk/doc/images/cups-postscript-chain.png"
+   inkscape:export-xdpi="100"
+   inkscape:export-ydpi="100">
+  <defs
+     id="defs4">
+    <marker
+       inkscape:stockid="TriangleInS"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="TriangleInS"
+       style="overflow:visible">
+      <path
+         id="path4263"
+         d="M 5.77,0 L -2.88,5 L -2.88,-5 L 5.77,0 z"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
+         transform="scale(-0.2,-0.2)" />
+    </marker>
+    <marker
+       inkscape:stockid="TriangleOutS"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="TriangleOutS"
+       style="overflow:visible">
+      <path
+         id="path4272"
+         d="M 5.77,0 L -2.88,5 L -2.88,-5 L 5.77,0 z"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
+         transform="scale(0.2,0.2)" />
+    </marker>
+    <marker
+       inkscape:stockid="TriangleOutM"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="TriangleOutM"
+       style="overflow:visible">
+      <path
+         id="path4269"
+         d="M 5.77,0 L -2.88,5 L -2.88,-5 L 5.77,0 z"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
+         transform="scale(0.4,0.4)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Mend"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="Arrow1Mend"
+       style="overflow:visible">
+      <path
+         id="path4132"
+         d="M 0,0 L 5,-5 L -12.5,0 L 5,5 L 0,0 z"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
+         transform="matrix(-0.4,0,0,-0.4,-4,0)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Sstart"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="Arrow1Sstart"
+       style="overflow:visible">
+      <path
+         id="path4135"
+         d="M 0,0 L 5,-5 L -12.5,0 L 5,5 L 0,0 z"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
+         transform="matrix(0.2,0,0,0.2,1.2,0)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow2Lstart"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="Arrow2Lstart"
+       style="overflow:visible">
+      <path
+         id="path4141"
+         style="font-size:12px;fill-rule:evenodd;stroke-width:0.625;stroke-linejoin:round"
+         d="M 8.7185878,4.0337352 L -2.2072895,0.016013256 L 8.7185884,-4.0017078 C 6.97309,-1.6296469 6.9831476,1.6157441 8.7185878,4.0337352 z"
+         transform="matrix(1.1,0,0,1.1,1.1,0)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Lstart"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="Arrow1Lstart"
+       style="overflow:visible">
+      <path
+         id="path4123"
+         d="M 0,0 L 5,-5 L -12.5,0 L 5,5 L 0,0 z"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
+         transform="matrix(0.8,0,0,0.8,10,0)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow2Mstart"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="Arrow2Mstart"
+       style="overflow:visible">
+      <path
+         id="path4147"
+         style="font-size:12px;fill-rule:evenodd;stroke-width:0.625;stroke-linejoin:round"
+         d="M 8.7185878,4.0337352 L -2.2072895,0.016013256 L 8.7185884,-4.0017078 C 6.97309,-1.6296469 6.9831476,1.6157441 8.7185878,4.0337352 z"
+         transform="scale(0.6,0.6)" />
+    </marker>
+    <inkscape:perspective
+       sodipodi:type="inkscape:persp3d"
+       inkscape:vp_x="-490.8657 : 919.3427 : 1"
+       inkscape:vp_y="9.6977444e-14 : 1482.3941 : 0"
+       inkscape:vp_z="687.60276 : 919.3427 : 1"
+       inkscape:persp3d-origin="98.368532 : 659.34009 : 1"
+       id="perspective10" />
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     gridtolerance="10"
+     guidetolerance="10"
+     objecttolerance="10"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="1.5492063"
+     inkscape:cx="315"
+     inkscape:cy="8.9209734"
+     inkscape:document-units="in"
+     inkscape:current-layer="layer1"
+     showgrid="true"
+     units="in"
+     inkscape:snap-bbox="true"
+     inkscape:object-paths="true"
+     inkscape:object-nodes="true"
+     inkscape:bbox-paths="true"
+     inkscape:bbox-nodes="true"
+     inkscape:snap-intersection-line-segments="true"
+     inkscape:window-width="1073"
+     inkscape:window-height="701"
+     inkscape:window-x="747"
+     inkscape:window-y="9">
+    <inkscape:grid
+       type="xygrid"
+       id="grid2383"
+       visible="true"
+       enabled="true"
+       units="in"
+       spacingx="0.125in"
+       spacingy="0.125in"
+       dotted="false"
+       empspacing="8" />
+  </sodipodi:namedview>
+  <metadata
+     id="metadata7">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1">
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:2.25;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;stroke-miterlimit:4;stroke-dasharray:none"
+       d="M 230.6911,54.143596 L 135,78.75"
+       id="path11557" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:2.25;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="M 247.95,56.25 L 247.95,78.75"
+       id="path10785" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:8.12441158;stroke-linecap:butt;stroke-linejoin:miter;marker-start:none;marker-mid:none;marker-end:url(#TriangleOutS);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="M 55.812205,101.25 L 89.77536,101.25"
+       id="path4118" />
+    <path
+       id="path10220"
+       d="M 516.10192,101.25 L 542.45524,101.25"
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:7.40767479;stroke-linecap:butt;stroke-linejoin:miter;marker-start:url(#TriangleInS);marker-mid:none;marker-end:url(#TriangleOutS);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:7.32613468;stroke-linecap:butt;stroke-linejoin:miter;marker-start:url(#TriangleInS);marker-mid:none;marker-end:url(#TriangleOutS);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="M 403.92054,101.25 L 429.48195,101.25"
+       id="path10781" />
+    <path
+       id="path10783"
+       d="M 291.29513,101.80229 L 316.85654,101.80229"
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:7.32613468;stroke-linecap:butt;stroke-linejoin:miter;marker-start:url(#TriangleInS);marker-mid:none;marker-end:url(#TriangleOutS);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+    <g
+       id="g3596"
+       transform="matrix(0.5,0,0,0.5,180.90849,-33.525)">
+      <rect
+         y="100.83127"
+         x="90"
+         height="67.22084"
+         width="90"
+         id="rect3582"
+         style="fill:#e8e8e8;fill-opacity:1;stroke:none;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1" />
+      <path
+         d="M 180,101.25 A 45,11.25 0 1 1 90,101.25 A 45,11.25 0 1 1 180,101.25 z"
+         sodipodi:ry="11.25"
+         sodipodi:rx="45"
+         sodipodi:cy="101.25"
+         sodipodi:cx="135"
+         id="path3580"
+         style="fill:#e8e8e8;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+         sodipodi:type="arc" />
+      <path
+         sodipodi:end="3.1415927"
+         sodipodi:start="0"
+         transform="matrix(1,0,0,1.0799999,0,58.500006)"
+         sodipodi:type="arc"
+         style="fill:#e8e8e8;fill-opacity:1;stroke:none;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+         id="path3584"
+         sodipodi:cx="135"
+         sodipodi:cy="101.25"
+         sodipodi:rx="45"
+         sodipodi:ry="11.25"
+         d="M 180,101.25 A 45,11.25 0 1 1 90,101.25 L 135,101.25 z" />
+      <path
+         sodipodi:open="true"
+         d="M 180,101.25 A 45,11.25 0 1 1 90,101.25"
+         sodipodi:ry="11.25"
+         sodipodi:rx="45"
+         sodipodi:cy="101.25"
+         sodipodi:cx="135"
+         id="path3586"
+         style="fill:none;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+         sodipodi:type="arc"
+         transform="translate(-0.45,67.05)"
+         sodipodi:start="0"
+         sodipodi:end="3.1415927" />
+      <path
+         id="path3588"
+         d="M 90,99.9365 L 89.583023,168.73466"
+         style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" />
+      <path
+         style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+         d="M 180,100.94936 L 179.58302,169.74752"
+         id="path3590" />
+      <text
+         sodipodi:linespacing="125%"
+         id="text3592"
+         y="149.58008"
+         x="134.30273"
+         style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:125%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+         xml:space="preserve"><tspan
+           y="149.58008"
+           x="134.30273"
+           id="tspan3594"
+           sodipodi:role="line">PPD</tspan></text>
+    </g>
+    <g
+       transform="matrix(0.5,0,0,0.5,315.58501,-10.934996)"
+       id="g3893">
+      <rect
+         style="fill:#e8e8e8;fill-opacity:1;stroke:#747474;stroke-width:0.38684496;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+         id="rect3887"
+         width="90"
+         height="51.961464"
+         x="611.20306"
+         y="207.32623"
+         transform="matrix(1,0,-0.4999983,0.8660264,0,0)" />
+      <rect
+         style="fill:#e8e8e8;fill-opacity:1;stroke:#747474;stroke-width:0.36000001;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+         id="rect3885"
+         width="135"
+         height="67.5"
+         x="472.04999"
+         y="202.05"
+         rx="10"
+         ry="10" />
+      <text
+         xml:space="preserve"
+         style="font-size:32px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+         x="481.96405"
+         y="246.4836"
+         id="text3889"
+         sodipodi:linespacing="125%"><tspan
+           sodipodi:role="line"
+           id="tspan3891"
+           x="481.96405"
+           y="246.4836">Printer</tspan></text>
+    </g>
+    <g
+       id="g3853"
+       transform="matrix(0.5,0,0,0.5,304.65,-1.5258789e-6)">
+      <g
+         id="g4104">
+        <rect
+           y="157.5"
+           x="44.099995"
+           height="90"
+           width="135"
+           id="rect3855"
+           style="fill:#e8e8e8;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:0.9, 0.9;stroke-dashoffset:0;stroke-opacity:1" />
+        <flowRoot
+           transform="translate(111.78164,191.19532)"
+           id="flowRoot3857"
+           style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:100%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+           xml:space="preserve"><flowRegion
+             id="flowRegion3859" /><flowPara
+             id="flowPara3863">Optional</flowPara><flowPara
+             id="flowPara3865">Port</flowPara><flowPara
+             id="flowPara3867">Monitor</flowPara></flowRoot>      </g>
+    </g>
+    <g
+       id="g4083"
+       transform="translate(135.675,-0.225)">
+      <g
+         id="g4112"
+         transform="translate(-0.45,-10.8)">
+        <rect
+           y="90"
+           x="303.75"
+           height="45"
+           width="67.5"
+           id="rect3814"
+           style="fill:#7fff00;fill-opacity:1;stroke:#000000;stroke-width:0.44999999;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+        <flowRoot
+           transform="matrix(0.5,0,0,0.5,338.14944,116.67659)"
+           id="flowRoot3816"
+           style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:100%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+           xml:space="preserve"><flowRegion
+             id="flowRegion3818" /><flowPara
+             id="flowPara3822">Backend</flowPara></flowRoot>      </g>
+    </g>
+    <g
+       id="g11327"
+       transform="translate(0,-10.8)">
+      <g
+         id="g3564"
+         transform="matrix(0.5,0,0,0.5,191.475,-0.225)">
+        <flowRoot
+           transform="translate(-0.7816377,17.247326)"
+           id="flowRoot3568"
+           style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:100%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+           xml:space="preserve"><flowRegion
+             id="flowRegion3570"><use
+               height="630"
+               width="630"
+               id="use3572"
+               xlink:href="#rect2768"
+               y="0"
+               x="0" /></flowRegion><flowPara
+             id="flowPara3574">Optional</flowPara><flowPara
+             id="flowPara3578">PostScript</flowPara><flowPara
+             id="flowPara3576">Filter</flowPara></flowRoot>        <g
+           id="g11354">
+          <rect
+             style="fill:#e8e8e8;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:0.89999998, 1.79999995;stroke-dashoffset:0;stroke-opacity:1"
+             id="rect3566"
+             width="135"
+             height="90"
+             x="45"
+             y="180" />
+          <text
+             sodipodi:linespacing="100%"
+             id="text11346"
+             y="213.24532"
+             x="112.47734"
+             style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:100%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+             xml:space="preserve"><tspan
+               y="213.24532"
+               x="112.47734"
+               id="tspan11348"
+               sodipodi:role="line">Optional</tspan><tspan
+               id="tspan11350"
+               y="233.24532"
+               x="112.47734"
+               sodipodi:role="line">PostScript</tspan><tspan
+               id="tspan11352"
+               y="253.24532"
+               x="112.47734"
+               sodipodi:role="line">Filter</tspan></text>
+        </g>
+      </g>
+    </g>
+    <g
+       id="g3693"
+       transform="matrix(0.5,0,0,0.5,191.84368,-23.741102)">
+      <g
+         id="g11542"
+         transform="translate(-450.27038,115.4322)">
+        <rect
+           y="100.83127"
+           x="90"
+           height="67.22084"
+           width="90"
+           id="rect3646"
+           style="fill:#e8e8e8;fill-opacity:1;stroke:none;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1" />
+        <path
+           d="M 180,101.25 A 45,11.25 0 1 1 90,101.25 A 45,11.25 0 1 1 180,101.25 z"
+           sodipodi:ry="11.25"
+           sodipodi:rx="45"
+           sodipodi:cy="101.25"
+           sodipodi:cx="135"
+           id="path3648"
+           style="fill:#e8e8e8;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+           sodipodi:type="arc" />
+        <path
+           sodipodi:end="3.1415927"
+           sodipodi:start="0"
+           transform="matrix(1,0,0,1.0799999,0,58.500006)"
+           sodipodi:type="arc"
+           style="fill:#e8e8e8;fill-opacity:1;stroke:none;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+           id="path3650"
+           sodipodi:cx="135"
+           sodipodi:cy="101.25"
+           sodipodi:rx="45"
+           sodipodi:ry="11.25"
+           d="M 180,101.25 A 45,11.25 0 1 1 90,101.25 L 135,101.25 z" />
+        <path
+           sodipodi:open="true"
+           d="M 180,101.25 A 45,11.25 0 1 1 90,101.25"
+           sodipodi:ry="11.25"
+           sodipodi:rx="45"
+           sodipodi:cy="101.25"
+           sodipodi:cx="135"
+           id="path3652"
+           style="fill:none;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+           sodipodi:type="arc"
+           transform="translate(-0.45,67.05)"
+           sodipodi:start="0"
+           sodipodi:end="3.1415927" />
+        <path
+           id="path3654"
+           d="M 90,99.9365 L 89.583023,168.73466"
+           style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" />
+        <path
+           style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+           d="M 180,100.94936 L 179.58302,169.74752"
+           id="path3656" />
+        <text
+           sodipodi:linespacing="125%"
+           id="text3658"
+           y="139.58008"
+           x="134.30273"
+           style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:125%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+           xml:space="preserve"><tspan
+             y="139.58008"
+             x="134.30273"
+             id="tspan3660"
+             sodipodi:role="line">Print</tspan><tspan
+             id="tspan3662"
+             y="164.58008"
+             x="134.30273"
+             sodipodi:role="line">File</tspan></text>
+      </g>
+      <g
+         id="g11399"
+         transform="translate(-450.27038,114.0822)">
+        <g
+           id="g3622"
+           transform="translate(392.34954,180.45)">
+          <g
+             id="g3636">
+            <g
+               transform="translate(-167.81652,-270)"
+               id="g3786">
+              <rect
+                 y="180"
+                 x="45"
+                 height="90"
+                 width="135"
+                 id="rect3624"
+                 style="fill:#7fff00;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+              <flowRoot
+                 transform="translate(-2.7816377,25.247326)"
+                 id="flowRoot3626"
+                 style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:100%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+                 xml:space="preserve"><flowRegion
+                   id="flowRegion3628"><use
+                     height="630"
+                     width="630"
+                     id="use3630"
+                     xlink:href="#rect2768"
+                     y="0"
+                     x="0" /></flowRegion><flowPara
+                   id="flowPara3632">CUPS</flowPara><flowPara
+                   id="flowPara3634">Filters</flowPara></flowRoot>            </g>
+          </g>
+        </g>
+        <text
+           xml:space="preserve"
+           style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:125%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+           x="336.27359"
+           y="130.69901"
+           id="text11380"
+           sodipodi:linespacing="125%"><tspan
+             sodipodi:role="line"
+             id="tspan11382"
+             x="336.27359"
+             y="130.69901">CUPS</tspan><tspan
+             sodipodi:role="line"
+             x="336.27359"
+             y="155.69901"
+             id="tspan11384">Filters</tspan></text>
+      </g>
+    </g>
+    <path
+       id="path11553"
+       d="M 168.75,101.25 L 202.71316,101.25"
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:8.12441158;stroke-linecap:butt;stroke-linejoin:miter;marker-start:none;marker-mid:none;marker-end:url(#TriangleOutS);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+  </g>
+</svg>
diff --git a/doc/images/cups-raster-chain.png b/doc/images/cups-raster-chain.png
new file mode 100644 (file)
index 0000000..5349bd9
Binary files /dev/null and b/doc/images/cups-raster-chain.png differ
diff --git a/doc/images/cups-raster-chain.svg b/doc/images/cups-raster-chain.svg
new file mode 100644 (file)
index 0000000..5130c81
--- /dev/null
@@ -0,0 +1,534 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="630"
+   height="135"
+   id="svg2"
+   sodipodi:version="0.32"
+   inkscape:version="0.46"
+   version="1.0"
+   sodipodi:docname="cups-raster-chain.svg"
+   inkscape:output_extension="org.inkscape.output.svg.inkscape"
+   inkscape:export-filename="/Users/msweet/c/cups-trunk/doc/images/cups-raster-chain.png"
+   inkscape:export-xdpi="100"
+   inkscape:export-ydpi="100">
+  <defs
+     id="defs4">
+    <marker
+       inkscape:stockid="TriangleInS"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="TriangleInS"
+       style="overflow:visible">
+      <path
+         id="path4263"
+         d="M 5.77,0 L -2.88,5 L -2.88,-5 L 5.77,0 z"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
+         transform="scale(-0.2,-0.2)" />
+    </marker>
+    <marker
+       inkscape:stockid="TriangleOutS"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="TriangleOutS"
+       style="overflow:visible">
+      <path
+         id="path4272"
+         d="M 5.77,0 L -2.88,5 L -2.88,-5 L 5.77,0 z"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
+         transform="scale(0.2,0.2)" />
+    </marker>
+    <marker
+       inkscape:stockid="TriangleOutM"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="TriangleOutM"
+       style="overflow:visible">
+      <path
+         id="path4269"
+         d="M 5.77,0 L -2.88,5 L -2.88,-5 L 5.77,0 z"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
+         transform="scale(0.4,0.4)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Mend"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="Arrow1Mend"
+       style="overflow:visible">
+      <path
+         id="path4132"
+         d="M 0,0 L 5,-5 L -12.5,0 L 5,5 L 0,0 z"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
+         transform="matrix(-0.4,0,0,-0.4,-4,0)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Sstart"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="Arrow1Sstart"
+       style="overflow:visible">
+      <path
+         id="path4135"
+         d="M 0,0 L 5,-5 L -12.5,0 L 5,5 L 0,0 z"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
+         transform="matrix(0.2,0,0,0.2,1.2,0)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow2Lstart"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="Arrow2Lstart"
+       style="overflow:visible">
+      <path
+         id="path4141"
+         style="font-size:12px;fill-rule:evenodd;stroke-width:0.625;stroke-linejoin:round"
+         d="M 8.7185878,4.0337352 L -2.2072895,0.016013256 L 8.7185884,-4.0017078 C 6.97309,-1.6296469 6.9831476,1.6157441 8.7185878,4.0337352 z"
+         transform="matrix(1.1,0,0,1.1,1.1,0)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow1Lstart"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="Arrow1Lstart"
+       style="overflow:visible">
+      <path
+         id="path4123"
+         d="M 0,0 L 5,-5 L -12.5,0 L 5,5 L 0,0 z"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
+         transform="matrix(0.8,0,0,0.8,10,0)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow2Mstart"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="Arrow2Mstart"
+       style="overflow:visible">
+      <path
+         id="path4147"
+         style="font-size:12px;fill-rule:evenodd;stroke-width:0.625;stroke-linejoin:round"
+         d="M 8.7185878,4.0337352 L -2.2072895,0.016013256 L 8.7185884,-4.0017078 C 6.97309,-1.6296469 6.9831476,1.6157441 8.7185878,4.0337352 z"
+         transform="scale(0.6,0.6)" />
+    </marker>
+    <inkscape:perspective
+       sodipodi:type="inkscape:persp3d"
+       inkscape:vp_x="-490.8657 : 919.3427 : 1"
+       inkscape:vp_y="9.6977444e-14 : 1482.3941 : 0"
+       inkscape:vp_z="687.60276 : 919.3427 : 1"
+       inkscape:persp3d-origin="98.368532 : 659.34009 : 1"
+       id="perspective10" />
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     gridtolerance="10"
+     guidetolerance="10"
+     objecttolerance="10"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="1.5492063"
+     inkscape:cx="315"
+     inkscape:cy="8.9209734"
+     inkscape:document-units="in"
+     inkscape:current-layer="layer1"
+     showgrid="true"
+     units="in"
+     inkscape:snap-bbox="true"
+     inkscape:object-paths="true"
+     inkscape:object-nodes="true"
+     inkscape:bbox-paths="true"
+     inkscape:bbox-nodes="true"
+     inkscape:snap-intersection-line-segments="true"
+     inkscape:window-width="1073"
+     inkscape:window-height="701"
+     inkscape:window-x="747"
+     inkscape:window-y="9">
+    <inkscape:grid
+       type="xygrid"
+       id="grid2383"
+       visible="true"
+       enabled="true"
+       units="in"
+       spacingx="0.125in"
+       spacingy="0.125in"
+       dotted="false"
+       empspacing="8" />
+  </sodipodi:namedview>
+  <metadata
+     id="metadata7">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1">
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:2.25;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;stroke-miterlimit:4;stroke-dasharray:none"
+       d="M 230.6911,54.143596 L 135,78.75"
+       id="path11557" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:2.25;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="M 247.95,56.25 L 247.95,78.75"
+       id="path10785" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:8.12441158;stroke-linecap:butt;stroke-linejoin:miter;marker-start:none;marker-mid:none;marker-end:url(#TriangleOutS);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="M 55.812205,101.25 L 89.77536,101.25"
+       id="path4118" />
+    <path
+       id="path10220"
+       d="M 516.10192,101.25 L 542.45524,101.25"
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:7.40767479;stroke-linecap:butt;stroke-linejoin:miter;marker-start:url(#TriangleInS);marker-mid:none;marker-end:url(#TriangleOutS);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:7.32613468;stroke-linecap:butt;stroke-linejoin:miter;marker-start:url(#TriangleInS);marker-mid:none;marker-end:url(#TriangleOutS);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="M 403.92054,101.25 L 429.48195,101.25"
+       id="path10781" />
+    <path
+       id="path10783"
+       d="M 291.29513,101.80229 L 316.85654,101.80229"
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:7.32613468;stroke-linecap:butt;stroke-linejoin:miter;marker-start:url(#TriangleInS);marker-mid:none;marker-end:url(#TriangleOutS);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+    <g
+       id="g3596"
+       transform="matrix(0.5,0,0,0.5,180.90849,-33.525)">
+      <rect
+         y="100.83127"
+         x="90"
+         height="67.22084"
+         width="90"
+         id="rect3582"
+         style="fill:#e8e8e8;fill-opacity:1;stroke:none;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1" />
+      <path
+         d="M 180,101.25 A 45,11.25 0 1 1 90,101.25 A 45,11.25 0 1 1 180,101.25 z"
+         sodipodi:ry="11.25"
+         sodipodi:rx="45"
+         sodipodi:cy="101.25"
+         sodipodi:cx="135"
+         id="path3580"
+         style="fill:#e8e8e8;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+         sodipodi:type="arc" />
+      <path
+         sodipodi:end="3.1415927"
+         sodipodi:start="0"
+         transform="matrix(1,0,0,1.0799999,0,58.500006)"
+         sodipodi:type="arc"
+         style="fill:#e8e8e8;fill-opacity:1;stroke:none;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+         id="path3584"
+         sodipodi:cx="135"
+         sodipodi:cy="101.25"
+         sodipodi:rx="45"
+         sodipodi:ry="11.25"
+         d="M 180,101.25 A 45,11.25 0 1 1 90,101.25 L 135,101.25 z" />
+      <path
+         sodipodi:open="true"
+         d="M 180,101.25 A 45,11.25 0 1 1 90,101.25"
+         sodipodi:ry="11.25"
+         sodipodi:rx="45"
+         sodipodi:cy="101.25"
+         sodipodi:cx="135"
+         id="path3586"
+         style="fill:none;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+         sodipodi:type="arc"
+         transform="translate(-0.45,67.05)"
+         sodipodi:start="0"
+         sodipodi:end="3.1415927" />
+      <path
+         id="path3588"
+         d="M 90,99.9365 L 89.583023,168.73466"
+         style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" />
+      <path
+         style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+         d="M 180,100.94936 L 179.58302,169.74752"
+         id="path3590" />
+      <text
+         sodipodi:linespacing="125%"
+         id="text3592"
+         y="149.58008"
+         x="134.30273"
+         style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:125%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+         xml:space="preserve"><tspan
+           y="149.58008"
+           x="134.30273"
+           id="tspan3594"
+           sodipodi:role="line">PPD</tspan></text>
+    </g>
+    <g
+       transform="matrix(0.5,0,0,0.5,315.58501,-10.934996)"
+       id="g3893">
+      <rect
+         style="fill:#e8e8e8;fill-opacity:1;stroke:#747474;stroke-width:0.38684496;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+         id="rect3887"
+         width="90"
+         height="51.961464"
+         x="611.20306"
+         y="207.32623"
+         transform="matrix(1,0,-0.4999983,0.8660264,0,0)" />
+      <rect
+         style="fill:#e8e8e8;fill-opacity:1;stroke:#747474;stroke-width:0.36000001;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+         id="rect3885"
+         width="135"
+         height="67.5"
+         x="472.04999"
+         y="202.05"
+         rx="10"
+         ry="10" />
+      <text
+         xml:space="preserve"
+         style="font-size:32px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+         x="481.96405"
+         y="246.4836"
+         id="text3889"
+         sodipodi:linespacing="125%"><tspan
+           sodipodi:role="line"
+           id="tspan3891"
+           x="481.96405"
+           y="246.4836">Printer</tspan></text>
+    </g>
+    <g
+       id="g3853"
+       transform="matrix(0.5,0,0,0.5,304.65,-1.5258789e-6)">
+      <g
+         id="g4104">
+        <rect
+           y="157.5"
+           x="44.099995"
+           height="90"
+           width="135"
+           id="rect3855"
+           style="fill:#e8e8e8;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:0.9, 0.9;stroke-dashoffset:0;stroke-opacity:1" />
+        <flowRoot
+           transform="translate(111.78164,191.19532)"
+           id="flowRoot3857"
+           style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:100%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+           xml:space="preserve"><flowRegion
+             id="flowRegion3859" /><flowPara
+             id="flowPara3863">Optional</flowPara><flowPara
+             id="flowPara3865">Port</flowPara><flowPara
+             id="flowPara3867">Monitor</flowPara></flowRoot>      </g>
+    </g>
+    <g
+       id="g4083"
+       transform="translate(135.675,-0.225)">
+      <g
+         id="g4112"
+         transform="translate(-0.45,-10.8)">
+        <rect
+           y="90"
+           x="303.75"
+           height="45"
+           width="67.5"
+           id="rect3814"
+           style="fill:#7fff00;fill-opacity:1;stroke:#000000;stroke-width:0.44999999;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+        <flowRoot
+           transform="matrix(0.5,0,0,0.5,338.14944,116.67659)"
+           id="flowRoot3816"
+           style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:100%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+           xml:space="preserve"><flowRegion
+             id="flowRegion3818" /><flowPara
+             id="flowPara3822">Backend</flowPara></flowRoot>      </g>
+    </g>
+    <g
+       id="g11327"
+       transform="translate(0,-10.8)">
+      <g
+         id="g3564"
+         transform="matrix(0.5,0,0,0.5,191.475,-0.225)">
+        <flowRoot
+           transform="translate(-0.7816377,17.247326)"
+           id="flowRoot3568"
+           style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:100%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+           xml:space="preserve"><flowRegion
+             id="flowRegion3570"><use
+               height="630"
+               width="630"
+               id="use3572"
+               xlink:href="#rect2768"
+               y="0"
+               x="0" /></flowRegion><flowPara
+             id="flowPara3574">Optional</flowPara><flowPara
+             id="flowPara3578">PostScript</flowPara><flowPara
+             id="flowPara3576">Filter</flowPara></flowRoot>        <g
+           id="g11354">
+          <g
+             id="g11692">
+            <rect
+               y="180"
+               x="45"
+               height="90"
+               width="135"
+               id="rect3566"
+               style="fill:#e8e8e8;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1" />
+            <text
+               xml:space="preserve"
+               style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:100%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+               x="112.47734"
+               y="213.24532"
+               id="text11346"
+               sodipodi:linespacing="100%"><tspan
+                 sodipodi:role="line"
+                 x="112.47734"
+                 y="213.24532"
+                 id="tspan11350">Required</tspan><tspan
+                 id="tspan11690"
+                 sodipodi:role="line"
+                 x="112.47734"
+                 y="233.24532">Raster</tspan><tspan
+                 sodipodi:role="line"
+                 x="112.47734"
+                 y="253.24532"
+                 id="tspan11352">Filter</tspan></text>
+          </g>
+        </g>
+      </g>
+    </g>
+    <g
+       id="g3693"
+       transform="matrix(0.5,0,0,0.5,191.84368,-23.741102)">
+      <g
+         id="g11542"
+         transform="translate(-450.27038,115.4322)">
+        <rect
+           y="100.83127"
+           x="90"
+           height="67.22084"
+           width="90"
+           id="rect3646"
+           style="fill:#e8e8e8;fill-opacity:1;stroke:none;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1" />
+        <path
+           d="M 180,101.25 A 45,11.25 0 1 1 90,101.25 A 45,11.25 0 1 1 180,101.25 z"
+           sodipodi:ry="11.25"
+           sodipodi:rx="45"
+           sodipodi:cy="101.25"
+           sodipodi:cx="135"
+           id="path3648"
+           style="fill:#e8e8e8;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+           sodipodi:type="arc" />
+        <path
+           sodipodi:end="3.1415927"
+           sodipodi:start="0"
+           transform="matrix(1,0,0,1.0799999,0,58.500006)"
+           sodipodi:type="arc"
+           style="fill:#e8e8e8;fill-opacity:1;stroke:none;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+           id="path3650"
+           sodipodi:cx="135"
+           sodipodi:cy="101.25"
+           sodipodi:rx="45"
+           sodipodi:ry="11.25"
+           d="M 180,101.25 A 45,11.25 0 1 1 90,101.25 L 135,101.25 z" />
+        <path
+           sodipodi:open="true"
+           d="M 180,101.25 A 45,11.25 0 1 1 90,101.25"
+           sodipodi:ry="11.25"
+           sodipodi:rx="45"
+           sodipodi:cy="101.25"
+           sodipodi:cx="135"
+           id="path3652"
+           style="fill:none;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
+           sodipodi:type="arc"
+           transform="translate(-0.45,67.05)"
+           sodipodi:start="0"
+           sodipodi:end="3.1415927" />
+        <path
+           id="path3654"
+           d="M 90,99.9365 L 89.583023,168.73466"
+           style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" />
+        <path
+           style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+           d="M 180,100.94936 L 179.58302,169.74752"
+           id="path3656" />
+        <text
+           sodipodi:linespacing="125%"
+           id="text3658"
+           y="139.58008"
+           x="134.30273"
+           style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:125%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+           xml:space="preserve"><tspan
+             y="139.58008"
+             x="134.30273"
+             id="tspan3660"
+             sodipodi:role="line">Print</tspan><tspan
+             id="tspan3662"
+             y="164.58008"
+             x="134.30273"
+             sodipodi:role="line">File</tspan></text>
+      </g>
+      <g
+         id="g11399"
+         transform="translate(-450.27038,114.0822)">
+        <g
+           id="g3622"
+           transform="translate(392.34954,180.45)">
+          <g
+             id="g3636">
+            <g
+               transform="translate(-167.81652,-270)"
+               id="g3786">
+              <rect
+                 y="180"
+                 x="45"
+                 height="90"
+                 width="135"
+                 id="rect3624"
+                 style="fill:#7fff00;fill-opacity:1;stroke:#000000;stroke-width:0.89999998;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+              <flowRoot
+                 transform="translate(-2.7816377,25.247326)"
+                 id="flowRoot3626"
+                 style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:100%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+                 xml:space="preserve"><flowRegion
+                   id="flowRegion3628"><use
+                     height="630"
+                     width="630"
+                     id="use3630"
+                     xlink:href="#rect2768"
+                     y="0"
+                     x="0" /></flowRegion><flowPara
+                   id="flowPara3632">CUPS</flowPara><flowPara
+                   id="flowPara3634">Filters</flowPara></flowRoot>            </g>
+          </g>
+        </g>
+        <text
+           xml:space="preserve"
+           style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;line-height:125%;writing-mode:lr-tb;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+           x="336.27359"
+           y="130.69901"
+           id="text11380"
+           sodipodi:linespacing="125%"><tspan
+             sodipodi:role="line"
+             id="tspan11382"
+             x="336.27359"
+             y="130.69901">CUPS</tspan><tspan
+             sodipodi:role="line"
+             x="336.27359"
+             y="155.69901"
+             id="tspan11384">Filters</tspan></text>
+      </g>
+    </g>
+    <path
+       id="path11553"
+       d="M 168.75,101.25 L 202.71316,101.25"
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:8.12441158;stroke-linecap:butt;stroke-linejoin:miter;marker-start:none;marker-mid:none;marker-end:url(#TriangleOutS);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+  </g>
+</svg>
diff --git a/examples/Makefile b/examples/Makefile
new file mode 100644 (file)
index 0000000..928d71c
--- /dev/null
@@ -0,0 +1,128 @@
+#
+# "$Id$"
+#
+#   PPD compiler example makefile for the Common UNIX Printing System (CUPS).
+#
+#   Copyright 2007-2008 by Apple Inc.
+#   Copyright 2002-2005 by Easy Software Products.
+#
+#   These coded instructions, statements, and computer programs are the
+#   property of Apple Inc. and are protected by Federal copyright
+#   law.  Distribution and use rights are outlined in the file "LICENSE.txt"
+#   which should have been included with this file.  If this file is
+#   file is missing or damaged, see the license at "http://www.cups.org/".
+#
+
+#
+# Include standard definitions...
+#
+
+include ../Makedefs
+
+
+#
+# Examples...
+#
+
+EXAMPLES =     \
+               color.drv \
+               constraint.drv \
+               custom.drv \
+               grouping.drv \
+               laserjet-basic.drv \
+               laserjet-pjl.drv \
+               minimum.drv \
+               postscript.drv \
+               r300-basic.drv \
+               r300-colorman.drv \
+               r300-remote.drv
+
+
+#
+# Make everything...
+#
+
+all:
+
+
+#
+# Make library targets...
+#
+
+libs:
+
+
+#
+# Make unit tests...
+#
+
+unittests:
+
+
+#
+# Clean everything...
+#
+
+clean:
+
+
+#
+# Dummy depend...
+#
+
+depend:
+
+
+#
+# Install all targets...
+#
+
+install:       all install-data install-headers install-libs install-exec
+
+
+#
+# Install data files...
+#
+
+install-data:
+       $(INSTALL_DIR) $(DATADIR)/examples
+       for file in $(EXAMPLES); do \
+               $(INSTALL_DATA) $$file $(DATADIR)/examples; \
+       done
+
+
+#
+# Install programs...
+#
+
+install-exec:
+
+
+#
+# Install headers...
+#
+
+install-headers:
+
+
+#
+# Install libraries...
+#
+
+install-libs:
+
+
+#
+# Uninstall files...
+#
+
+uninstall:
+       for file in $(EXAMPLES); do \
+               $(RM) $(DATADIR)/examples/$$file; \
+       done
+       -$(RMDIR) $(DATADIR)/examples
+
+
+#
+# End of "$Id$".
+#
diff --git a/examples/color.drv b/examples/color.drv
new file mode 100644 (file)
index 0000000..69984c4
--- /dev/null
@@ -0,0 +1,44 @@
+// Include standard font and media definitions
+#include <font.defs>
+#include <media.defs>
+
+// List the fonts that are supported, in this case all standard
+// fonts...
+Font *
+
+// Manufacturer and version
+Manufacturer "Foo"
+Version 1.0
+
+// Each filter provided by the driver...
+Filter application/vnd.cups-raster 100 rastertofoo
+
+// Supported page sizes
+*MediaSize Letter
+MediaSize A4
+
+{
+  // Supported resolutions
+  *Resolution k 8 0 0 0 "600dpi/600 DPI"
+
+  // Specify the model name and filename...
+  ModelName "FooJet 2000"
+  PCFileName "foojet2k.ppd"
+}
+
+{
+  // Supports color printing
+  ColorDevice true
+
+  // Supported colorspaces
+  ColorModel Gray/Grayscale w chunky 0
+  *ColorModel RGB/Color rgb chunky 0
+
+  // Supported resolutions
+  *Resolution - 8 0 0 0 "300dpi/300 DPI"
+  Resolution - 8 0 0 0 "600dpi/600 DPI"
+
+  // Specify the model name and filename...
+  ModelName "FooJet Color"
+  PCFileName "foojetco.ppd"
+}
diff --git a/examples/constraint.drv b/examples/constraint.drv
new file mode 100644 (file)
index 0000000..6acb7f1
--- /dev/null
@@ -0,0 +1,48 @@
+// Include standard font and media definitions
+#include <font.defs>
+#include <media.defs>
+
+// List the fonts that are supported, in this case all standard
+// fonts...
+Font *
+
+// Manufacturer, model name, and version
+Manufacturer "Foo"
+ModelName "FooJet 2000"
+Version 1.0
+
+// Each filter provided by the driver...
+Filter application/vnd.cups-raster 100 rastertofoo
+
+// Supported page sizes
+*MediaSize Letter
+MediaSize A4
+
+// Supported resolutions
+*Resolution k 8 0 0 0 "600dpi/600 DPI"
+
+// Installable Option Group
+Group "InstallableOptions/Options Installed"
+
+  // Duplexing unit option
+  Option "Option1/Duplexing Unit" Boolean AnySetup 10
+    Choice True/Installed ""
+    *Choice "False/Not Installed" ""
+
+// General Option Group
+Group General
+
+  // Duplexing option
+  Option "Duplex/Two-Sided Printing" PickOne AnySetup 10
+    *Choice "None/No" "<</Duplex false>>setpagedevice"
+    Choice "DuplexNoTumble/Long Edge Binding"
+           "<</Duplex true/Tumble false>>setpagedevice"
+    Choice "DuplexTumble/Short Edge Binding"
+           "<</Duplex true/Tumble true>>setpagedevice"
+
+// Only allow duplexing if the duplexer is installed
+UIConstraints "*Duplex *Option1 False"
+
+// Specify the name of the PPD file we want to generate...
+PCFileName "foojet2k.ppd"
+
diff --git a/examples/custom.drv b/examples/custom.drv
new file mode 100644 (file)
index 0000000..1001c4f
--- /dev/null
@@ -0,0 +1,41 @@
+// Include standard font and media definitions
+#include <font.defs>
+#include <media.defs>
+
+// List the fonts that are supported, in this case all standard
+// fonts...
+Font *
+
+// Manufacturer, model name, and version
+Manufacturer "Foo"
+ModelName "FooJet 2000"
+Version 1.0
+
+// Each filter provided by the driver...
+Filter application/vnd.cups-raster 100 rastertofoo
+
+// Supported page sizes
+*MediaSize Letter
+MediaSize A4
+
+// Supported resolutions
+*Resolution k 8 0 0 0 "600dpi/600 DPI"
+
+// Option Group
+Group "Footasm"
+
+  // Boolean option
+  Option "fooEnhance/Resolution Enhancement" Boolean AnySetup 10
+    *Choice True/Yes "<</cupsCompression 1>>setpagedevice"
+    Choice False/No "<</cupsCompression 0>>setpagedevice"
+
+  // Multiple choice option
+  Option "fooOutputType/Output Quality" PickOne AnySetup 10
+    *Choice "Auto/Automatic Selection" "<</OutputType(Auto)>>setpagedevice"
+    Choice "Text/Optimize for Text" "<</OutputType(Text)>>setpagedevice"
+    Choice "Graph/Optimize for Graphics" "<</OutputType(Graph)>>setpagedevice"
+    Choice "Photo/Optimize for Photos" "<</OutputType(Photo)>>setpagedevice"
+
+// Specify the name of the PPD file we want to generate...
+PCFileName "foojet2k.ppd"
+
diff --git a/examples/grouping.drv b/examples/grouping.drv
new file mode 100644 (file)
index 0000000..da66d74
--- /dev/null
@@ -0,0 +1,36 @@
+// Include standard font and media definitions
+#include <font.defs>
+#include <media.defs>
+
+// List the fonts that are supported, in this case all standard
+// fonts...
+Font *
+
+// Manufacturer and version
+Manufacturer "Foo"
+Version 1.0
+
+// Each filter provided by the driver...
+Filter application/vnd.cups-raster 100 rastertofoo
+
+// Supported page sizes
+*MediaSize Letter
+MediaSize A4
+
+{
+  // Supported resolutions
+  *Resolution k 8 0 0 0 "600dpi/600 DPI"
+
+  // Specify the model name and filename...
+  ModelName "FooJet 2000"
+  PCFileName "foojet2k.ppd"
+}
+
+{
+  // Supported resolutions
+  *Resolution k 8 0 0 0 "1200dpi/1200 DPI"
+
+  // Specify the model name and filename...
+  ModelName "FooJet 2001"
+  PCFileName "foojt2k1.ppd"
+}
diff --git a/examples/laserjet-basic.drv b/examples/laserjet-basic.drv
new file mode 100644 (file)
index 0000000..6924ed7
--- /dev/null
@@ -0,0 +1,88 @@
+// Include standard font and media definitions
+#include <font.defs>
+#include <media.defs>
+
+// Include HP-PCL driver definitions
+#include <pcl.h>
+
+// Specify that this driver uses the HP-PCL driver...
+DriverType pcl
+
+// Specify the driver options via the model number...
+ModelNumber ($PCL_PAPER_SIZE $PCL_PJL $PCL_PJL_RESOLUTION)
+
+// List the fonts that are supported, in this case all standard
+// fonts...
+Font *
+
+// Manufacturer and driver version
+Manufacturer "HP"
+Version 1.0
+
+// Supported page sizes and their margins
+HWMargins 18 12 18 12
+*MediaSize Letter
+MediaSize Legal
+MediaSize Executive
+MediaSize Monarch
+MediaSize Statement
+MediaSize FanFoldGermanLegal
+
+HWMargins 18 12.72 18 12.72
+MediaSize Env10
+
+HWMargins 9.72 12 9.72 12
+MediaSize A4
+MediaSize A5
+MediaSize B5
+MediaSize EnvC5
+MediaSize EnvDL
+MediaSize EnvISOB5
+MediaSize Postcard
+MediaSize DoublePostcard
+
+// Only black-and-white output with mode 3 compression...
+ColorModel Gray k chunky 3
+
+// Supported resolutions
+Resolution - 1 0 0 0 "300dpi/300 DPI"
+*Resolution - 8 0 0 0 "600dpi/600 DPI"
+
+// Supported input slots
+*InputSlot 7 "Auto/Automatic Selection"
+InputSlot 2 "Manual/Tray 1 - Manual Feed"
+InputSlot 4 "Upper/Tray 1"
+InputSlot 1 "Lower/Tray 2"
+InputSlot 5 "LargeCapacity/Tray 3"
+
+// Tray 3 is an option...
+Installable "OptionLargeCapacity/Tray 3 Installed"
+UIConstraints "*OptionLargeCapacity False *InputSlot LargeCapacity"
+
+{
+  // HP LaserJet 2100 Series
+  Throughput 10
+  ModelName "LaserJet 2100 Series"
+  PCFileName "hpljt211.ppd"
+}
+
+{
+  // LaserJet 2200 and 2300 series have duplexer option...
+  Duplex normal
+  Installable "OptionDuplex/Duplexer Installed"
+  UIConstraints "*OptionDuplex False *Duplex"
+
+  {
+    // HP LaserJet 2200 Series
+    Throughput 19
+    ModelName "LaserJet 2200 Series"
+    PCFileName "hpljt221.ppd"
+  }
+
+  {
+    // HP LaserJet 2300 Series
+    Throughput 25
+    ModelName "LaserJet 2300 Series"
+    PCFileName "hpljt231.ppd"
+  }
+}
diff --git a/examples/laserjet-pjl.drv b/examples/laserjet-pjl.drv
new file mode 100644 (file)
index 0000000..32a0bc4
--- /dev/null
@@ -0,0 +1,101 @@
+// Include standard font and media definitions
+#include <font.defs>
+#include <media.defs>
+
+// Include HP-PCL driver definitions
+#include <pcl.h>
+
+// Specify that this driver uses the HP-PCL driver...
+DriverType pcl
+
+// Specify the driver options via the model number...
+ModelNumber ($PCL_PAPER_SIZE $PCL_PJL $PCL_PJL_RESOLUTION)
+
+// List the fonts that are supported, in this case all standard
+// fonts...
+Font *
+
+// Manufacturer and driver version
+Manufacturer "HP"
+Version 2.0
+
+// Supported page sizes and their margins
+HWMargins 18 12 18 12
+*MediaSize Letter
+MediaSize Legal
+MediaSize Executive
+MediaSize Monarch
+MediaSize Statement
+MediaSize FanFoldGermanLegal
+
+HWMargins 18 12.72 18 12.72
+MediaSize Env10
+
+HWMargins 9.72 12 9.72 12
+MediaSize A4
+MediaSize A5
+MediaSize B5
+MediaSize EnvC5
+MediaSize EnvDL
+MediaSize EnvISOB5
+MediaSize Postcard
+MediaSize DoublePostcard
+
+// Only black-and-white output with mode 3 compression...
+ColorModel Gray k chunky 3
+
+// Supported resolutions
+Resolution - 1 0 0 0 "300dpi/300 DPI"
+*Resolution - 8 0 0 0 "600dpi/600 DPI"
+
+// Supported input slots
+*InputSlot 7 "Auto/Automatic Selection"
+InputSlot 2 "Manual/Tray 1 - Manual Feed"
+InputSlot 4 "Upper/Tray 1"
+InputSlot 1 "Lower/Tray 2"
+InputSlot 5 "LargeCapacity/Tray 3"
+
+// Tray 3 is an option...
+Installable "OptionLargeCapacity/Tray 3 Installed"
+UIConstraints "*OptionLargeCapacity False *InputSlot LargeCapacity"
+
+// PJL options
+Attribute cupsPJL cupsRET "@PJL SET SMOOTHING=%?False:OFF;%?True:ON;%n"
+
+Option "cupsRET/Smoothing" Boolean DocumentSetup 10
+  Choice "False/Off" ""
+  *Choice "True/On" ""
+
+Attribute cupsPJL cupsTonerSave "@PJL SET ECONOMODE=%?False:OFF;%?True:ON;%n"
+
+Option "cupsTonerSave/Save Toner" Boolean DocumentSetup 10
+  *Choice "False/No" ""
+  Choice "True/Yes" ""
+
+{
+  // HP LaserJet 2100 Series
+  Throughput 10
+  ModelName "LaserJet 2100 Series PJL"
+  PCFileName "hpljt212.ppd"
+}
+
+{
+  // LaserJet 2200 and 2300 series have duplexer option...
+  Duplex normal
+  Installable "OptionDuplex/Duplexer Installed"
+  UIConstraints "*OptionDuplex False *Duplex"
+
+  {
+    // HP LaserJet 2200 Series
+    Throughput 19
+    ModelName "LaserJet 2200 Series PJL"
+    PCFileName "hpljt222.ppd"
+  }
+
+  {
+    // HP LaserJet 2300 Series
+    Throughput 25
+    ModelName "LaserJet 2300 Series PJL"
+    PCFileName "hpljt232.ppd"
+  }
+}
diff --git a/examples/minimum.drv b/examples/minimum.drv
new file mode 100644 (file)
index 0000000..ac6e38d
--- /dev/null
@@ -0,0 +1,26 @@
+// Include standard font and media definitions
+#include <font.defs>
+#include <media.defs>
+
+// List the fonts that are supported, in this case all standard
+// fonts...
+Font *
+
+// Manufacturer, model name, and version
+Manufacturer "Foo"
+ModelName "FooJet 2000"
+Version 1.0
+
+// Each filter provided by the driver...
+Filter application/vnd.cups-raster 100 rastertofoo
+
+// Supported page sizes
+*MediaSize Letter
+MediaSize A4
+
+// Supported resolutions
+*Resolution k 8 0 0 0 "600dpi/600 DPI"
+
+// Specify the name of the PPD file we want to generate...
+PCFileName "foojet2k.ppd"
+
diff --git a/examples/postscript.drv b/examples/postscript.drv
new file mode 100644 (file)
index 0000000..ebb02f8
--- /dev/null
@@ -0,0 +1,46 @@
+// Include standard font and media definitions
+#include <font.defs>
+#include <media.defs>
+
+// Specify this is a PostScript printer driver
+DriverType ps
+
+// List the fonts that are supported, in this case all standard fonts
+Font *
+
+// Manufacturer, model name, and version
+Manufacturer "Foo"
+ModelName "Foo LaserProofer 2000"
+Version 1.0
+
+// PostScript printer attributes
+Attribute DefaultColorSpace "" Gray
+Attribute LandscapeOrientation "" Minus90
+Attribute LanguageLevel "" "3"
+Attribute Product "" "(Foo LaserProofer 2000)"
+Attribute PSVersion "" "(3010) 0"
+Attribute TTRasterizer "" Type42
+
+// Supported page sizes
+*MediaSize Letter
+MediaSize Legal
+MediaSize A4
+
+// Query command for page size
+Attribute "?PageSize" "" "
+      save
+      currentpagedevice /PageSize get aload pop
+      2 copy gt {exch} if (Unknown)
+      23 dict
+              dup [612 792] (Letter) put
+              dup [612 1008] (Legal) put
+              dup [595 842] (A4) put
+              {exch aload pop 4 index sub abs 5 le exch 
+               5 index sub abs 5 le and
+              {exch pop exit} {pop} ifelse
+      } bind forall = flush pop pop
+      restore"
+
+// Specify the name of the PPD file we want to generate
+PCFileName "fooproof.ppd"
+
diff --git a/examples/r300-basic.drv b/examples/r300-basic.drv
new file mode 100644 (file)
index 0000000..e203d51
--- /dev/null
@@ -0,0 +1,75 @@
+// Include standard font and media definitions
+#include <font.defs>
+#include <media.defs>
+
+// Include ESC/P driver definitions
+#include <escp.h>
+
+// Specify that this driver uses the ESC/P driver...
+DriverType escp
+
+// Specify the driver options via the model number...
+ModelNumber ($ESCP_ESCK $ESCP_EXT_UNITS $ESCP_EXT_MARGINS $ESCP_USB
+             $ESCP_PAGE_SIZE $ESCP_RASTER_ESCI)
+
+// List the fonts that are supported, in this case all standard
+// fonts...
+Font *
+
+// Manufacturer and driver version
+Manufacturer "Epson"
+Version 1.0
+
+// Supported page sizes and their margins
+HWMargins 8.4 0 8.4 0
+*MediaSize Letter
+MediaSize Legal
+MediaSize Executive
+MediaSize Statement
+MediaSize A4
+MediaSize A5
+MediaSize A6
+MediaSize B5
+MediaSize Env10
+MediaSize EnvC5
+MediaSize EnvDL
+MediaSize EnvISOB5
+MediaSize Postcard
+MediaSize DoublePostcard
+
+VariablePaperSize Yes
+MinSize 1in 4in
+MaxSize 8.5in 44in
+
+// Four color modes are supported...
+ColorModel Gray/Grayscale w chunky 1
+ColorModel Black k chunky 1
+*ColorModel RGB/Color rgb chunky 1
+ColorModel CMYK cmyk chunky 1
+
+// Supported resolutions
+Resolution - 8 90 0 103 "360dpi/360 DPI"
+*Resolution - 8 90 0 206 "720dpi/720 DPI"
+Resolution - 8 90 0 412 "1440dpi/1440 DPI"
+
+// Very basic dithering settings
+Attribute cupsInkChannels "" 6
+Attribute cupsInkLimit "" 2.0
+
+Attribute cupsCyanLtDk "" "0.5 1.0"
+Attribute cupsMagentaLtDk "" "0.5 1.0"
+
+Attribute cupsAllDither 360dpi "0.5 0.75 1.0"
+Attribute cupsAllDither 720dpi "0.6 0.9 1.2"
+Attribute cupsAllDither 1440dpi "0.9 1.35"
+
+Attribute cupsESCPDotSize 360dpi 16
+Attribute cupsESCPDotSize 720dpi 17
+Attribute cupsESCPDotSize 1440dpi 18
+
+{
+  // EPSON Stylus Photo R300 Series
+  Throughput 1
+  ModelName "Stylus Photo R300"
+  PCFileName "epspr301.ppd"
+}
diff --git a/examples/r300-colorman.drv b/examples/r300-colorman.drv
new file mode 100644 (file)
index 0000000..ddaf58e
--- /dev/null
@@ -0,0 +1,85 @@
+// Include standard font and media definitions
+#include <font.defs>
+#include <media.defs>
+
+// Include ESC/P driver definitions
+#include <escp.h>
+
+// Specify that this driver uses the ESC/P driver...
+DriverType escp
+
+// Specify the driver options via the model number...
+ModelNumber ($ESCP_ESCK $ESCP_EXT_UNITS $ESCP_EXT_MARGINS $ESCP_USB
+             $ESCP_PAGE_SIZE $ESCP_RASTER_ESCI $ESCP_REMOTE)
+
+// List the fonts that are supported, in this case all standard
+// fonts...
+Font *
+
+// Manufacturer and driver version
+Manufacturer "Epson"
+Version 3.0
+
+// Supported page sizes and their margins
+HWMargins 0 0 0 0
+*MediaSize Letter
+MediaSize Legal
+MediaSize Executive
+MediaSize Statement
+MediaSize A4
+MediaSize A5
+MediaSize A6
+MediaSize B5
+MediaSize Env10
+MediaSize EnvC5
+MediaSize EnvDL
+MediaSize EnvISOB5
+MediaSize Postcard
+MediaSize DoublePostcard
+
+VariablePaperSize Yes
+MinSize 1in 4in
+MaxSize 8.5in 44in
+
+// Borderless printing offset...
+Attribute cupsESCPFP "" 0
+
+// Four color modes are supported...
+ColorModel Gray/Grayscale w chunky 1
+ColorModel Black k chunky 1
+*ColorModel RGB/Color rgb chunky 1
+ColorModel CMYK cmyk chunky 1
+
+// Supported resolutions
+Resolution - 8 90 0 103 "360dpi/360 DPI"
+*Resolution - 8 90 0 206 "720dpi/720 DPI"
+Resolution - 8 90 0 412 "1440dpi/1440 DPI"
+
+// Paper trays...
+*InputSlot 0 "Auto/Auto Select"
+InputSlot 1 "Manual/Manual Feed"
+
+Attribute cupsESCPPP 0 "1 255"
+Attribute cupsESCPPP 1 "2 1"
+
+// Very basic dithering settings
+Attribute cupsInkChannels "" 6
+Attribute cupsInkLimit "" 3.0
+
+Attribute cupsCyanLtDk "" "0.5 1.0"
+Attribute cupsMagentaLtDk "" "0.5 1.0"
+
+Attribute cupsAllDither 360dpi "0.5 0.75 1.0"
+Attribute cupsAllDither 720dpi "0.6 0.9 1.2"
+Attribute cupsAllDither 1440dpi "0.9 1.35"
+
+Attribute cupsESCPDotSize 360dpi 16
+Attribute cupsESCPDotSize 720dpi 17
+Attribute cupsESCPDotSize 1440dpi 18
+
+{
+  // EPSON Stylus Photo R300 Series
+  Throughput 1
+  ModelName "Epson Stylus Photo R300"
+  PCFileName "epspr303.ppd"
+}
diff --git a/examples/r300-remote.drv b/examples/r300-remote.drv
new file mode 100644 (file)
index 0000000..c3065d0
--- /dev/null
@@ -0,0 +1,85 @@
+// Include standard font and media definitions
+#include <font.defs>
+#include <media.defs>
+
+// Include ESC/P driver definitions
+#include <escp.h>
+
+// Specify that this driver uses the ESC/P driver...
+DriverType escp
+
+// Specify the driver options via the model number...
+ModelNumber ($ESCP_ESCK $ESCP_EXT_UNITS $ESCP_EXT_MARGINS $ESCP_USB
+             $ESCP_PAGE_SIZE $ESCP_RASTER_ESCI $ESCP_REMOTE)
+
+// List the fonts that are supported, in this case all standard
+// fonts...
+Font *
+
+// Manufacturer and driver version
+Manufacturer "Epson"
+Version 2.0
+
+// Supported page sizes and their margins
+HWMargins 0 0 0 0
+*MediaSize Letter
+MediaSize Legal
+MediaSize Executive
+MediaSize Statement
+MediaSize A4
+MediaSize A5
+MediaSize A6
+MediaSize B5
+MediaSize Env10
+MediaSize EnvC5
+MediaSize EnvDL
+MediaSize EnvISOB5
+MediaSize Postcard
+MediaSize DoublePostcard
+
+VariablePaperSize Yes
+MinSize 1in 4in
+MaxSize 8.5in 44in
+
+// Borderless printing offset...
+Attribute cupsESCPFP "" -80
+
+// Four color modes are supported...
+ColorModel Gray/Grayscale w chunky 1
+ColorModel Black k chunky 1
+*ColorModel RGB/Color rgb chunky 1
+ColorModel CMYK cmyk chunky 1
+
+// Supported resolutions
+Resolution - 8 90 0 103 "360dpi/360 DPI"
+*Resolution - 8 90 0 206 "720dpi/720 DPI"
+Resolution - 8 90 0 412 "1440dpi/1440 DPI"
+
+// Paper trays...
+*InputSlot 0 "Auto/Auto Select"
+InputSlot 1 "Manual/Manual Feed"
+
+Attribute cupsESCPPP 0 "1 255"
+Attribute cupsESCPPP 1 "2 1"
+
+// Very basic dithering settings
+Attribute cupsInkChannels "" 6
+Attribute cupsInkLimit "" 2.0
+
+Attribute cupsCyanLtDk "" "0.5 1.0"
+Attribute cupsMagentaLtDk "" "0.5 1.0"
+
+Attribute cupsAllDither 360dpi "0.5 0.75 1.0"
+Attribute cupsAllDither 720dpi "0.6 0.9 1.2"
+Attribute cupsAllDither 1440dpi "0.9 1.35"
+
+Attribute cupsESCPDotSize 360dpi 16
+Attribute cupsESCPDotSize 720dpi 17
+Attribute cupsESCPDotSize 1440dpi 18
+
+{
+  // EPSON Stylus Photo R300 Series
+  Throughput 1
+  ModelName "Epson Stylus Photo R300"
+  PCFileName "epspr302.ppd"
+}
index ab27adec01a876bc37bd0541e4f8795fe418e2af..70342b1acaec771198eadeae40ba6af45bb824c9 100644 (file)
@@ -587,7 +587,7 @@ write_banner(banner_file_t *banner, /* I - Banner file */
     * Start the page...
     */
 
-    printf("%%Page: %s %d\n", i == 1 ? "coverpage" : "coverback", i);
+    printf("%%%%Page: %s %d\n", i == 1 ? "coverpage" : "coverback", i);
     puts("gsave");
     printf("%.1f %.1f translate\n", PageLeft, PageBottom);
     puts("0 setgray");
index 95cc9eacdf5d168aa06fbf6da9943559d9c2085f..c2f3c493cd91f36875ba1e8a0092712d6729fbe8 100644 (file)
@@ -178,7 +178,7 @@ _cupsImageReadPNG(
     {
       bufsize = img->xsize * img->ysize;
 
-      if ((bufsize / img->ysize) != img->xsize)
+      if ((bufsize / img->xsize) != img->ysize)
       {
        fprintf(stderr, "DEBUG: PNG image dimensions (%ux%u) too large!\n",
                (unsigned)width, (unsigned)height);
@@ -190,7 +190,7 @@ _cupsImageReadPNG(
     {
       bufsize = img->xsize * img->ysize * 3;
 
-      if ((bufsize / (img->ysize * 3)) != img->xsize)
+      if ((bufsize / (img->xsize * 3)) != img->ysize)
       {
        fprintf(stderr, "DEBUG: PNG image dimensions (%ux%u) too large!\n",
                (unsigned)width, (unsigned)height);
index e809e40ff81247cc3761e9f787a6263f2c0b6494..1517a608bb81d23b700c454277c8234aab40830d 100644 (file)
@@ -84,6 +84,9 @@ psTextEmbedFonts(ps_text_t *fonts)    /* I - Font data */
 
       fclose(fp);
     }
+    else
+      fprintf(stderr, "DEBUG: Unable to open font file \"%s\" - %s\n",
+              filename, strerror(errno));
 
     puts("\n%%EndResource");
   }
index 6e553adbdb4f070f2138676ef15e499f4e340f96..504f662f6cfcbfbbfb2f3fd7223d90f12c719076 100644 (file)
@@ -11,7 +11,7 @@
 .\"   which should have been included with this file.  If this file is
 .\"   file is missing or damaged, see the license at "http://www.cups.org/".
 .\"
-.TH ppdc 1 "Common UNIX Printing System" "20 May 2008" "Apple Inc."
+.TH drv 1 "Common UNIX Printing System" "20 May 2008" "Apple Inc."
 .SH NAME
 drv \- cups driver interface for ppd compiler files
 .SH SYNOPSIS
index 5678d4d89997a2932390fcac4c602e01d4571e8d..19667785105fd0b3894f6b763fe15cea3a352928 100644 (file)
@@ -548,9 +548,11 @@ f 0644 root sys $DATADIR/data/testprint data/testprint
 d 0755 root sys $DATADIR/drv -
 f 0644 root sys $DATADIR/drv/sample.drv ppdc/sample.drv
 
+d 0755 root sys $DATADIR/examples -
+f 0644 root sys $DATADIR/examples examples/*.drv
+
 d 0755 root sys $DATADIR/fonts -
-f 0644 root sys $DATADIR/fonts fonts/Courier*
-f 0644 root sys $DATADIR/fonts/Symbol fonts/Symbol
+f 0644 root sys $DATADIR/fonts fonts/Monospace*
 
 d 0755 root sys $DATADIR/mime -
 f 0644 root sys $DATADIR/mime/mime.convs conf/mime.convs
@@ -640,6 +642,9 @@ f 0644 root sys $LIBDIR/libcupsppdc.a ppdc/libcupsppdc.a
 
 d 0755 root sys $DOCDIR/help -
 f 0644 root sys $DOCDIR/help doc/help/api*.html
+f 0644 root sys $DOCDIR/help/postscript-driver.html doc/help/postscript-driver.html
+f 0644 root sys $DOCDIR/help/ppd-compiler.html doc/help/ppd-compiler.html
+f 0644 root sys $DOCDIR/help/raster-driver.html doc/help/raster-driver.html
 f 0644 root sys $DOCDIR/help doc/help/spec*.html
 %subpackage