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

[Andreas K. <and...@su...>]

On Wed, 10 Apr 2019 18:03:10 -0500
Andy Goth <and...@gm...> wrote:

> On 4/10/19 6:00 PM, Andy Goth wrote:
> > On 4/10/19 5:58 PM, Andreas Kupries wrote:  
> >> Fix is in, the examples should look much nicer now.  
> > 
> > Not quite.  Backslash at end of line still renders as two
> > backslashes. Look at the Fundamentals section here:
> > 
> > http://core.tcl.tk/tcllib/doc/trunk/embedded/md/tcllib/files/modules/doctools/doctoc_lang_intro.md 
> > 
> > http://core.tcl.tk/tcllib/file?name=embedded/md/tcllib/files/modules/doctools/doctoc_lang_intro.md&txt=1   

That double-backslash comes from the input file

   https://core.tcl.tk/tcllib/file?name=modules/doctools/doctoc_lang_intro.man&txt=1

A single backslash in the doctools input converts to space in what the
generator sees, due to Tcl subst rules.

Guess I need a bit more special handling for that, i.e. look for
double-\ followed by \n


> 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.

I based this on
	http://tech.saigonist.com/b/code/escaping-special-characters-markdown.html

Note also 
	https://spec.commonmark.org/0.28/#backslash-escapes
which I had not seen before. That is for inlines only, so not for
verbatim blocks.

-- 
Andreas Kupries
SUSE Software Canada ULC
EuroTcl 2019, Jun 29-30, Nuernberg/DE, http://eurotcl.eu/
Tcl'2019, Nov 4-8, Houston, TX, USA.
http://www.tcl.tk/community/tcl2019/