ref: 8f4053d1efa1ee75a7bea09e624f1134d71a289a
parent: 581e6909b026205ed77caae27bae68baeecc59a3
author: Ori Bernstein <ori@eigenstate.org>
date: Sat Feb 15 13:25:30 EST 2025
gefs(8): clarify and fix description of snapshot commands
--- a/sys/man/8/gefs
+++ b/sys/man/8/gefs
@@ -96,25 +96,37 @@
[
.B -flags
]
-.IR "old new" ,
+.IR "[[old] new]" ,
which will list, delete, or create new snapshots respectively.
+By default, the
+.I snap
+command creates a snapshot of
+.IR old ,
+tagging it with the name
+.IR new .
It accepts the following options:
.TP
.B -l
Lists snapshots and their attributes.
+This flag accepts no arguments.
.TP
.BI "-d " snap
Deletes a snapshot, reclaiming whatever space is not shared
is not shared with other snapshots.
+This flag accepts a single argument,
+.IR old ,
+as the partition to delete.
.TP
.B -m
-Flags that the newly created snapshot should be mutable.
+Marks the newly created snapshot as mutable,
+rather than read-only.
+This flag only has an effect when tagging a new snapshot,
+and is ignored otherwise.
.TP
.B -S
-Disables automatic snapshots.
-.I old
-and gives it the name
-.IR new .
+Disables automatic timed snapshots.
+This flag only has an effect when tagging a new snapshot,
+and is ignored otherwise.
.PP
.I Sync
writes dirty blocks in memory to the disk.
--
⑨