Drop cupstestdsc program and related documentation (Issue #5450)

author: Michael R Sweet <michael.r.sweet@gmail.com> 2018-12-06 14:53:22 -0500
committer: Michael R Sweet <michael.r.sweet@gmail.com> 2018-12-06 14:53:22 -0500
commit: dc5c941a67f25ec19fc1ab97e4b0ee849fb3ed63 (patch)
tree: d0ee3a8f55906d4ce41ea395edf33446f4fdf367 /doc
parent: 51c22b864a743207ee25c82aaf24ac1cccd5fb2b (diff)
download: cups-dc5c941a67f25ec19fc1ab97e4b0ee849fb3ed63.tar.gz
4 files changed, 1 insertions, 206 deletions
diff --git a/doc/Makefile b/doc/Makefile
index c297a8a8f..01ea3af3c 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -1,7 +1,7 @@
 #
 # Documentation makefile for CUPS.
 #
-# Copyright 2007-2017 by Apple Inc.
+# Copyright 2007-2018 by Apple Inc.
 # Copyright 1997-2007 by Easy Software Products.
 #
 # Licensed under Apache License v2.0.  See the file "LICENSE" for more information.
@@ -68,7 +68,6 @@ HELPFILES	=	\
 			help/man-cupsd-helper.html \
 			help/man-cupsd-logs.html \
 			help/man-cupsenable.html \
-			help/man-cupstestdsc.html \
 			help/man-cupstestppd.html \
 			help/man-filter.html \
 			help/man-ipptool.html \
@@ -107,8 +106,6 @@ HELPFILES	=	\
 			help/spec-command.html \
 			help/spec-design.html \
 			help/spec-ipp.html \
-			help/spec-pdf.html \
-			help/spec-postscript.html \
 			help/spec-ppd.html \
 			help/spec-raster.html \
 			help/spec-stp.html \
diff --git a/doc/help/man-cupstestdsc.html b/doc/help/man-cupstestdsc.html
deleted file mode 100644
index a69caed6a..000000000
--- a/doc/help/man-cupstestdsc.html
+++ /dev/null
@@ -1,44 +0,0 @@
-<!DOCTYPE HTML>
-<html>
-<!-- SECTION: Man Pages -->
-<head>
-	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
-	<title>cupstestdsc(1)</title>
-</head>
-<body>
-<h1 class="title">cupstestdsc(1)</h1>
-<h2 class="title"><a name="NAME">Name</a></h2>
-cupstestdsc - test conformance of postscript files (deprecated)
-<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
-<b>cupstestdsc</b>
-[
-<b>-h</b>
-]
-<i>filename.ps</i>
-[ ...
-<i>filenameN.ps</i>
-]
-<br>
-<b>cupstestdsc</b>
-[
-<b>-h</b>
-]
-<b>-</b>
-<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<b>cupstestdsc</b> tests the conformance of PostScript files to the Adobe PostScript Language Document Structuring Conventions Specification version 3.0.
-The results of testing and any other output are sent to the standard output.
-The second form of the command reads PostScript from the standard input.
-<h2 class="title"><a name="NOTES">Notes</a></h2>
-<i>This program is deprecated and will be removed in a future release of CUPS.</i>
-<p><b>cupstestdsc</b> only validates the DSC comments in a PostScript file and does not attempt to validate the PostScript code itself.
-Developers must ensure that the PostScript they generate follows the rules defined by Adobe.
-Specifically, all pages must be independent of each other, code outside page descriptions may not affect the graphics state (current font, color, transform matrix, etc.), and device-specific commands such as setpagedevice should not be used.
-<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-CUPS Online Help (<a href="http://localhost:631/help)">http://localhost:631/help)</a>,
-Adobe PostScript Language Document Structuring Conventions
-Specification, Version 3.0.
-<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright &copy; 2007-2018 by Apple Inc.
-
-</body>
-</html>
diff --git a/doc/help/spec-pdf.html b/doc/help/spec-pdf.html
deleted file mode 100644
index 7276c908a..000000000
--- a/doc/help/spec-pdf.html
+++ /dev/null
@@ -1,15 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<HTML>
-<!-- SECTION: Specifications -->
-<HEAD>
-	<TITLE>CUPS PDF Format</TITLE>
-	<LINK REL="STYLESHEET" TYPE="text/css" HREF="../cups-printable.css">
-</HEAD>
-<BODY>
-
-<H1 CLASS="title">CUPS PDF Format</H1>
-
-<P>CUPS PDF files (application/vnd.cups-pdf) are device-dependent PDF files that contain a job ticket information.</P>
-
-</BODY>
-</HTML>
diff --git a/doc/help/spec-postscript.html b/doc/help/spec-postscript.html
deleted file mode 100644
index 4d31d4b68..000000000
--- a/doc/help/spec-postscript.html
+++ /dev/null
@@ -1,143 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html>
-<!-- SECTION: Specifications -->
-<head>
-	<title>Generating PostScript for CUPS</title>
-	<meta name='keywords' content='Programming, PostScript, Document Structuring Conventions'>
-	<link rel='stylesheet' type='text/css' href='../cups-printable.css'>
-</head>
-<body>
-<!--
-  CUPS PostScript file specification for CUPS.
-
-  Copyright © 2007-2012 by Apple Inc.
-  Copyright © 2006 by Easy Software Products.
-
-  Licensed under Apache License v2.0.  See the file "LICENSE" for more
-  information.
--->
-
-<H1 CLASS="title">Generating PostScript for CUPS</H1>
-
-<h2 class='title'><a name='INTRODUCTION'>Introduction</a></h2>
-
-<p>This document describes how to generate PostScript output for
-CUPS and is largely based on the <a
-href="http://partners.adobe.com/public/developer/en/ps/5001.DSC_Spec.pdf">
-Adobe TechNote #5001: PostScript Language Document Structuring
-Conventions Specification Version 3.0</a>. While CUPS can
-generally print any PostScript file, following the rules in the
-Adobe TechNote and this document will ensure that your PostScript
-output will work reliably.</p>
-
-<blockquote><b>Note:</b> While PostScript is currently the
-de-facto standard print job file format/language for UNIX-based
-applications, it is slowly being phased out in favor of Adobe's
-Portable Document Format ("PDF") which offers many advantages
-over PostScript. macOS uses PDF as the primary print job file
-format and Linux is making the transition. Both PostScript and
-PDF are complex formats, and we highly recommend using high-level
-toolkits whenever possible to create your print jobs.</blockquote>
-
-<h3>Anatomy of a PostScript File</h3>
-
-<p>PostScript files are ASCII text files starting with a header
-line (<tt>%!PS-Adobe-3.0</tt>) followed by a combination of
-comment lines starting with the percent sign (<tt>%</tt>) and
-PostScript code lines. The lines themselves should not exceed 255
-characters to conform to the DSC. The following short PostScript
-file produces a box with a smiley face in it:</p>
-
-<pre class="command">
-%!PS-Adobe-3.0
-%%BoundingBox: 36 36 576 756
-%%Pages: 1
-%%LanguageLevel: 2
-%%EndComments
-%%BeginSetup
-% this is where fonts would be embedded
-%%EndSetup
-%%Page: (1) 1
-%%BeginPageSetup
-% this is where page-specific features would be specified
-%%EndPageSetup
-% Draw a black box around the page
-0 setgray
-1 setlinewidth
-36 36 540 720 rectstroke
-
-% Draw a two inch blue circle in the middle of the page
-0 0 1 setrgbcolor
-306 396 144 0 360 arc closepath fill
-
-% Draw two half inch yellow circles for eyes
-1 1 0 setrgbcolor
-252 432 36 0 360 arc closepath fill
-360 432 36 0 360 arc closepath fill
-
-% Draw the smile
-1 setlinecap
-18 setlinewidth
-306 396 99 200 340 arc stroke
-
-% Print it!
-showpage
-%%EOF
-</pre>
-
-<div class="figure"><table summary="Sample PostScript File Output">
-<caption>Figure 1: <a name="FIGURE_1">Sample PostScript File Output</a></caption>
-<tr><td align="center"><img src="../images/smiley.jpg"
-width="445" height="570" alt="Sample PostScript File Output"></td></tr>
-</table></div>
-
-
-<h2><a name='OPTIONS'>Embedding Printer Options</a></h2>
-
-<p>There are two main strategies for embedding printer options in PostScript
-files. The first is to list CUPS options using the <code>%cupsJobTicket</code>
-comment:</p>
-
-<pre>
-%!PS-Adobe-3.0
-%cupsJobTicket: media=A4 sides=two-sided-long-edge
-%cupsJobTicket: PrinterOption=foo PrinterOption2=bar
-...
-%%EndComments
-</pre>
-
-<p>CUPS options apply to the entire job. To apply options to individual pages,
-use the <code>%%IncludeFeature</code> comment instead:</p>
-
-<pre>
-%%Page: label 123
-%%BeginPageSetup
-%%IncludeFeature: *PageSize A4
-%%IncludeFeature: *PrinterOption Foo
-%%IncludeFeature: *PrinterOption2 Bar
-%%EndPageSetup
-...
-</pre>
-
-
-<h2><a name='FONTS'>Embedding Fonts and Text</a></h2>
-
-<p>Always embed the fonts used by your print job, and for best performance
-embed the fonts and character encodings in the setup section of the PostScript
-file. Type 1 and Type 3 fonts are supported by all PostScript printers, while
-Type 42 (TrueType) and CID fonts are supported by most level 2 and all level 3
-PostScript printers. Binary font files should always be converted to the
-corresponding ASCII (hex) encoding to avoid problems when printing over
-interfaces that do not support binary PostScript.</p>
-
-
-<h2><a name='IMAGES'>Embedding Images</a></h2>
-
-<p>The <code>image</code> operator should be used to embed images in PostScript
-files. Always use ASCII hex or Base-85 encoding for the image data to avoid
-problems when printing over interfaces that do not support binary PostScript.
-In most cases, the Base-85 encoding and compression filters can be used to
-embed images with very little, if any, increase in data size.</p>
-
-</body>
-</html>
author	Michael R Sweet <michael.r.sweet@gmail.com>	2018-12-06 14:53:22 -0500
committer	Michael R Sweet <michael.r.sweet@gmail.com>	2018-12-06 14:53:22 -0500
commit	dc5c941a67f25ec19fc1ab97e4b0ee849fb3ed63 (patch)
tree	d0ee3a8f55906d4ce41ea395edf33446f4fdf367 /doc
parent	51c22b864a743207ee25c82aaf24ac1cccd5fb2b (diff)
download	cups-dc5c941a67f25ec19fc1ab97e4b0ee849fb3ed63.tar.gz