docs: tidy up TOCs and refs to license-rules.rst
authorMarkus Heiser <markus.heiser@darmarit.de>
Tue, 14 Aug 2018 11:43:12 +0000 (13:43 +0200)
committerJonathan Corbet <corbet@lwn.net>
Fri, 31 Aug 2018 22:50:50 +0000 (16:50 -0600)
commit9799445af124c2476c7e0cc5432375348b6a4724
tree22e432213ee341d2f8e113ab393aa89b5451a129
parent60ca05c3b44566b70d64fbb8e87a6e0c67725468
docs: tidy up TOCs and refs to license-rules.rst

The documentation and TOCs are organized in a manner of a tree. Adding a TOC to
the root, which refers to a file which is located in a subfolder forms a
grid. Those TOCs are a bit confusing and thats why we get additional error
messages while building partial documentation::

  $ make SPHINXDIRS=process htmldocs
  ...
  checking consistency... Documentation/process/license-rules.rst: \
  WARNING: document isn't included in any toctree

To fix it, the *root-license-TOC* is replaced by a reference and the
'license-roles.txt' is added to the Documentation/process/index.rst TOC.

BTW: there was an old licences remark in Documentation/process/howto.rst which
is also updated, mentioning SPDX and pointing to the license-rules.rst

Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/index.rst
Documentation/process/howto.rst
Documentation/process/index.rst
Documentation/process/license-rules.rst