Re: [PATCH 2/2] swapon: rename the new --annotation option to --annotate

Christian Albrecht Goeschel Ndjomouo <[email protected]> Mon, 6 Oct 2025 02:02:55 +0000
Newsgroups org.kernel.vger.util-linux
Message-ID <SJ0P220MB05411D798786BF09146DF3A8E9E3A@SJ0P220MB0541.NAMP220.PROD.OUTLOOK.COM>
> The form --annotation gave the impression that after the subsequent
> "=" comes the text that each column name should be annotated with.
> Furthermore, the other two options with optional arguments (--show
> and --discard) are in the imperative, so follow that style and use
> --annotate instead.

I prefer this name, it is more intuitive.

FYI, I added your patches to my pull request* on Github and for completeness I renamed
man-common/annotation.adoc to annotate.adoc and adapted the name of some
variables for clarity.

* https://github.com/util-linux/util-linux/pull/3782/

Christian Goeschel Ndjomouo
B.Sc. Software Engineering
Western Governors University