Am 16.10.2016 um 15:03 schrieb Stephan Mueller <smueller@xxxxxxxxxx>: > Am Sonntag, 16. Oktober 2016, 14:56:49 CEST schrieb Markus Heiser: > > Hi Markus, > ... > >> compared to DocBook, with sphinx you can use (have to use) the reST markup >> in source code comments. >> >> Here, the code example is just a (indented) float text and this is >> why you have to quote the asterisk "\*req,". > > Is there any preferred / suggested way whether to use literal or highlighted > (or even my approach on) formatting? No. IMO the "::" markup for code blocks is a good compromise. It is not to verbose and prevents you quoting frequent asterisk in code examples. --Markus-- > Ciao > Stephan > -- > To unsubscribe from this list: send the line "unsubscribe linux-doc" in > the body of a message to majordomo@xxxxxxxxxxxxxxx > More majordomo info at http://vger.kernel.org/majordomo-info.html -- To unsubscribe from this list: send the line "unsubscribe linux-crypto" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html