Menu
▾
▴
Re: [Tcllib-devel] Tcllib - Dev- and other Guides - Looking For Feedback
|
From: Andreas K. <and...@su...> - 2019-04-17 16:20:21
|
On Wed, 17 Apr 2019 01:13:11 -0500 Andy Goth <and...@gm...> wrote: > I found another formatting issue in the new markdown related to > complex nested lists. > https://core.tcl.tk/tcllib/doc/trunk/embedded/md/tcllib/files/modules/doctools/doctools_lang_cmdref.md#26 > > Scroll down to the following two paragraphs sandwiched between > bulleted lists. > > "Additionally the following names are recognized as shortcuts for some > of the regular types:" > > "At last the following names are still recognized for backward > compatibility, but are otherwise considered to be deprecated." > > The first list item (args and arg, respectively) of each list is not > displayed correctly. > > https://core.tcl.tk/tcllib/file?name=embedded/md/tcllib/files/modules/doctools/doctools_lang_cmdref.md&txt=1 > > Reviewing the generated markdown, I don't see any syntax errors. This > may be a fault in Fossil itself. I'd cross-post to Fossil, but Fossil > no longer has a mailing list. Instead, it uses a forum: > > https://fossil-scm.org/forum/forum I confirm your findings, i.e. the .md file looks to have no syntax errors, and the rendering of it is bad. Especially weird that the first of the nested lists is not affected at all. Only idea I have at the moment is invisible superfluous spaces causing this ... Checked, no spaces around, thus out of ideas. Ok. I will make a copy of this file later today and then try to reduce it to something minimal still exhibiting the issue. When I have that I will ping Richard. Thanks for the report. Seems that the docs of the entire Tcllib are a nice stress-tests for both my generator, and fossil's renderer. And other renderers If you look into examples rendered as block quotes (to allow for markup inside the example) you will note that I use ` ` for leading spaces to preserve indentation (somewhat, tab becomes space). I am not replacing any of the internal spaces at all. Because if I do that the pandoc parser seems to break down and misrender. Fossil maybe as well. -- 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/ |
