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_apdf21
1 files changed, 21 insertions, 0 deletions
diff --git a/doc/user/typ_apdf b/doc/user/typ_apdf
new file mode 100644
index 0000000..3203384
--- /dev/null
+++ b/doc/user/typ_apdf
@@ -0,0 +1,21 @@
+@Section
+ @Title { PDF (Adobe Portable Document Format) documents }
+ @Tag { pdf }
+@Begin
+@PP
+You can get Lout to produce PDF (Adobe Portable Document Format) output as
+an alternative to PostScript, by adding @Code "-PDF" to the command line
+like this:
+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.
+@End @Section