diff options
Diffstat (limited to 'doc/user/typ_apdf')
-rw-r--r-- | doc/user/typ_apdf | 23 |
1 files changed, 15 insertions, 8 deletions
diff --git a/doc/user/typ_apdf b/doc/user/typ_apdf index 3203384..531f9c9 100644 --- a/doc/user/typ_apdf +++ b/doc/user/typ_apdf @@ -10,12 +10,19 @@ pdf. @Index { PDF documents } @ID @Code "lout -PDF simple > simple.pdf" No other changes are required. @PP -The PDF output is superior to PostScript in providing links: when viewed -with a PDF viewer, entries in tables of contents and indexes can be -clicked on and this transports the viewer to the part of the document -referenced by the link. (Recent versions of PostScript support this -feature too, but Lout's PostScript doesn't.) However, the PDF output -produced by Lout is inferior at graphics: the advanced features of the -@Code "@Diag" and @Code "@Graph" packages do not produce any output. One -can still format documents that contain them, but the results are disappointing. +When viewed with a PDF viewer, entries in tables of contents and indexes +can be clicked on and this transports the viewer to the part of the document +referenced by the link, as described in +cross @CrossLink { Section {@NumberOf cross} }. Recent versions of PostScript +support this feature too, via the @I pdfmark feature, and Lout's PostScript +contains links expressed in this way. Unfortunately, few PostScript viewers +know how to handle these links; those that don't just ignore them. +@PP +Regrettably, the PDF output produced by Lout is inferior at graphics: the +advanced features of the @Code "@Diag" and @Code "@Graph" packages do not +produce any output. One can still format documents that contain them, but +the results are disappointing. The only way to get the best of everything +is to produce PostScript, and then either pass it through a `distillation' +program to produce PDF, or else view it with a PostScript viewer that +understands links. @End @Section |