And remove inconsistent uses of double asterisks too. Signed-off-by: Benno Schulenberg <bensberg@xxxxxxxxxx> --- login-utils/lslogins.1.adoc | 4 ++-- login-utils/su.1.adoc | 10 +++++----- sys-utils/mount.8.adoc | 2 +- sys-utils/wdctl.8.adoc | 2 +- 4 files changed, 9 insertions(+), 9 deletions(-) diff --git a/login-utils/lslogins.1.adoc b/login-utils/lslogins.1.adoc index 6371c2d00..4aeef7cf8 100644 --- a/login-utils/lslogins.1.adoc +++ b/login-utils/lslogins.1.adoc @@ -46,7 +46,7 @@ Display data about the users' last failed login attempts. *-G*, *--supp-groups*:: Show information about supplementary groups. -*-g*, **--groups**=_groups_:: +*-g*, *--groups* _groups_:: Only show data of users belonging to _groups_. More than one group may be specified; the list has to be comma-separated. Unknown group names are ignored. + Note that the relation between user and group may be invisible for the primary group if the user is not explicitly specified as group member (e.g., in _/etc/group_). If the command *lslogins* scans for groups then it uses the groups database only, and the user database with primary GID is not used at all. @@ -54,7 +54,7 @@ Note that the relation between user and group may be invisible for the primary g *-L*, *--last*:: Display data containing information about the users' last login sessions. -*-l*, **--logins**=_logins_:: +*-l*, *--logins* _logins_:: Only show data of users with a login specified in _logins_ (user names or user IDs). More than one login may be specified; the list has to be comma-separated. Unknown login names are ignored. *-n*, *--newline*:: diff --git a/login-utils/su.1.adoc b/login-utils/su.1.adoc index 33f45833f..866139755 100644 --- a/login-utils/su.1.adoc +++ b/login-utils/su.1.adoc @@ -33,16 +33,16 @@ Since version 2.38 *su* resets process resource limits RLIMIT_NICE, RLIMIT_RTPRI == OPTIONS -*-c*, **--command**=__command__:: +*-c*, *--command* __command__:: Pass _command_ to the shell with the *-c* option. *-f*, *--fast*:: Pass *-f* to the shell, which may or may not be useful, depending on the shell. -*-g*, **--group**=__group__:: +*-g*, *--group* __group__:: Specify the primary group. This option is available to the root user only. -*-G*, **--supp-group**=__group__:: +*-G*, *--supp-group* __group__:: Specify a supplementary group. This option is available to the root user only. The first specified supplementary group is also used as a primary group if the option *--group* is not specified. *-*, *-l*, *--login*:: @@ -68,7 +68,7 @@ Create a pseudo-terminal for the session. The independent terminal provides bett + This feature is mostly designed for interactive sessions. If the standard input is not a terminal, but for example a pipe (e.g., *echo "date" | su --pty*), then the *ECHO* flag for the pseudo-terminal is disabled to avoid messy output. -*-s*, **--shell**=__shell__:: +*-s*, *--shell* __shell__:: Run the specified _shell_ instead of the default. If the target user has a restricted shell (i.e., not listed in _/etc/shells_), the *--shell* option and the *SHELL* environment variables are ignored unless the calling user is root. + The shell to run is selected according to the following rules, in order: @@ -85,7 +85,7 @@ Same as *-c*, but do not create a new session. (Discouraged.) Do not create a pseudo-terminal, opposite of *--pty* and *-P*. Note that running without a pseudo-terminal opens the security risk of privilege escalation through TIOCSTI/TIOCLINUX ioctl command injection. -*-w*, **--whitelist-environment**=__list__:: +*-w*, *--whitelist-environment* __list__:: Don't reset the environment variables specified in the comma-separated _list_ when clearing the environment for *--login*. The whitelist is ignored for the environment variables *HOME*, *SHELL*, *USER*, *LOGNAME*, and *PATH*. include::man-common/help-version.adoc[] diff --git a/sys-utils/mount.8.adoc b/sys-utils/mount.8.adoc index 92ff15dfb..08a2e731c 100644 --- a/sys-utils/mount.8.adoc +++ b/sys-utils/mount.8.adoc @@ -345,7 +345,7 @@ Add the labels in the mount output. *mount* must have permission to read the dis *-M*, *--move*:: Move a subtree to some other place. See above, the subsection *The move operation*. -*-m*, **--mkdir**[=__mode__]:: +*-m*, *--mkdir*[**=**__mode__]:: Allow to make a target directory (mountpoint) if it does not exist yet. Alias to "-o X-mount.mkdir[=mode]", the default mode is 0755. For more details see *X-mount.mkdir* below. *--map-groups*, *--map-users* _inner_:_outer_:_count_:: diff --git a/sys-utils/wdctl.8.adoc b/sys-utils/wdctl.8.adoc index 6eb44e5d8..5fec3584e 100644 --- a/sys-utils/wdctl.8.adoc +++ b/sys-utils/wdctl.8.adoc @@ -46,7 +46,7 @@ Print all wanted information on one line in key="value" output format. Set the watchdog pre-timeout in seconds. A watchdog pre-timeout is a notification generated by the watchdog before the watchdog reset might occur in the event the watchdog has not been serviced. This notification is handled by -the kernel and can be configured to take an action using sysfs or by **--setpregovernor**. +the kernel and can be configured to take an action using sysfs or by *--setpregovernor*. *-g*, *--setpregovernor* _governor_:: Set pre-timeout governor name. For available governors see default **wdctl** output. -- 2.48.1
