Skip to contentSkip to conversation

Documentation: clean up warnings for multigrain timestamp docs

PATCH Applied Jeff Layton 2 participants 3 messages Aug 1, 2024

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Documentation: clean up warnings for multigrain timestamp docs

Stephen Rothwell reported seeing a couple of warnings when building htmldocs:

/home/jlayton/git/linux/Documentation/filesystems/multigrain-ts.rst:83: WARNING: duplicate label filesystems/multigrain-ts:multigrain timestamps, other instance in /home/jlayton/git/linux/Documentation/filesystems/multigrain-ts.rst /home/jlayton/git/linux/Documentation/filesystems/multigrain-ts.rst: WARNING: document isn't included in any toctree

---
 Documentation/filesystems/index.rst         | 1 +
 Documentation/filesystems/multigrain-ts.rst | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

Christian,

It may be best to fold this patch into f9cb86069bad (Documentation: add a new file documenting multigrain timestamps)

Documentation/filesystems/index.rst +1 -0
index e8e496d23e1d..44e9e77ffe0d 100644
@@ -29,6 +29,7 @@ algorithms work.
    fiemap
    files
    locks
+   multigrain-ts
    mount_api
    quota
    seq_file
Documentation/filesystems/multigrain-ts.rst +2 -2
index f58c14c53b0f..97877ab3d933 100644
@@ -79,8 +79,8 @@ is no such guarantee, and the second file may appear to have been modified
 before, after or at the same time as the first, regardless of which one was
 submitted first.
 
-Multigrain Timestamps
-=====================
+Multigrain Timestamp Implementation
+===================================
 Multigrain timestamps are aimed at ensuring that changes to a single file are
 always recognizable, without violating the ordering guarantees when multiple
 different files are modified. This affects the mtime and the ctime, but the
Signature · 1 line
2.45.2
maintainer Applied
#1 lore raw
Quoted 8 lines · Jeff Layton

Stephen Rothwell reported seeing a couple of warnings when building htmldocs:

/home/jlayton/git/linux/Documentation/filesystems/multigrain-ts.rst:83: WARNING: duplicate label filesystems/multigrain-ts:multigrain timestamps, other instance in /home/jlayton/git/linux/Documentation/filesystems/multigrain-ts.rst /home/jlayton/git/linux/Documentation/filesystems/multigrain-ts.rst: WARNING: document isn't included in any toctree

[...]

Applied to the mgtime branch of the vfs/vfs.git tree. Patches in the mgtime branch should appear in linux-next soon.

Please report any outstanding bugs that were missed during review in a new review to the original patch series allowing us to drop it.

It's encouraged to provide Acked-bys and Reviewed-bys even though the patch has now been applied. If possible patch trailers will be updated.

Note that commit hashes shown below are subject to change due to rebase, trailer updates or similar. If in doubt, please check the listed branch.

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/vfs/vfs.git
branch: mgtime

[1/1] Documentation: clean up warnings for multigrain timestamp docs

      https://git.kernel.org/vfs/vfs/c/d48cd6da24a9