summaryrefslogtreecommitdiff
path: root/Build/source/texk/web2c/cwebdir/cwebman-w2c.ch
diff options
context:
space:
mode:
authorAndreas Scherer <andreas_tex@freenet.de>2023-10-16 14:53:03 +0000
committerAndreas Scherer <andreas_tex@freenet.de>2023-10-16 14:53:03 +0000
commit4b3b91ce79597afd74bcdd27284b18871fa02832 (patch)
tree39addce3235efb0eb99e86c02390f78fd6cad0bf /Build/source/texk/web2c/cwebdir/cwebman-w2c.ch
parent9aafcff65b57b703b0929619afee5933d14ab099 (diff)
[CWEB] Add two notes in Appendix C.
Fix a formatting glitch in cwebman.tex. git-svn-id: svn://tug.org/texlive/trunk@68561 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/web2c/cwebdir/cwebman-w2c.ch')
-rw-r--r--Build/source/texk/web2c/cwebdir/cwebman-w2c.ch19
1 files changed, 19 insertions, 0 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
+