r763 - branches/stable/doc/manual

[karl at freefriends.org]

Author: karl
Date: 2016-07-05 17:53:31 +0000 (Tue, 05 Jul 2016)
New Revision: 763

Modified:
   branches/stable/doc/manual/ChangeLog
   branches/stable/doc/manual/pdftex-t.tex
Log:
(\pdfcatalog): openaction <action spec> does come after the <general text>

Modified: branches/stable/doc/manual/ChangeLog
===================================================================
--- branches/stable/doc/manual/ChangeLog	2016-07-05 17:44:56 UTC (rev 762)
+++ branches/stable/doc/manual/ChangeLog	2016-07-05 17:53:31 UTC (rev 763)
@@ -1,8 +1,11 @@
 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.
+	* pdftex-t.tex (\pdfcatalog): show "openaction <action spec>"
+	after the <general text>, instead of creating an <open-action spec>,
+	for (hopefully) more clarity.
 	(open-action spec): remove \Syntax item.
+	Report from Douglas McKenna to pdftex list, 3 Jul 2016 12:46:59.
+	
 	(\pdftrailer, \pdftrailerid): give simple examples.
 
 2016-06-12  Karl Berry  <karl at freefriends.org>

Modified: branches/stable/doc/manual/pdftex-t.tex
===================================================================
--- branches/stable/doc/manual/pdftex-t.tex	2016-07-05 17:44:56 UTC (rev 762)
+++ branches/stable/doc/manual/pdftex-t.tex	2016-07-05 17:53:31 UTC (rev 763)
@@ -2385,7 +2385,8 @@
 This conditional suppression can be useful in making reproducible
 \PDF{}s.  \introduced{1.40.17}
 
-\pdftexprimitive{\Syntax{\Tex{\pdfcatalog} \Something{general text}}}
+\pdftexprimitive{\Syntax{\Tex{\pdfcatalog} \Something{general text}
+  \Optional{\Literal{openaction} \Something{action spec}}}}
 \bookmark{\tex{pdfcatalog}}
 
 Similar to the document info section is the document catalog, where
@@ -2416,13 +2417,13 @@
 full||screen mode, there is no menu bar, window controls, nor any other
 window present.
 
-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.)
+After the \Something{general text}, a construct \Literal{openaction}
+\Something{action spec} can be given, 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:
@@ -2430,8 +2431,7 @@
 \starttyping
 \pdfcatalog{
   /PageMode /FullScreen
-  openaction goto page 2 {/Fit}
-}
+} openaction goto page 2 {/Fit}
 \stoptyping
 
 \pdftexprimitive{\Syntax{\Tex{\pdfnames} \Something{general text}}}