From: scott@statsci.com (Scott Blachowicz)
Subject: Re: pageview question
Reply-To: scott@statsci.com
Organization: Statistical Sciences, Inc., Seattle, WA USA
	<SCOTT.92Dec9175803@arugula.statsci.com>
	<1992Dec11.212403.3224@sq.sq.com>
Date: Wed, 16 Dec 1992 17:38:13 GMT

>>>>> "lee" == Liam R. E. Quin <lee@sq.sq.com>
>>>>> "me" == Scott Blachowicz <scott@statsci.com>

 lee> Watch for EPS files that contain %%Page (they shouldn't!).

 me> [By my interpretation of what I've read...] Yes, they can.
 me> So long as there is only one page, then things are SUPPOSED to be OK. 
 me> I have heard of software that claims having %%Page makes it non-EPS, though.
 me> If 'pageview' is such a package, I'd call it broken.

 lee> Looking at 

 lee> Required Comments
 lee> 	%!PS-Adobe-2.0 EPSF-2.0
 lee> 	%%BoundingBox: LLx LLy URx URy
I've been looking at 3.0 rules from the 2nd ed red book...

 lee> Optional Comments:
 lee> 	%%Title: doc_title
 lee> 	%%Creator: your name
 lee> 	%%CreationDate date_and_time
 lee> 	%%EndComments

 lee> In addition, the following comments are permitted:
 [ ... ]

 lee> In sec. 5.3 we have:
 lee>     The showpage operator is permitted in EPS files.... It is the including
 lee>     document's responsibility to disable  showpage if needed.
 lee>     (there's an example of how to do this)

That implies that an EPS file can also be viewed as a printable
"page"...possibly with a prolog and  a "document setup" section. The "document
setup" section is defined as being between the "%%EndProlog" and the first
"%%Page".

 lee> One example has
 lee> 	%%Pages: 0
 lee> but no %%Page 0 0 comment, ass one would expect.

 lee> The comment %%Pages is not specifically permitted, however.
From section G.3.1 of red book 2:

       The document structure rules described in Section G.4, "Document
    Structure Rules," must be followed. The following comments delineate the
    structure of the document. If there is a section of a document that
    corresponds to a particular comment, that comment _must_ be used to
    identify that section of the document.
       %!PS-Adobe-3.0
       %%Pages:
       [ ... ]
       %%Page:
       [ ... ]

[Followed by a paragraph that I hadn't noticed before...]
       For example, if there are distinct independent pages [note the plural]
    in a document, the "%%Page:" comment must be used at the beginning of each
    page to identify the those pages.
[Then later in section G.4.5...]
    Page Comments
       ... The beginning of a page should be noted by the %%Page: comment.

 lee> I think a good general rule is to avoid having %%Page: comments for
 lee> an illustration intended only to be included on a page.
 lee> If nothing else, giving it a separate %%Page comment defeats the purpose
 lee> of the %%Page: comments, since the comment will not start a new page.

I think it basically boils down to whether or not one considered the included
file to be a page in its own right when it was created as a separate file. It
seems if you put a 'showpage', at the end, then you are saying that it can be
a separate page. In that case there should be %%Pages: and %%Page: comments.
Either way, the file is a legitimate EPS file, and importing applications
should not complain about the presence of either comment.

--
Scott Blachowicz    Ph: 206/283-8802x240      USPS:  Statistical Sciences, Inc
                                                      1700 Westlake Ave N #500
scott@statsci.com / uunet!statsci!scott                Seattle, WA USA   98109
..or..     Scott.Blachowicz@seaslug.org