aboutsummaryrefslogtreecommitdiffstats
path: root/doc/user/typ_apdf
diff options
context:
space:
mode:
Diffstat (limited to 'doc/user/typ_apdf')
-rw-r--r--doc/user/typ_apdf23
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