texlive[68561] Build/source/texk/web2c/cwebdir: [CWEB] Add two notes

[commits+ascherer at tug.org]

Revision: 68561
          https://tug.org/svn/texlive?view=revision&revision=68561
Author:   ascherer
Date:     2023-10-16 16:53:03 +0200 (Mon, 16 Oct 2023)
Log Message:
-----------
[CWEB] Add two notes in Appendix C.

Fix a formatting glitch in cwebman.tex.

Modified Paths:
--------------
    trunk/Build/source/texk/web2c/cwebdir/cwebman-w2c.ch
    trunk/Build/source/texk/web2c/cwebdir/cwebman.tex

Modified: trunk/Build/source/texk/web2c/cwebdir/cwebman-w2c.ch
===================================================================
--- trunk/Build/source/texk/web2c/cwebdir/cwebman-w2c.ch	2023-10-15 23:43:07 UTC (rev 68560)
+++ trunk/Build/source/texk/web2c/cwebdir/cwebman-w2c.ch	2023-10-16 14:53:03 UTC (rev 68561)
@@ -354,3 +354,22 @@
 \point 20. Furthermore, group titles can be converted to an arbitrary
 @z
 
+ at x
+\vfill\end
+ at 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
+ at z
+

Modified: trunk/Build/source/texk/web2c/cwebdir/cwebman.tex
===================================================================
--- trunk/Build/source/texk/web2c/cwebdir/cwebman.tex	2023-10-15 23:43:07 UTC (rev 68560)
+++ trunk/Build/source/texk/web2c/cwebdir/cwebman.tex	2023-10-16 14:53:03 UTC (rev 68561)
@@ -1163,7 +1163,7 @@
 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