[gs-cvs] gs/doc

[Leonardo]

Update of /cvs/ghostscript/gs/doc
In directory casper2:/tmp/cvs-serv29653/gs/doc

Modified Files:
	Ps2pdf.htm 
Log Message:
pdfwrite : Generate document Metadata.

THIS IS INCOMPATIBLE CHANGE.

Adobe Distiller 5 generates metadata according to Adobe XMP speification
iff the distiller parameter ParseDSCCommentsForDocInfo or PreserveEPSInfo is true.
Old versions of Ghostscript does not do that.
New versions of Ghostscript do when CompatibilityLevel >= 1.4 (default).
Generated PDF documents become longer in about 1.5 kilobytes.

See the documentation change about new command line options and distiller parameters.

DETAILS :

It's a part of the PDF/A project.

This is an initial commit for the subject.
It generates Document metadata as Adobe Distiller 6 does 
for a simple file (Genoa test 001-01.ps).

EXPECTED DIFFERENCES :

None.


Index: Ps2pdf.htm
===================================================================
RCS file: /cvs/ghostscript/gs/doc/Ps2pdf.htm,v
retrieving revision 1.88
retrieving revision 1.89
diff -u -d -r1.88 -r1.89
--- Ps2pdf.htm	20 Oct 2005 19:46:23 -0000	1.88
+++ Ps2pdf.htm	11 Nov 2005 12:35:37 -0000	1.89
@@ -378,6 +378,53 @@
 </dl>
 
 
+<a name="Encryption"></a>
+The following switches are used for generating metadata according to Adobe XMP specification :
+
+<dl>
+<dt><b><tt>-sDocumentUUID=</tt></b><em>string</em>
+<dd>Defines a DocumentID to be included into the document Metadata.
+If not specified, Ghostscript generates an UUID automatically.
+Otherwise the specified string is being copyed into the document without 
+checking its syntax or consistence.
+<p>
+Note that Adobe XMP specification requires DocumentID must be same
+for all versions of a document. Since Ghostscript does not provide
+a maintenance of document versions, users are responsible to provide
+a correct UUID through this parameter.
+<p>
+Note that Ghostscript has no assess to the host node ID
+due to a minimization of platform dependent modules.
+Therefore it uses an MD5 hash of the document contents for generating UUIDs.
+</dl>
+
+<dl>
+<dt><b><tt>-sInstanceUUID=</tt></b><em>string</em>
+<dd>Defines a instance ID to be included into the document Metadata.
+If not specified, Ghostscript generates an UUID automatically.
+Otherwise the specified string is being copyed into the document without
+checking its syntax or consistence.
+<p>
+Note that Adobe XMP specification requires instance ID must be inique
+for all versions of document. This parameter may be used to disable
+an unique ID generation for a debug purpose.
+
+<p>
+When none of <b><tt>DocumentUUID</tt></b>
+and <b><tt>InstanceUUID</tt></b> are specified,
+the generated DocumentID appears same as instance ID.
+</dl>
+
+<dl>
+<dt><b><tt>-sDocumentTimeSeq=</tt></b><em>integer</em>
+<dd>Defines an integer to be used as a deconflictor for generating
+UUIDs, when several invokations of Ghostscript create
+several PDF documents within same clock quantum (tick).
+Mainly reserved for very fast computers and/or multhithreading applications,
+which may appear in future. If both <b><tt>DocumentUUID</tt></b>
+and <b><tt>InstanceUUID</tt></b> are specified, <b><tt>DocumentTimeSeq</tt></b> is being ignored.
+</dl>
+
 <p>
 <b><tt>ps2pdf</tt></b> recognizes all of the Acrobat Distiller 5 parameters
 defined in the DistillerParameters document included in the