> Am 01.10.2017 um 20:33 schrieb Randy Dunlap <rdun...@infradead.org>:
> 
> A different "problem" this time:
> 
> Documentation/driver-api/basics.rst pulls in include/linux/kernel.h.
> <linux/kernel.h> has kernel-doc notation for (among others) trace_printk()
> and trace_puts().
> 
> Part of the text for trace_printk() says:
> 
> * Note: __trace_printk is an internal function for trace_printk and
> *       the @ip is passed in via the trace_printk macro.
> 
> I am seeing this 'produced' (when I view the output html) as:
> 
> __trace_printk is an internal function for trace_printk and
> the ip is passed in via the trace_printk macro.
> 
> (BUT the first line is all BOLD).
> 
> I tried changing that to
>       \_\_trace_printk is an internal function...
> with the same BOLD result.
> 
> So I tried the source as
>       ``__trace_printk`` is an internal function...
> with the same BOLD result.
> 
> Maybe this is a s/w bug?
> Running Sphinx v1.3.1

Sorry for my late reply.  It is not only you, see:

- (perl kernel-doc) 
https://www.kernel.org/doc/html/latest/driver-api/basics.html#c.trace_printk
- (python kernel-doc) 
https://h2626237.stratoserver.net/kernel/linux_src_doc/include/linux/kernel_h.html#trace-printk

I have to dig.

-- Markus ----
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to