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

- Raw text -