Imprimatur |
|
A Texinfo Document Checker |
Sergey Poznyakoff |
Imprimatur Manual (split by section): | ? |
3. Renditions
The basic concept used in Imprimatur
is the document
rendition. The rendition defines how much editor's information
and annotations should appear in the resulting document. There are
three possible renditions:
- Rendition: PROOF
This rendition is used for proofreading the document. It inserts all annotations in a prominent form, which makes it easy to revise the document.
- Rendition: DISTRIB
This rendition is intended for the documentation distributed with the packaged versions and its online copies on the Web. It inserts most important annotations, so that the reader is aware about which parts of the document are not fully revised for adequacy. Dangling cross-references are also prominently marked as such (see Dangling cross-reference).
- Rendition: PUBLISH
This rendition is intended for publishing printed copies of the documentation. It is supposed that by the time the document is ready for publishing, all editor's and proofreader's annotations and dangling references have been resolved and removed from the document. Consequently, the use of annotation macros in this rendition results in translation errors. This helps prevent publishing incomplete or inaccurate documentation.
Default rendition is determined when configuring the package. It can be redefined when building the output, by using the ‘RENDITION’ Makefile variable, e.g.:
$ make RENDITION=PUBLISH |
Imprimatur Manual (split by section): | ? |
Return to GNU's home page.
Return to the Puszcza home page.
Return to Sergey Poznyakoff home page.
Please send broken links and other corrections (or suggestions) to webmaster at gnu dot org dot ua.
Copyright © 2011 Sergey Poznyakoff
Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved.