Tcl Library Source Code

The TEPAM Introduction page at https://core.tcl.tk/tcllib/doc/trunk/embedded/md/tcllib/files/modules/tepam/tepam_introduction.md contains a couple of errors:

1. The PROCEDURE DECLARATION section, 2nd paragraph after the example code, says "The procedure body on the other hand is identical between a command declared with proc and a command declared with procedure", but the example code contains asterisks in the body which aren't part of a normal "proc" declaration. If they're not formatting errors, the text doesn't explain them.

2. In the FLEXIBLE ARGUMENT DIALOG BOX section, the big example code is missing a trailing square bracket "]".

Ref 2: A missing flush of accumulated expander text in `example_end` caused the bracket to become part of the plain text after the example instead of being part of it.

Ref 1: Fixed as envisioned

Fixed with commit [f5786278a4].

Version bump 1.5.5.

Thank you for the report.

Wrt 1: Checking around I would say it is an issue with the markdown generator. The stars/asterisks are markdown syntax for emphasis. They are also limited to inline use, i.e. cannot cross lines, while the .man [emph] command is ok with application on multi-line text. The generator is not taking this into account and simply emits the md syntax without breaking lines apart and marking each separately.

Wrt 2: The trailing bracket is actually present. It just somehow moved to the next line, after the example. Checking ... In the .man it is definitely part of the example.  And in the generated .md it is separated from the example by a blank line. So the input is ok, and the fossil markdown rendering does the correct thing too. The issue is in the markdown generator. Again.

So, both problem are issues with the new markdown generator, and not with the manpage.