Re: [PATCH 2/4] docs: mention that setarch may not be able to set all listed architectures

[JWP <elseifthen@gmx.com>]

On 01/10/2015 08:41 AM, Benno Schulenberg wrote:
> Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
> ---
>  sys-utils/setarch.8 |    9 +++++----
>  1 files changed, 5 insertions(+), 4 deletions(-)
> 
> diff --git a/sys-utils/setarch.8 b/sys-utils/setarch.8
> index a9a126a..d0f1cba 100644
> --- a/sys-utils/setarch.8
> +++ b/sys-utils/setarch.8
> @@ -24,11 +24,12 @@ It also allows to set various personality options.
>  The default \fIprogram\fR is \fB/bin/sh\fR.
>  .SH OPTIONS
>  .TP
> -\fB\-\-list\fR
> -List the architectures that can be set.
> +.B \-\-list
> +List the architectures that \fBsetarch\fR knows about.  Whether \fBsetarch\fR
> +can actually set each of these architectures depends on the running kernel.
>  .TP
> -\fB\-\-uname\-2.6\fR
> -Causes the program to see a kernel version number beginning with 2.6.
> +.B \-\-uname-2.6

This is incorrect. Options are always constructed with minus signs never a hyphens.
The only time a hyphen should be used in man-pages is for normally hyphenated 
dictionary words. Commands, options, variables, paths, urls, etc. all use the
minus sign character. For troff that is \-.

groff(7)
       \-     The - (minus) sign in the current font.


> +Causes the \fIprogram\fR to see a kernel version number beginning with 2.6.
>  .TP
>  .BR \-v , " \-\-verbose"
>  Be verbose.
>