r762 - in branches/stable: doc/manual tests/03-deterministic-output
karl at freefriends.org
karl at freefriends.org
Tue Jul 5 19:44:56 CEST 2016
Author: karl
Date: 2016-07-05 17:44:56 +0000 (Tue, 05 Jul 2016)
New Revision: 762
Modified:
branches/stable/doc/manual/ChangeLog
branches/stable/doc/manual/pdftex-t.tex
branches/stable/tests/03-deterministic-output/test-prim.tex
Log:
\pdfcatalog{openaction ...} corrections; missed keyword expansion
Modified: branches/stable/doc/manual/ChangeLog
===================================================================
--- branches/stable/doc/manual/ChangeLog 2016-07-05 17:01:00 UTC (rev 761)
+++ branches/stable/doc/manual/ChangeLog 2016-07-05 17:44:56 UTC (rev 762)
@@ -1,3 +1,10 @@
+2016-07-05 Karl Berry <karl at freefriends.org>
+
+ * pdftex-t.tex (\pdfcatalog): explain "openaction <action-spec>"
+ within the text, since the BNF was incorrect.
+ (open-action spec): remove \Syntax item.
+ (\pdftrailer, \pdftrailerid): give simple examples.
+
2016-06-12 Karl Berry <karl at freefriends.org>
* pdftex-t.tex (\pdfmatch): mention default subcount 10; wording.
Modified: branches/stable/doc/manual/pdftex-t.tex
===================================================================
--- branches/stable/doc/manual/pdftex-t.tex 2016-07-05 17:01:00 UTC (rev 761)
+++ branches/stable/doc/manual/pdftex-t.tex 2016-07-05 17:44:56 UTC (rev 762)
@@ -1941,11 +1941,6 @@
}
\Syntax{
-\Something{open-action spec} \Means %
- \Literal{openaction} \Something{action spec}
-}
-
-\Syntax{
\Something{colorspace spec} \Means %
\Literal{colorspace} \Something{number}
}
@@ -2331,13 +2326,13 @@
Multiple appearances of \type{\pdfinfo} are concatenated. Usually if a
key is given more than once, the first appearance will be used, but this
is viewer||dependent. Except for standard \TeX\ expansion, \PDFTEX\ does
-not perform any further operations on \Something{general text} provided
-by the user.
+not perform any further operations in the \Something{general text}
+provided by the user.
Here is an example of using \type{\pdfinfo} to include the
information not supplied by \PDFTEX:
-\startesctyping
+\starttyping
\pdfinfo {
/Title (example.pdf)
/Author (Tom and Jerry)
@@ -2344,7 +2339,7 @@
/Subject (Example)
/Keywords (mouse, cat)
}
-\stopesctyping
+\stoptyping
For more details on all this, see the \PDFReference.
@@ -2358,7 +2353,7 @@
\pdftexprimitive{\Syntax{\Tex{\pdfsuppressptexinfo} \Whatever{integer}}}
\bookmark{\tex{pdfsuppressptexinfo}}
-Treated as a bitmask, specifying which \type{PTEX.} keys to omit from
+Treated as a bitmask, specifying which \type{PTEX.*} keys to omit from
the output:
\startbuffer
@@ -2375,7 +2370,7 @@
\stopbuffer
\placetable
- [here][pagemode]
+ [here][suppressptexinfo]
{\type{\pdfsuppressptexinfo} bit meanings.}
{\getbuffer}
@@ -2385,25 +2380,24 @@
\type{PTEX.Fullbanner} is included by default in the general document
info dictionary, as mentioned under \type{\pdfinfo} above. The other
\type{PTEX.*} keys are included when a \PDF\ is included in the document
-(and not otherwise), as described in \in{section}[sec.addpdfkeys]
+(and not otherwise), as described in \in{section}[sec.addpdfkeys].
This conditional suppression can be useful in making reproducible
\PDF{}s. \introduced{1.40.17}
-\pdftexprimitive{\Syntax{\Tex{\pdfcatalog} \Something{general text}
- \Optional{\Something{open-action spec}}}}
+\pdftexprimitive{\Syntax{\Tex{\pdfcatalog} \Something{general text}}}
\bookmark{\tex{pdfcatalog}}
-Similar to the document info section is the document catalog, where keys
-are \type{/URI}, which provides the base \URL\ of the document, and \type
-{/PageMode}, which determines how the \PDF\ viewer displays the document
-on startup. The possibilities for the latter are explained in \in {Table}
-[pagemode]:
+Similar to the document info section is the document catalog, where
+possible keys are \type{/URI}, which specifies the base \URL\ of the
+document, and \type {/PageMode}, which determines how the \PDF\ viewer
+displays the document on startup. The possibilities for the latter are
+explained in \in {table} [pagemode]:
\startbuffer
\starttabulate[|l|l|]
\HL
-\NC \bf value \NC \bf meaning \NC\NR
+\NC \bf value \NC \bf meaning \NC\NR
\HL
\NC \tt /UseNone \NC neither outline nor thumbnails visible \NC\NR
\NC \tt /UseOutlines \NC outline visible \NC\NR
@@ -2418,14 +2412,28 @@
{Supported \type{/PageMode} values.}
{\getbuffer}
-In full||screen mode, there is no menu bar, window controls, nor any other
-window present. The default setting is \type{/UseNone}.
+The default \type{/PageMode} setting is \type{/UseNone}. In
+full||screen mode, there is no menu bar, window controls, nor any other
+window present.
-The \Something{openaction} is the action provided when opening the
-document and is specified in the same way as internal links, see \in
-{section} [linking]. Instead of using this method, one can also write the
-open action directly into the catalog.
+One other construct allowed in the \Something{general text} is
+\Literal{openaction} \Something{action spec}, where \Literal{openaction}
+is a \PDFTEX\ keyword, and \Something{action spec} specifies the action
+to be taken when opening the document. This \Something{action spec} is
+the same as for internal links; see \in {section} [linking]. (Instead
+of using this method, one can also write the open action directly into
+the catalog.)
+Several settings can be made in one \type{\pdfcatalog} call, for
+example:
+
+\starttyping
+\pdfcatalog{
+ /PageMode /FullScreen
+ openaction goto page 2 {/Fit}
+}
+\stoptyping
+
\pdftexprimitive{\Syntax{\Tex{\pdfnames} \Something{general text}}}
\bookmark{\tex{pdfnames}}
@@ -2438,7 +2446,8 @@
\bookmark{\tex{pdftrailer}}
This command puts its argument text verbatim into the file trailer
-dictionary. \introduced{1.11a}
+dictionary. Example: \type{\pdftrailer {/mytrlrkey /mytrlrval}}.
+\introduced{1.11a}
\pdftexprimitive{\Syntax{\Tex{\pdftrailerid} \Something{general text}}}
\bookmark{\tex{pdftrailerid}}
@@ -2446,8 +2455,8 @@
Use the \Something{general text} to seed the \type{/ID} value in the
trailer, instead of the default combination of the absolute input file
name and starting time. If the argument is empty, the \type{/ID} is
-omitted entirely. This can be useful in making reproducible
-\PDF{}s. \introduced{1.40.17}
+omitted entirely. Example: \type{\pdftrailerid{}}. This can be useful
+in making reproducible \PDF{}s. \introduced{1.40.17}
%***********************************************************************
Index: branches/stable/tests/03-deterministic-output/test-prim.tex
===================================================================
--- branches/stable/tests/03-deterministic-output/test-prim.tex 2016-07-05 17:01:00 UTC (rev 761)
+++ branches/stable/tests/03-deterministic-output/test-prim.tex 2016-07-05 17:44:56 UTC (rev 762)
Property changes on: branches/stable/tests/03-deterministic-output/test-prim.tex
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+Date Author Id
\ No newline at end of property
More information about the pdftex-commits
mailing list