On Wed, Dec 05 2018, Jonathan Corbet wrote:

On Wed, 05 Dec 2018 10:02:51 +1100
NeilBrown [off-list ref] wrote:

quoted

This allows the document to be integrated with the main documentation
tree.
Changes include:
- rename from .md to .rst
- use `` for code, not single `
- use correct sub-section marking
- fix indented blocks, both code and non-code
- fix external-link markup

Signed-off-by: NeilBrown <redacted>

Looks good at a first glance, but I have one question...

quoted

 Documentation/filesystems/index.rst                |   2 +
 .../{path-lookup.md => path-lookup.rst}            | 875 +++++++++++----------
 2 files changed, 448 insertions(+), 429 deletions(-)
 rename Documentation/filesystems/{path-lookup.md => path-lookup.rst} (59%)

diff --git a/Documentation/filesystems/index.rst b/Documentation/filesystems/index.rst
index 46d1b1be3a51..3c0f441a9536 100644
--- a/Documentation/filesystems/index.rst
+++ b/Documentation/filesystems/index.rst

@@ -359,3 +359,5 @@ encryption of files and directories.
     :maxdepth: 2
 
     fscrypt
+
+.. include::  path-lookup.rst

Is there a reason you used "include" rather than just adding it to the
TOC tree with the rest?

Simple.  I didn't know what I was doing, and so randomly made changes until
the result seemed acceptable - then I stopped.  If there is a better
way, feel free to tweak that when applying.

Thanks,
NeilBrown