> Am 01.10.2017 um 20:33 schrieb Randy Dunlap <rdunlap@xxxxxxxxxxxxx>: > > 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 majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
