On 08/05/18 11:25, George Dunlap wrote: > On 05/08/2018 07:47 AM, Juergen Gross wrote: >> Some documents contain invalid pandoc syntax leading to failures when >> creating PDFs from them, e.g. when calling "make all" in the docs >> directory. >> >> Correct those by using proper lists, code blocks and special character >> escaping. > > It's probably worth discussing at some point exactly which dialect(s) of > Markdown we'll support, and what we should call the resulting files. > > I'd be in favor of standardizing on pandoc markdown, and naming all the > files '.md'. Then we could, for instance, use `~~~` to indicate longer > code blocks, rather than four-space indentations (which are slightly > annoying if you're copy-and-pasting from other code). > > But maybe that's a discussion to have when we open the 4.12 development > window.
Another point is to add a call of "make -C docs all" to the OSStest smoke test after my patches have gone in. Juergen _______________________________________________ Xen-devel mailing list [email protected] https://lists.xenproject.org/mailman/listinfo/xen-devel
