All of lore.kernel.org
 help / color / mirror / Atom feed
From: karel Zak <kzak@redhat.com>
To: JWP <elseifthen@gmx.com>
Cc: Benno Schulenberg <bensberg@justemail.net>,
	Util-Linux <util-linux@vger.kernel.org>
Subject: Re: [PATCH 2/4] docs: mention that setarch may not be able to set all listed architectures
Date: Mon, 12 Jan 2015 11:41:11 +0100	[thread overview]
Message-ID: <20150112104111.GE20899@x2.net.home> (raw)
In-Reply-To: <54B2C449.8010206@gmx.com>

On Sun, Jan 11, 2015 at 01:43:21PM -0500, JWP wrote:
> On 01/11/2015 12:07 PM, Benno Schulenberg wrote:
> > 
> > On Sun, Jan 11, 2015, at 17:19, JWP wrote:
> >> On 01/10/2015 08:41 AM, Benno Schulenberg wrote:
> >>> -\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.
> > 
> > You are right.  However, on a terminal both hyphen and minus sign render
> > to 0x2d.  When printed, the characters are rendered differently, and then
> > I prefer to see a tiny hyphen instead of a minus sign in hyphenated options.
> > And since you cannot copy and paste from a printed document, it doesn't
> > matter that the more readable hyphen is used instead of the correct minus
> > sign.
> 
> The world is going paperless, favoring print manuals over online is going the
> wrong direction. Just because it uses the same glyph on your terminal does not
> mean the same will be true for every application that renders a man-page.
> 
> However, the more important point is not what glyph is printed, but how troff 
> formats a hyphen vs a minus sign. We do not want line breaks made mid: command,

 For me is important to use in man pages the same option names (same
 chars) like we have in source code where I see 0x2d, and I'd like
 like to minimize variability in the man pages, it's better to be
 consistent than be perfect.

    Karel

-- 
 Karel Zak  <kzak@redhat.com>
 http://karelzak.blogspot.com

  reply	other threads:[~2015-01-12 10:41 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2015-01-10 13:41 [PATCH 1/4] setarch: differentiate between "unrecognized" and "cannot set" Benno Schulenberg
2015-01-10 13:41 ` [PATCH 2/4] docs: mention that setarch may not be able to set all listed architectures Benno Schulenberg
2015-01-11 16:19   ` JWP
2015-01-11 17:07     ` Benno Schulenberg
2015-01-11 18:43       ` JWP
2015-01-12 10:41         ` karel Zak [this message]
2015-01-12 11:23   ` Karel Zak
2015-01-10 13:41 ` [PATCH 3/4] setarch: accept the option --list in any position Benno Schulenberg
2015-01-12 11:25   ` Karel Zak
2015-01-10 13:41 ` [PATCH 4/4] setarch: in the usage text only mention options that actually do something Benno Schulenberg
2015-01-12 11:33   ` Karel Zak
2015-01-12 11:23 ` [PATCH 1/4] setarch: differentiate between "unrecognized" and "cannot set" Karel Zak

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20150112104111.GE20899@x2.net.home \
    --to=kzak@redhat.com \
    --cc=bensberg@justemail.net \
    --cc=elseifthen@gmx.com \
    --cc=util-linux@vger.kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.