Re: [Tcllib-devel] Tcllib - Dev- and other Guides - Looking For Feedback

[Andy G. <and...@gm...>]

On 4/10/19 6:20 PM, Andreas Kupries wrote:
> On Wed, 10 Apr 2019 18:03:10 -0500 Andy Goth <and...@gm...> wrote:
>> Also, I'm curious why period is quoted with backslash: \.
> 
> Technically '.' is a special character in markdown, due to its use for
> ordered lists lead-in.

That makes sense.  Thank you.

I'm comparing the source with the generated markdown:

http://core.tcl.tk/tcllib/artifact?fn=modules/doctools/docidx_lang_intro.man&ci=c74461e613
http://core.tcl.tk/tcllib/artifact?fn=embedded/md/tcllib/files/modules/doctools/doctools_lang_intro.md&ci=c74461e613&txt=1
http://core.tcl.tk/tcllib/doc/c74461e613/embedded/md/tcllib/files/modules/doctools/doctools_lang_intro.md

But they seem to be quite different.  What am I missing?

The *.man source says:

[subsection Fundamentals]

While the [term {docidx markup language}] is quite similar to the
[term {doctools markup language}], in the broadest terms possible,
there is one key difference. An index consists essentially only of
markup commands, with no plain text interspersed between them, except
for whitespace.

The markdown says:

## <a name='subsection1'></a>Fundamentals

In the broadest terms possible the *doctools markup language* is 
LaTeX\-like,
instead of like SGML and similar languages\. A document written in this 
language
consists primarily of text, with markup commands embedded into it\.

Also, what is idoc?

http://core.tcl.tk/tcllib/artifact?fn=idoc/www/tcllib/files/modules/doctools/docidx_lang_intro.html&ci=c74461e613

At least for the section I quoted above, the idoc file matches the *.man
source.

-- 
Andy Goth | <andrew.m.goth/at/gmail/dot/com>