makeinfo man page: say columns, not characters

2021-12-04 Thread 積丹尼 Dan Jacobson
$ man makeinfo --fill-column=NUM break Info lines at NUM characters (default 72). Say columns, not characters. E.g., there will be less characters if they are fullwidth characters. $ makeinfo --version texi2any (GNU texinfo) 6.8

clean up left over html files

2021-12-04 Thread 積丹尼 Dan Jacobson
Here we see a second run of makeinfo --html has only updated the first file: $ ls -ogt -rw-r--r-- 1 1714 12-04 23:59 index.html -rw-r--r-- 1 2757 12-04 23:49 First-Chapter.html -rw-r--r-- 1 2327 12-04 23:49 First-Section.html -rw-r--r-- 1 3422 12-04 23:49 Index.html -rw-r--r-- 1 2334 12-04 23:49

Weird paragraph breaks in makeinfo man page

2021-12-04 Thread 積丹尼 Dan Jacobson
Weird paragraph breaks in man page: $ man makeinfo -o, --output=DEST output to DEST. With split output, create DEST as a directory and put the output files there. With non-split output, if DEST is already a directory or ends with a /,

makeinfo man page: note --no-* toggles off

2021-12-04 Thread 積丹尼 Dan Jacobson
(info "(texinfo) Invoking texi2any") says '--no-number-footnotes' '--number-footnotes' Suppress automatic footnote numbering. By default, footnotes are numbered sequentially within a node, i.e., the current footnote number is reset to 1 at the start of each node. Yes, even I know

Mention cases when @noindent = @indent

2021-12-04 Thread 積丹尼 Dan Jacobson
Add a note to (info "(texinfo) @noindent") mentioning why $ echo -e @indent\\n\\n|makeinfo --plaintext $ echo -e @noindent\\n\\n|makeinfo --plaintext give the same output. (Don't tell me. I know why. Mention why in the document. Thanks.)

Mention workaround to change margins

2021-12-04 Thread 積丹尼 Dan Jacobson
(info "(texinfo) @pagesizes") says: To make more elaborate changes, such as changing any of the page margins, you must define a new command in 'texinfo.tex' or 'texinfo.cnf'. Mention a workaround: Before: $ perl -wle 'for(1..2){print "ABC " x 33, "\n";}'|makeinfo --plaintext ABC ABC

Always show source code of examples

2021-12-04 Thread 積丹尼 Dan Jacobson
(info "(texinfo) @format") says: This is an example of text written between a '@format' command and an '@end format' command. As you can see from this example, the '@format' command does not fill the text. OK, that's great. However it would take five minutes less to figure out if instead you

Mention how to unindent footnotes

2021-12-04 Thread 積丹尼 Dan Jacobson
On (info "(texinfo) Footnote Styles") (info "(texinfo) @paragraphindent") mention how to unindent footnotes. $ makeinfo --plaintext --set-customization-variable paragraphindent=0 doesn't work. Or mention that 'sorry, it is impossible. Use sed or awk etc.'