Skip to content

improve manpages#2098

Open
omar-polo wants to merge 8 commits intomainfrom
op/more-man
Open

improve manpages#2098
omar-polo wants to merge 8 commits intomainfrom
op/more-man

Conversation

@omar-polo
Copy link
Copy Markdown
Contributor

this does:

  • syncs manpages with actual usages
  • fixes some minor nits
  • use a consistent EXIT STATUS across manpages (DIAGNOSTICS is for error messages, not for exit status)

and also to split the command listing in plakar.1 into sections. Please review that part carefully. Some choices could be disagreaable. for example, I've put "prune" under kloset commands, while "rm" is in snapshots, but this because I thought that rm is more (intuitively speaking) around snapshots, while I see prune more as a sort of GC. I'm open to changes.

@omar-polo omar-polo force-pushed the op/more-man branch 4 times, most recently from f3866c8 to 5edc19b Compare May 6, 2026 07:11
Copy link
Copy Markdown
Contributor

@mathieu-plak mathieu-plak left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for that! One nit in comment. Also currious about create-token, did it ever work ?

Comment thread plakar.1
.Ar number .
By default it's the number of online CPUs.
.It Fl json
Use newline-delimited JSON as output format for some subcommands.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why some? It was plugged as an event listener so it should turn all output into json IIRC?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants