X-Git-Url: http://git.tuebingen.mpg.de/?a=blobdiff_plain;f=dss.suite;h=2719827700a33809b8bf2714f58518b550c4a104;hb=d4d72473957544283b6d426c3d4fa0b3f583da87;hp=16c7e58542eff8750c8437dcea137f347a435950;hpb=e3f9c1dcc861be14fc9a3f33057a905047e9a926;p=dss.git

diff --git a/dss.suite b/dss.suite
index 16c7e58..2719827 100644
--- a/dss.suite
+++ b/dss.suite
@@ -450,18 +450,21 @@ caption = Subcommands
 		snapshots.
 	[/description]
 [subcommand prune]
-	purpose = remove redundant and outdated snapshots
+	purpose = remove snapshots
 	[description]
-		A snapshot is considered outdated if its interval number is greater or
-		equal than the specified number of unit intervals. See --unit-interval
-		and --num-intervals above.
-
-		A snapshot is said to be redundant if the interval it belongs to
-		contains more than the configured number of snapshots.
-
-		The prune command gets rid of both outdated and redundant snapshots. At
-		most one snapshot is removed per invocation. If --dry-run is given, the
-		subcommand only prints the snapshot that would be removed.
+		A snapshot is said to be (a) outdated if its interval number is greater
+		or equal than the specified number of unit intervals, (b) redundant if
+		the interval it belongs to contains more than the configured number of
+		snapshots, and (c) orphaned if it is incomplete and not being created
+		or deleted. All other snapshots are called regular.
+
+		Unless --dry-run is given, which just prints the snapshot that would be
+		removed, this subcommand gets rid of non-regular snapshots.  At most
+		one snapshot is removed per invocation. If no such snapshot exists
+		and disk space is low, the subcommand also removes regular snapshots,
+		always picking the oldest one.
+
+		The subcommand fails if there is another dss "run" process.
 	[/description]
 [subcommand ls]
 	purpose = print the list of all snapshots