This is the mail archive of the cygwin mailing list for the Cygwin project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

RE: ssmtp man page (Was: Re: sending email from Cygwin)


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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]