03/03: doc: Note the pitfalls of man 8 mount.

[guix-commits]

nckx pushed a commit to branch master
in repository guix.

commit 6c2e14a43a86258204e19fe5cbac4a77374bab3f
Author: Tobias Geerinckx-Rice <me@tobias.gr>
AuthorDate: Sun Aug 14 02:00:00 2022 +0200

    doc: Note the pitfalls of man 8 mount.
    
    * doc/guix.texi (File Systems): Warn against flags presented as options.
---
 doc/guix.texi | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 64adafd3f9..b8b1b9ad7c 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -16430,8 +16430,11 @@ Manual}, for more information on these flags.
 @item @code{options} (default: @code{#f})
 This is either @code{#f}, or a string denoting mount options passed to
 the file system driver.  @xref{Mount-Unmount-Remount,,, libc, The GNU C
-Library Reference Manual}, for details and run @command{man 8 mount} for
-options for various file systems.
+Library Reference Manual}, for details.
+
+Run @command{man 8 mount} for options for various file systems, but
+beware that what it lists as file-system-independent ``mount options'' are
+in fact flags, and belong in the @code{flags} field described above.
 
 The @code{file-system-options->alist} and @code{alist->file-system-options}
 procedures from @code{(gnu system file-systems)} can be used to convert