doc: Note the pitfalls of man 8 mount.

* doc/guix.texi (File Systems): Warn against flags presented as options.

1 files 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