Mauro Carvalho Chehab <mchehab+hua...@kernel.org> writes: > This series replace this patch: > https://lore.kernel.org/linux-doc/20210324191722.08d35...@coco.lan/T/#t > > It turns that there were multiple bugs at the get_abi.pl code that > create cross-references. > > Patches 1 to 6 fix those issues, and should apply cleanly on the top of > the docs tree (although I tested against next-20210323). > > Patch 7 is optional, and independent from the other patches. It is meant > to be applied against akpm's tree. It makes the description (IMHO) > clearer, while producing cross references for the two mentioned symbols.
So perhaps this is the best solution to the problem, but I must confess to not being entirely happy with it. get_abi.pl is becoming another unreadable perlpile like kerneldoc, and this makes it worse. Doing RST parsing there seems particularly unwelcome. Should the cross-reference generation, it now occurs to me, be done in the automarkup module instead? Then there's no need to interpret RST, and we'd get cross-references throughout the kernel docs rather than in just the ABI stuff. Am I completely out to lunch here? Thanks, jon
