Load cups into easysw/current.

[thirdparty/cups.git] / cups / api-cups.shtml

diff --git a/cups/api-cups.shtml b/cups/api-cups.shtml
new file mode 100644 (file)
index 0000000..a391127
--- /dev/null
+++ b/cups/api-cups.shtml
@@ -0,0 +1,48 @@
+<!--
+  "$Id$"
+
+  CUPS API introduction for the Common UNIX Printing System (CUPS).
+
+  Copyright 1997-2006 by Easy Software Products.
+
+  These coded instructions, statements, and computer programs are the
+  property of Easy Software Products 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 missing or damaged please contact Easy Software Products
+  at:
+
+      Attn: CUPS Licensing Information
+      Easy Software Products
+      44141 Airport View Drive, Suite 204
+      Hollywood, Maryland 20636 USA
+
+      Voice: (301) 373-9600
+      EMail: cups-info@cups.org
+       WWW: http://www.cups.org
+-->
+
+<h2 class='title'>Introduction</h2>
+
+<p>The CUPS APIs provide...</p>
+
+<h2 class='title'>General Usage</h2>
+
+<p>The <var>&lt;cups/cups.h&gt;</var> header file must be included to
+use the CUPS functions.</p>
+
+<p>Programs using these functions must be linked to the CUPS
+library: <var>libcups.a</var>, <var>libcups.so.2</var>,
+<var>libcups.2.dylib</var>, <var>libcups_s.a</var>, or
+<var>libcups2.lib</var> depending on the platform. The following
+command compiles <var>myprogram.c</var> using GCC and the CUPS
+library:</p>
+
+<pre class='command'>
+<kbd>gcc -o myprogram myprogram.c -lcups</kbd>
+</pre>
+
+<h2 class='title'>Compatibility</h2>
+
+<p>Unless otherwise specified, the CUPS API functions require
+CUPS 1.1 or higher.</p>