Re: [PATCH] doc: listRCU: Add some more listRCU patterns in the kernel

From: Jonathan Corbet
Date: Wed Dec 04 2019 - 09:48:38 EST


On Wed, 4 Dec 2019 13:54:12 +0530
Amol Grover <frextrite@xxxxxxxxx> wrote:

> The cross-reference of the functions should be done automatically by sphinx
> while generating HTML, right? But when compiled none of the functions were
> cross-referenced hence "``" was added around the methods (and other symbols)
> to distinguish them from normal text.

If there's nothing to cross-reference to (i.e. no kerneldoc comments)
then the reference obviously won't be generated. I would still ask that
you leave out the literal markers; they will block linking to any docs
added in the future, and they clutter up the text - the plain-text reading
experience is important too.

Thanks,

jon