doc: Document 'mount-may-fail?' field.
authorLudovic Courtès <ludo@gnu.org>
Mon, 3 Aug 2020 15:14:54 +0000 (17:14 +0200)
committerLudovic Courtès <ludo@gnu.org>
Mon, 3 Aug 2020 15:14:54 +0000 (17:14 +0200)
This is a followup to 7c27bd115b14afd142da7684cc349369965f9eab.

* doc/guix.texi (File Systems): Document 'mount-may-fail?'.

doc/guix.texi

index f9cb7f2..0c8c284 100644 (file)
@@ -12165,6 +12165,12 @@ errors before being mounted.
 @item @code{create-mount-point?} (default: @code{#f})
 When true, the mount point is created if it does not exist yet.
 
+@item @code{mount-may-fail?} (default: @code{#f})
+When true, this indicates that mounting this file system can fail but
+that should not be considered an error.  This is useful in unusual
+cases; an example of this is @code{efivarfs}, a file system that can
+only be mounted on EFI/UEFI systems.
+
 @item @code{dependencies} (default: @code{'()})
 This is a list of @code{<file-system>} or @code{<mapped-device>} objects
 representing file systems that must be mounted or mapped devices that