On Wed, Jun 1, 2016 at 11:46 AM, Jani Nikula <jani.nikula@xxxxxxxxxxxxxxx> wrote: > On Wed, 01 Jun 2016, Daniel Vetter <daniel.vetter@xxxxxxxx> wrote: >> There's still something very fishy going on with some of these, e.g. >> the drm_modeset_lock Example: and the "Standard GTF Parameters:" Line >> somehow get treated as heading when just appending a :: at the end of >> those lines. But it seems to work everywhere else. Maybe the >> kernel-doc heading generation logic is still a bit wonky? > > Try adding a blank line between the line with trailing :: and the actual > preformatted text. Seems to do the right thing for me. > > http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#literal-blocks > > "Blank lines are required before and after a literal block, but these > blank lines are not included as part of the literal block." That's not what I've meant. The following sometimes (but not always, only in the 2 places I've mentioned) becomes a kernel-doc directive and not a block quote: * Standard GTF Parameters:: * * stuff I wanted to have block quoted. But if I switch the :: to be on a line of it's own (like in the patch) it's totally fine. -Daniel -- Daniel Vetter Software Engineer, Intel Corporation +41 (0) 79 365 57 48 - http://blog.ffwll.ch _______________________________________________ dri-devel mailing list dri-devel@xxxxxxxxxxxxxxxxxxxxx https://lists.freedesktop.org/mailman/listinfo/dri-devel
