X-Recipient: archive-cygwin AT delorie DOT com
X-SWARE-Spam-Status: No, hits=-1.9 required=5.0 	tests=AWL,BAYES_00,SPF_PASS
X-Spam-Check-By: sourceware.org
Content-class: urn:content-classes:message
MIME-Version: 1.0
Content-Type: text/plain; 	charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
Subject: RE: 'man' page for 'mintty' for review
Date: Mon, 9 Feb 2009 08:13:33 -0000
Message-ID: <5E25AF06EFB9EA4A87C19BC98F5C8753027DCD79@core-email.int.ascribe.com>
In-Reply-To: <498B4263.90802@veritech.com>
References: <498B4263 DOT 90802 AT veritech DOT com>
From: "Phil Betts" <Phil DOT Betts AT ascribe DOT com>
To: <cygwin AT cygwin DOT com>
Reply-To: <cygwin AT cygwin DOT com>
X-IsSubscribed: yes
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
Precedence: bulk
List-Id: <cygwin.cygwin.com>
List-Unsubscribe: <mailto:cygwin-unsubscribe-archive-cygwin=delorie DOT com AT cygwin DOT 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

On Thursday, February 05, 2009 7:48 PM Lee D.Rothstein wrote:

> MinTTY users,
>
> Please, if you would, review the attached 'man' page -- 'mintty.1'.
> Andy Koppe intends to fold it into the 0.3.6 MinTTY release.
>
> Comments, corrections, addtitions to this list, please.

I haven't checked all the details, but most of it seems OK to me.
There are a few points that you may want to consider.

I don't think the man page should contain installation instructions.
If you're reading the man page, mintty is already installed, so the
instructions just get in the way of the more useful information. They
should instead be put in a plain text file in the root of the source
package (and perhaps also in a README in /usr/share/doc/Cygwin).

The reference to the cygwin home directory in the description of the
--config option is potentially confusing (presumably why ('~') is=20
added).  A novice cygwin user might think "cygwin home" referred to=20
/home rather than /home/user or wherever $HOME point.  I think it=20
would be better to refer to "the user's home directory", which would=20
be more consistent with the other references.  Also, the reference to
~ is only applicable within a cygwin shell, so anyone trying to find=20
~/.minttyrc using cmd.exe is liable to be confused.

I think you should change this:

| There is also a discussion forum available at this site.

which is misleading, to something like this:

| There is also a mailing list for discussing Cygwin related issues.=20=20
| See http://cygwin.com/cygwin/lists.html for details.  Please read
| the advice at http://cygwin.com/problems.html before posting a
| problem report.


Phil
--=20

This email has been scanned by Ascribe PLC using Microsoft Antigen for Exch=
ange.

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