Merge branch 'mauro' into docs-next
authorJonathan Corbet <corbet@lwn.net>
Thu, 17 Jun 2021 19:25:34 +0000 (13:25 -0600)
committerJonathan Corbet <corbet@lwn.net>
Thu, 17 Jun 2021 19:25:34 +0000 (13:25 -0600)
commit257e65246259e3a85968bcd5b86e045a94e60db3
tree1ffdd2abbb6949e4a1d8e4827cabede594bd228a
parenta557f67cd70344bf28442baac4c9b6c94aecb60b
parent0ffd643875d3f7dac3cd9fbc637a3645c48ba21f
Merge branch 'mauro' into docs-next

Mauro says:

> As discussed at:
>  https://lore.kernel.org/linux-doc/871r9k6rmy.fsf@meer.lwn.net/
>
> It is better to avoid using :doc:`foo` to refer to Documentation/foo.rst, as the
> automarkup.py extension should handle it automatically, on most cases.
>
> There are a couple of exceptions to this rule:
>
> 1. when :doc:  tag is used to point to a kernel-doc DOC: markup;
> 2. when it is used with a named tag, e. g. :doc:`some name <foo>`;
>
> On this series:
>
> Patch 1 manually adjust the references inside driver-api/pm/devices.rst,
> as there it uses :file:`foo` to refer to some Documentation/ files;
>
> Patch 2 converts a table at Documentation/dev-tools/kunit/api/index.rst
> into a list, carefully avoiding the
>
> The remaining patches convert the other occurrences via a replace script.
> They were manually edited, in order to honour 80-columns where possible.
>
> This series based on docs-next branch. In order to avoid merge conflicts,
> I rebased it internally against yesterday's linux-next, dropping a patch
> and a hunk that would have caused conflicts there.
>