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

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

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

> On 4/9/19 10:46 PM, Andreas Kupries wrote:
> > If you are tracking Tcllib's
> > [timeline](https://core.tcl.tk/tcllib/timeline) you might have seen
> > that I am currently working in a branch [1] on a full set of guides
> > for the various roles (user, installer/builder,
> > developer/maintainer, release manager) associated with Tcllib.  
> 
> Cute, putting this email in markdown format.

Made it easier to write the links.

> The big issue I see is extraneous backslashes in verbatim code blocks,
> those being lines of text that begin with at least four spaces.

Yes. Arjen noted the same. I confirmed that pandoc does not like it
either. I am currently working on that. Clearly I am overquoting
the special characters. They are not special in the verbatim block and
thus should not be quoted when I emit MD.

> I'm not sure where to go to see any examples of this, but I am curious
> of extraneous backslashes are also present within `...` code spans.

Will check. Likely yes.

And confirmed that pandoc treats specials in `...` like in verbatim,
and when quoted the quotes are passed through also.

This is currently no trouble because the doctools md generator does not
emit `...` sequences for anything. It is something to watch for however
should that happen in the future.
 
> Here is the markdown rules reference:
> 
> https://core.tcl.tk/tcllib/md_rules

Thanks 

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