Hi Jon, Daniel, Jani and Mauro, "bump" ... may my mail got lost ... It's about the default highlight language in the conf.py. I suggested to set it to the value 'guess', since this might solve most of our problems discussed in this context. conf.py:: highlight_language = 'guess' Thanks for your comments and sorry for bumping. -- Markus -- Am 09.08.2016 um 16:11 schrieb Markus Heiser <markus.heiser@xxxxxxxxxxx>: > > Am 09.08.2016 um 16:07 schrieb Jonathan Corbet <corbet@xxxxxxx>: > >> On Tue, 9 Aug 2016 15:56:15 +0200 >> Daniel Vetter <daniel.vetter@xxxxxxxx> wrote: >> >>>> So I honestly think we should just set the highlight language to "none" by >>>> default. The syntax highlighting in code samples adds some colorful sugar >>>> to the docs, but it's not really all that useful, IMO, and people who want >>>> it can override the language in the right places. >>>> >>>> Any strong opposition to this idea? >>> >>> Hm right, didn't realize that this is where it's coming from. No >>> strong opinion from my side on highlighting the C block quotes really. >>> Otoh that highlighting is rather pretty. Could we perhaps just shut >>> sphinx up about the "C" highlighting issues? >> >> We can look into that, but, in the end, we'll always have a lot of literal >> blocks that are not C code. Even if Sphinx doesn't warn about them, it >> tries to mark them up as C with occasionally strange results. I'm not >> really convinced it's a net win. >> >> jon > > Hi, as far as I know, there is no option to suppress warnings > from the lexer [1]. What's about "highlight_language = 'guess'" ... > I compiled gpu and the warnings disappear, but I have not yet > looked at the complete results in HTML. > > [1] FYI: Sphinx's lexer is http://pygments.org/ > > --M-- -- 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
