[dm-devel] [PATCH v2 56/79] docs: Documentation/*.txt: rename all ReST files to *.rst

Jonathan Corbet corbet at lwn.net
Tue Apr 23 20:34:38 UTC 2019


On Tue, 23 Apr 2019 17:19:44 -0300
Mauro Carvalho Chehab <mchehab+samsung at kernel.org> wrote:

> Anyway, one of the things that occurred to me is that maybe
> some scripting work or a ReST extension could do something to parse
> "Documentation/foo" as :doc:`Documentation/foo` without needing to 
> explicitly use any ReST specific tags.

That probably makes sense too.  People do want to link to specific
subsections within documents, though; maybe we could allow
"Documentation/foo#bar" for that.  Such "markup" could even be useful for
people reading the plain-text files.

Thanks,

jon




More information about the dm-devel mailing list