summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Build/source/texk/web2c/cwebdir/cwebman-w2c.ch19
-rw-r--r--Build/source/texk/web2c/cwebdir/cwebman.tex2
2 files changed, 20 insertions, 1 deletions
diff --git a/Build/source/texk/web2c/cwebdir/cwebman-w2c.ch b/Build/source/texk/web2c/cwebdir/cwebman-w2c.ch
index 3947de5f0f8..6685692463e 100644
--- a/Build/source/texk/web2c/cwebdir/cwebman-w2c.ch
+++ b/Build/source/texk/web2c/cwebdir/cwebman-w2c.ch
@@ -354,3 +354,22 @@ Looking at those
\point 20. Furthermore, group titles can be converted to an arbitrary
@z
+@x
+\vfill\end
+@y
+\point 21. With modern \TeX\ engines like `\.{luatex}', `\.{pdftex}', and
+`\.{xetex}' (but \\{not} with classic `\.{tex}') you can say `\.{\\input
+pdfwebtocfront}' as the last command in limbo and run \TeX\ \\{twice} on your
+woven document, in order to shift the table-of-contents to the front of the
+{\mc PDF} output.
+
+\point 22. You are advised to use the command line option `\.{--shell-escape}'
+with \.{pdftex} and \.{luatex} in order to receive ``valid'' PDF output from
+your \.{CWEB} source file; otherwise, the internal counter for the ``Names of
+the sections'' part in the PDF ``bookmarks'' will be incorrect. (`\.{xetex}'
+and `\.{tex "\\let\\pdf+..."}' take a different approach that is correct by
+design.)
+
+\vfill\end
+@z
+
diff --git a/Build/source/texk/web2c/cwebdir/cwebman.tex b/Build/source/texk/web2c/cwebdir/cwebman.tex
index 2d53e7589fc..989eef6ee37 100644
--- a/Build/source/texk/web2c/cwebdir/cwebman.tex
+++ b/Build/source/texk/web2c/cwebdir/cwebman.tex
@@ -1163,7 +1163,7 @@ for the macros that make this work.)
Alternatively, thanks to H\`an Th\^e\kern-.3em\raise.3ex\hbox{\'{}} Th\`anh
and Andreas Scherer, you can generate \.{cob.pdf} in one step by simply
saying `\.{pdftex}~\.{cob}'.
-Alternative ways to create PDF output from \.{CWEB} input are to say
+Alternative ways to create {\mc PDF} output from \.{CWEB} input are to say
`\.{xetex}~\.{cob}' or `\.{luatex}~\.{cob}'.
Similar output for ``smart'' devices can be created with Martin Ruckert's