Mauro Carvalho Chehab [off-list ref] writes:

That's said, automarkup.py has a rule to convert Documentation/<foo>.rst
into :doc:`<foo>`. So, an alternative approach would be to convert
treewide all :doc:`<foo>` into Documentation/<foo>.rst and add something 
at checkpatch.pl to recommend to avoid :doc: notation.

That seems like the right approach to me.  We have the automarkup
capability, we might as well make use of it...

Thanks,

jon