From 6c2e14a43a86258204e19fe5cbac4a77374bab3f Mon Sep 17 00:00:00 2001 From: Tobias Geerinckx-Rice Date: Sun, 14 Aug 2022 02:00:00 +0200 Subject: 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 -- cgit v1.2.3