Mauro Carvalho Chehab <[email protected]> writes: > This series replace this patch: > https://lore.kernel.org/linux-doc/[email protected]/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
