Re: ssmtp man page (Was: Re: sending email from cygwin)
On Sun, Jul 18, 2004 at 01:43:18PM +0100, Dave Korn wrote: 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... I think this is a subset of something that's already in the setup.exe wishlist: http://sources.redhat.com/cgi-bin/cvsweb.cgi/setup/README?cvsroot=cygwin-appsrev=2 So, PGA, I'm sure. cgf -- 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/
Re: ssmtp man page (Was: Re: sending email from cygwin) gold star
On Fri, Jul 16, 2004 at 09:53:44PM -0400, Igor Pechtchanski wrote: On Fri, 16 Jul 2004, Christopher Faylor wrote: On Fri, Jul 16, 2004 at 02:25:32PM -0700, Yitzchak Scott-Thoennes wrote: I'm partial to: cygcheck -l ssmtp|fgrep README|xargs less myself. Works for other packages, too. Hey, nice use of tools. Can we get a gold star here for a clever use of utilities? This is something that I'll be using myself in the future. cgf You sure can. Just for the archives, though (not to downplay the original achievement), this will also display any other READMEs contained in the package. Intentional. If you only want the Cygwin-specific one, this incantation might be more appropriate: cygcheck -l ssmtp|grep doc/Cygwin/.*README|xargs less -- 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/
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/
RE: ssmtp man page (Was: Re: sending email from Cygwin)
[EMAIL PROTECTED] wrote: (= Dave K, I believe) 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... I spell it out: THIS IS IRONIC, not personal agression; Oohh, Heaven forbid - THAT would be too easy to see! NOT in line with WJM. /Hannu E K Nevalainen, B.Sc. EE - 59+16.37'N, 17+12.60'E --72-- ** mailing list preference; please keep replies on list ** -- printf(LocalTime: UTC+%02d\n,(DST)? 2:1); -- --END OF MESSAGE-- -- 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/
RE: ssmtp man page (Was: Re: sending email from Cygwin)
At 10:51 AM 7/18/2004, you wrote: [EMAIL PROTECTED] wrote: (= Dave K, I believe) 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... I spell it out: THIS IS IRONIC, not personal agression; Oohh, Heaven forbid - THAT would be too easy to see! NOT in line with WJM. Good point. With this in mind, let's just remove the dialog from setup that says download/install complete. ;-) -- Larry Hall http://www.rfk.com RFK Partners, Inc. (508) 893-9779 - RFK Office 838 Washington Street (508) 893-9889 - FAX Holliston, MA 01746 -- 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/
RE: ssmtp man page (Was: Re: sending email from Cygwin)
-Original Message- From: cygwin-owner On Behalf Of Larry Hall Sent: 18 July 2004 18:13 At 10:51 AM 7/18/2004, you wrote: [EMAIL PROTECTED] wrote: (= Dave K, I believe) 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... I spell it out: THIS IS IRONIC, not personal agression; Oohh, Heaven forbid - THAT would be too easy to see! NOT in line with WJM. Good point. With this in mind, let's just remove the dialog from setup that says download/install complete. ;-) I've had an even better idea! Let's change the font in the package chooser to white on a white background and make everyone *guess* what they're installing! 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/
Re: ssmtp man page (Was: Re: sending email from Cygwin)
On Jul 16 12:01, [EMAIL PROTECTED] wrote: On 15 Jul, Corinna Vinschen wrote: Incidentally is it appropriate to include Cygwin-port-specific information in a man page? Well, from a user perspective it might be cool, but IMHO the original man page shouldn't be changed, unless it's a change which should be send upstream anyway. We have the Cygwin specific documentation in /usr/share/doc/Cygwin (resp. /usr/doc/Cygwin in earlier releases) for a long time now. It should be not too hard to ask users to look there for Cygwin specific docs. Corinna Can you think of a way of incorporating the material in the man page that would be palatable upstream? How do you think people would feel about a section PORTABILITY or NOTES or even WINDOWS or CYGWIN? I have no idea. That's something you would have to ask the upstream maintainer. But the first question is if the Cygwin maintainer likes the idea. The above question is relevant to a patch for the ssmtp man page. If ssmtp uses ssmtp-config on most platforms it works on, then I can just write a patch that includes both fixes. ssmtp-config is a Cygwin specific script. 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 -- Corinna Vinschen Please, send mails regarding Cygwin to Cygwin Co-Project Leader mailto:[EMAIL PROTECTED] Red Hat, Inc. -- 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/
Re: ssmtp man page (Was: Re: sending email from Cygwin)
On Fri, 16 Jul 2004, Corinna Vinschen wrote: On Jul 16 12:01, luke.kendallSPLATcisra.canon.com.au wrote: On 15 Jul, Corinna Vinschen wrote: Incidentally is it appropriate to include Cygwin-port-specific information in a man page? Well, from a user perspective it might be cool, but IMHO the original man page shouldn't be changed, unless it's a change which should be send upstream anyway. We have the Cygwin specific documentation in /usr/share/doc/Cygwin (resp. /usr/doc/Cygwin in earlier releases) for a long time now. It should be not too hard to ask users to look there for Cygwin specific docs. Corinna Can you think of a way of incorporating the material in the man page that would be palatable upstream? How do you think people would feel about a section PORTABILITY or NOTES or even WINDOWS or CYGWIN? I have no idea. That's something you would have to ask the upstream maintainer. But the first question is if the Cygwin maintainer likes the idea. The above question is relevant to a patch for the ssmtp man page. If ssmtp uses ssmtp-config on most platforms it works on, then I can just write a patch that includes both fixes. ssmtp-config is a Cygwin specific script. 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)? I know that most maintainers prefer the upstream manpages in their pristine state, and don't like making the Cygwin-specific patches larger, but this might actually save some bandwidth on the list. Another possible place to mention the Cygwin-specific READMEs is in the man cygwin page. :-) Perhaps this is more appropriate for cygwin-apps now... Igor -- http://cs.nyu.edu/~pechtcha/ |\ _,,,---,,_[EMAIL PROTECTED] ZZZzz /,`.-'`'-. ;-;;,_[EMAIL PROTECTED] |,4- ) )-,_. ,\ ( `'-' Igor Pechtchanski, Ph.D. '---''(_/--' `-'\_) fL a.k.a JaguaR-R-R-r-r-r-.-.-. Meow! I have since come to realize that being between your mentor and his route to the bathroom is a major career booster. -- Patrick Naughton -- 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/
Re: ssmtp man page (Was: Re: sending email from Cygwin)
On Fri, Jul 16, 2004 at 12:01:03PM +1000, luke.kendall wrote: 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 I'm partial to: cygcheck -l ssmtp|fgrep README|xargs less myself. Works for other packages, too. -- 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/
Re: ssmtp man page (Was: Re: sending email from cygwin) gold star
On Fri, Jul 16, 2004 at 02:25:32PM -0700, Yitzchak Scott-Thoennes wrote: On Fri, Jul 16, 2004 at 12:01:03PM +1000, luke.kendall wrote: 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 I'm partial to: cygcheck -l ssmtp|fgrep README|xargs less myself. Works for other packages, too. Hey, nice use of tools. Can we get a gold star here for a clever use of utilities? This is something that I'll be using myself in the future. cgf -- 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/
Re: ssmtp man page (Was: Re: sending email from cygwin) gold star
On Fri, 16 Jul 2004, Christopher Faylor wrote: On Fri, Jul 16, 2004 at 02:25:32PM -0700, Yitzchak Scott-Thoennes wrote: On Fri, Jul 16, 2004 at 12:01:03PM +1000, luke.kendall wrote: 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 I'm partial to: cygcheck -l ssmtp|fgrep README|xargs less myself. Works for other packages, too. Hey, nice use of tools. Can we get a gold star here for a clever use of utilities? This is something that I'll be using myself in the future. cgf You sure can. Just for the archives, though (not to downplay the original achievement), this will also display any other READMEs contained in the package. If you only want the Cygwin-specific one, this incantation might be more appropriate: cygcheck -l ssmtp|grep doc/Cygwin/.*README|xargs less HTH, Igor -- http://cs.nyu.edu/~pechtcha/ |\ _,,,---,,_[EMAIL PROTECTED] ZZZzz /,`.-'`'-. ;-;;,_[EMAIL PROTECTED] |,4- ) )-,_. ,\ ( `'-' Igor Pechtchanski, Ph.D. '---''(_/--' `-'\_) fL a.k.a JaguaR-R-R-r-r-r-.-.-. Meow! I have since come to realize that being between your mentor and his route to the bathroom is a major career booster. -- Patrick Naughton -- 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/
Re: ssmtp man page (Was: Re: sending email from cygwin) gold star
On Fri, Jul 16, 2004 at 09:53:44PM -0400, Igor Pechtchanski wrote: On Fri, 16 Jul 2004, Christopher Faylor wrote: On Fri, Jul 16, 2004 at 02:25:32PM -0700, Yitzchak Scott-Thoennes wrote: On Fri, Jul 16, 2004 at 12:01:03PM +1000, luke.kendall wrote: 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 I'm partial to: cygcheck -l ssmtp|fgrep README|xargs less myself. Works for other packages, too. Hey, nice use of tools. Can we get a gold star here for a clever use of utilities? This is something that I'll be using myself in the future. You sure can. Just for the archives, though (not to downplay the original achievement), this will also display any other READMEs contained in the package. If you only want the Cygwin-specific one, this incantation might be more appropriate: cygcheck -l ssmtp|grep doc/Cygwin/.*README|xargs less Thanks for the clarification. -- 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/