Ambiguity in pdfTeX user manual syntax description

Douglas McKenna <doug-Nf2trSL5CZG0AFT+FuuGOlaTQe2KTcn/@public.gmane.org>
Newsgroups gmane.comp.tex.pdftex
Message-ID <[email protected]>
Dear pdfTeX user manual maintainers,


In my pdfTeX user manual, version 1.40.15, (circa 2014), the "General definitions and syntax rules" section on page 17 defines

   ⟨open-action spec⟩ → openaction ⟨action spec⟩

where "openaction" on the right hand side of the production rule appears to be a literal.  The documentation for \pdfcatalog syntax on page 20 properly references the left side using

   \pdfcatalog ⟨general text⟩ [ ⟨open-action spec⟩ ]

But in the last paragraph on that page, first sentence, it says

   The ⟨openaction⟩ is the action …

This is ambiguous, because ⟨openaction⟩ is not defined in angle brackets in the General definitions section, but is used as a literal token.  Should this sentence start with

   The ⟨open-action spec⟩ is the action …

or does <openaction> in that sentence refer to the literal token "openaction" used in the General definitions section?

Thanks.


- Doug McKenna
Mathemaesthetics, Inc.
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.