On Mon,  7 May 2018 06:35:36 -0300
Mauro Carvalho Chehab [off-list ref] wrote:

I decided to give a try with Sphinx last stable version
(1.17.4), and noticed several issues. The worse one was
with the networking book: a non-standard footnote there
with [*] instead of a number causes it to break PDF building.

So, I took some spare time to address some warnings all over
the tree, and moved a few text documents to a book. 

OK, I've applied the ones that seem to make sense for me to take now.
There's comments on the firmware one, and I'd rather have Tejun's OK for
the cgroup one.  The code-comment changes should probably go via the
usual maintainers.

I with
I had more time to move the other ones and to solve other
warnings.

You and me both - but each step helps!

Thanks,

jon