• Markus Heiser's avatar
    docs: tidy up TOCs and refs to license-rules.rst · 9799445a
    Markus Heiser authored
    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: default avatarMarkus Heiser <markus.heiser@darmarit.de>
    Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
    9799445a
howto.rst 27.1 KB