diff options
Diffstat (limited to 'doc/expert/pre_page')
| -rw-r--r-- | doc/expert/pre_page | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/doc/expert/pre_page b/doc/expert/pre_page new file mode 100644 index 0000000..cccff13 --- /dev/null +++ b/doc/expert/pre_page @@ -0,0 +1,20 @@ +@Section + @Tag { pagelabel } + @Title { "@PageLabel" } +@Begin +@PP +pagelabel.sym @Index { @@PageLabel symbol } +The @@PageLabel symbol associates a page label in the PostScript +output file with the page within which (or just before which) the symbol +occurs, so that PostScript viewers are able to index the page +by this label. (The label is printed in the @Code "%%Page" comment +preceding the page in the PostScript output file.) For example, +@ID @Code "@PageLabel iv" +associates the label @Code "iv" with the page. The label may be +an arbitrary object; if its value is not a simple word, it will +be replaced by {@Code "?"}. +@PP +@@PageLabel is unrelated to Lout's cross referencing mechanism; +it is for communicating a label to the PostScript output file, not to +other parts of Lout. The result of @@PageLabel is a null object. +@End @Section |