X-Recipient: archive-cygwin AT delorie DOT com
DomainKey-Signature: a=rsa-sha1; c=nofws; d=sourceware.org; h=list-id
	:list-unsubscribe:list-subscribe:list-archive:list-post
	:list-help:sender:date:from:reply-to:message-id:to:subject
	:in-reply-to:references:mime-version:content-type
	:content-transfer-encoding; q=dns; s=default; b=LNBHF2b91LFPA/EU
	j28LbnjjNzxtnTFNugaHubHm4sxN74h3SbwdHaZ1WRTAWRvVjNltBQ/NrsN1Imhe
	7ey+qE9ZaBxpE1RdPB8BolRLrtIpV7NszUz5EGA6/GunOq4FU4VWR1y8GYcCt7TG
	dEV9E9M8FW8BeJURDUSc8QuR5eE=
DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=sourceware.org; h=list-id
	:list-unsubscribe:list-subscribe:list-archive:list-post
	:list-help:sender:date:from:reply-to:message-id:to:subject
	:in-reply-to:references:mime-version:content-type
	:content-transfer-encoding; s=default; bh=4Y8xZt2EqWfkcSWL5j4oZr
	NxS2g=; b=epnQK8+XAbakXYbwnpnNDEes/SKNDpsiD6Pyzex5zdWhb+5cghGI1B
	BuE0uoj9zQxWe+sLw4abnIutu38jaYnJX+ywR5TvByioruq/nHSAqrTq9P+9CInI
	cdVlQT/JqY2eGdVGNSANknicFB1zKkRBWs4yk4XXvNYBoBayPPP0c=
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Id: <cygwin.cygwin.com>
List-Subscribe: <mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive: <http://sourceware.org/ml/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-help AT cygwin DOT com>, <http://sourceware.org/ml/#faqs>
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
Delivered-To: mailing list cygwin AT cygwin DOT com
Authentication-Results: sourceware.org; auth=none
X-Virus-Found: No
X-Spam-SWARE-Status: No, score=3.8 required=5.0 tests=AWL,BAYES_50,FREEMAIL_FROM,KAM_THEBAT,SPF_SOFTFAIL autolearn=no version=3.3.2
X-HELO: smtpback.ht-systems.ru
Date: Wed, 6 Aug 2014 23:57:25 +0400
From: Andrey Repin <anrdaemon AT yandex DOT ru>
Reply-To: cygwin AT cygwin DOT com
Message-ID: <613520457.20140806235725@yandex.ru>
To: Corinna Vinschen <cygwin AT cygwin DOT com>
Subject: Re: cannot display man page for /bin/passwd
In-Reply-To: <20140806193059.GO13601@calimero.vinschen.de>
References: <CAJ1FpuPVvp89xTW4xVH1VpLFYg0Wgr8FNB9OsDYh=hubgsZnDQ AT mail DOT gmail DOT com> <20140805082102 DOT GD2868 AT calimero DOT vinschen DOT de> <224522274 DOT 20140806212115 AT yandex DOT ru> <20140806193059 DOT GO13601 AT calimero DOT vinschen DOT de>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-IsSubscribed: yes

Greetings, Corinna Vinschen!

>> >> When I try to display the man page for /bin/passwd, the man page for
>> >> the openssl passwd subcommand is displayed.
>> >> 
>> >> It appears that both the package containing /bin/passwd, and the
>> >> openssl package place the passwd.1.gz file in the /usr/share/man/man1
>> >> directory, so that only the man page from the most recently installed
>> >> package is displayed.
>> 
>> > No, the Cygwin passwd tool has no man page.
>> 
>> That's sad. Can we change it?

> Would you like to take over maintainance of the cygwin-doc package?
> It's orphaned and in desperate need of an active maintainer.

That's tempting. I'll think about it. It doesn't involve deep knowledge in
the C language, I assume? (Which I'm lacking.)

>> Also, the paragraph "All operations affecting the current user" is missing a
>> "$" sign in reference to environment variable LOGONSERVER.

> No, that's deliberate at this point.

If we are to think about it as actual Windows environment variable being
propagated to affect Cygwin processes, it makes sense.
I'll amend the man page in this regard.

>> The phrase "to enter a password which" is probably missing a comma.

> Hmm, not sure.  The English language is pretty lazy in terms of
> punctuation characters.

Uhhu...

>> Slightly unrelated question. I've noticed, that if a paragraph in source file
>> have line break after a period, the page is rendered with two spaces between
>> a period and first letter of next sentence, even though there's only one
>> character (a linefeed) exists. No stray spaces, no CR's. Is this intended?

> Yes, for the English language.  See
> http://en.wikipedia.org/wiki/History_of_sentence_spacing#French_and_English_spacing

Thanks. It was looked deliberate, judging from reproducibility on a number of
available systems, was just unsure, why.
Should probably follow locale settings, though... And it looks weird on
fixed-width terminal, especially if you are using pretty-printing font (with
most of punctuation shifted to the left). Looks almost like there's 3 spaces
between sentences.


--
WBR,
Andrey Repin (anrdaemon AT yandex DOT ru) 06.08.2014, <23:46>

Sorry for my terrible english...


--
Problem reports:       http://cygwin.com/problems.html
FAQ:                   http://cygwin.com/faq/
Documentation:         http://cygwin.com/docs.html
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple