Skip to content

Document the --user/-U option in manpage#1021

Open
rapidcow wants to merge 1 commit into
OpenRC:masterfrom
rapidcow:document-user-option
Open

Document the --user/-U option in manpage#1021
rapidcow wants to merge 1 commit into
OpenRC:masterfrom
rapidcow:document-user-option

Conversation

@rapidcow

@rapidcow rapidcow commented Jun 6, 2026

Copy link
Copy Markdown

The --user/-U option used for user services appears absent from all section 8 manual pages, while it is present in the --help message:

$ rc-service --help | grep U
Usage: rc-service [options] [-i] <service> <cmd>...
Options: [ cdDe:ilr:INsSZChqVvU ]
  -U, --user                        Run in user mode

$ openrc --help | grep U
Usage: openrc [options] [<runlevel>]
Options: [ a:no:s:SChqVvU ]
  -U, --user                        Run in user mode

So I figured we should copy this into the manpage, similar to the methodology taken in #378...

Though because -U is a common option like -ChqVv, I added it to openrc(8) where the latter five options are already documented. I placed it at the end which is consistent with the order of getoptstring_COMMON and the --help message.

The --user/-U option was added as a common option in
commit 1cd54c2 but is absent from all manual pages.
Add it to openrc(8) since that is where other common
options [-ChqVv] live.

Signed-off-by: Ethan Meng <ethan@rapidcow.org>
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.

1 participant