aura -Bc <states-to-retain> not working?

[xfzv]

aura/misc/aura.8

Lines 431 to 438 in 3aae462

	.SH GLOBAL PACKAGE STATE OPTIONS (\fR\-B\fP)
	.
	.TP
	.BR \-c ", " \-\-clean \c
	.I " states-to-retain "
	.
	Retains a given number of the most recently saved package states and removes the
	rest.

% aura -Bl
/home/xfzv/.cache/aura/snapshots/2024.08(Aug).13.21.05.46.json
/home/xfzv/.cache/aura/snapshots/2024.08(Aug).14.08.54.52.json
/home/xfzv/.cache/aura/snapshots/2024.08(Aug).14.09.08.17.json
/home/xfzv/.cache/aura/snapshots/2024.08(Aug).14.15.31.05.json
/home/xfzv/.cache/aura/snapshots/2024.08(Aug).15.05.12.17.json
/home/xfzv/.cache/aura/snapshots/2024.08(Aug).15.08.09.15.json
/home/xfzv/.cache/aura/snapshots/2024.08(Aug).15.11.41.32.json
/home/xfzv/.cache/aura/snapshots/2024.08(Aug).15.16.45.46.json
/home/xfzv/.cache/aura/snapshots/2024.08(Aug).15.19.14.13.json
/home/xfzv/.cache/aura/snapshots/2024.08(Aug).15.21.09.50.json
/home/xfzv/.cache/aura/snapshots/2024.08(Aug).15.22.10.22.json
/home/xfzv/.cache/aura/snapshots/2024.08(Aug).16.07.31.39.json
/home/xfzv/.cache/aura/snapshots/2024.08(Aug).16.11.34.59.json
/home/xfzv/.cache/aura/snapshots/2024.08(Aug).16.14.48.10.json
/home/xfzv/.cache/aura/snapshots/2024.08(Aug).16.17.00.43.json
/home/xfzv/.cache/aura/snapshots/2024.08(Aug).16.17.00.54.json

% aura -Br
aura :: Select a snapshot to restore:
 0) 2024-08-15 21-09-50
 1) 2024-08-15 22-10-22
 2) 2024-08-16 07-31-39
 3) 2024-08-16 11-34-59
 4) 2024-08-16 14-48-10
 5) 2024-08-16 17-00-43
 6) 2024-08-16 17-00-54

% aura -Bc 4
error: unexpected argument '4' found

Usage: aura {backup|--backup|-B} [OPTIONS]

For more information, try '--help'.

The Aura User Guide doesn't mention states-to-retain though.

aura -Bc works as expected to delete "stale" snapshots.

Am I missing something? Maybe this section of the man page is no longer relevant?

[fosskers]

Here's the output from -Bh:

Options:
  -c, --clean              Remove all snapshots without matching tarballs in the cache

And the corresponding flag in Rust:

    /// Remove all snapshots without matching tarballs in the cache.
    #[clap(group = "backup", long, short, display_order = 1)]
    pub clean: bool,

So the manpage must be out of date. Thanks for finding this. It looks like the Guide and info aura are correct, though.

In future, please open an Issue for things like this, and not a Discussion. Discussion are a bit harder to manage as bug reports. Thanks!

[fosskers]

Fixed.