Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
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
From: "Dave Korn" <dk AT artimi DOT com>
To: <cygwin AT cygwin DOT com>
Subject: RE: ssmtp man page (Was: Re: sending email from Cygwin)
Date: Sun, 18 Jul 2004 13:43:18 +0100
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
In-reply-to: <Pine.GSO.4.58.0407161505430.10869@slinky.cs.nyu.edu>
Message-ID: <NUTMEG5yrFVq9GNSQn60000090c@NUTMEG.CAM.ARTIMI.COM>
X-OriginalArrivalTime: 18 Jul 2004 12:43:18.0453 (UTC) FILETIME=[CD279650:01C46CC4]

> -----Original Message-----
> From: cygwin-owner On Behalf Of Igor Pechtchanski
> Sent: 16 July 2004 20:12

> > > This is a usability issue.  It's hard enough to teach 
> people to type:
> > >
> > > 	man <command-name>
> > >
> > > teaching them to type:
> > >
> > > 	more /usr/share/doc/Cygwin/ssmtp-0.x.y/README.ssmtp-0.x.y
> >
> > Don't make it overly complicated.  `less 
> /usr/share/doc/Cygwin/ssmtp*'
> > is enough.  And telling people that /usr/share/doc/Cygwin contains
> > Cygwin specific README files isn't that hard, really.
> >
> > Corinna
> 
> Yep, nice choice of words here. *Telling* them is definitely not hard.
> Getting them to do it before sending questions to the list is. :-)
> 
> Actually, there's an interesting point in this thread.  Would 
> it be a good
> idea to have a reference to the Cygwin-specific README in the 
> manpages for
> every Cygwin package that has one (say, in the SEE ALSO 
> section)? 

> Another possible place to mention the Cygwin-specific READMEs 
> is in the "man cygwin" page. :-)

  Another possibility would be for the very last dialog in setup.exe, the
one that says "download/install complete", to also say in very big letters
"For Cygwin-specific documentation, see /usr/share/doc/Cygwin".  It could
maybe even have a tickbox to automatically open that window in explorer...


    cheers, 
      DaveK
-- 
Can't think of a witty .sigline today....


--
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/