X-Recipient: archive-cygwin AT delorie DOT com X-SWARE-Spam-Status: No, hits=0.4 required=5.0 tests=AWL,BAYES_00,KHOP_SPAMHAUS_DROP X-Spam-Check-By: sourceware.org From: "Maglinger, Paul" To: "'cygwin AT cygwin DOT com'" Subject: Re: Where can I find the official cygwin openssh documentation? Date: Mon, 3 Dec 2012 15:34:52 +0000 Message-ID: <36DA94300D69184A91500B695547A14833E0B3A1@COMSTAR1.scvl.com> Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 X-IsSubscribed: yes Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: cygwin-owner AT cygwin DOT com Mail-Followup-To: cygwin AT cygwin DOT com Delivered-To: mailing list cygwin AT cygwin DOT com Content-Transfer-Encoding: 8bit X-MIME-Autoconverted: from quoted-printable to 8bit by delorie.com id qB3FZEHR027881 I agree with Mike. Cygwin should be the authoritative source. > > Christopher, thanks very much for pointing me in the right direction > for the official documentation -- it was very helpful. > > I see why these step-by-step openssh+cygwin guides appearing on the > Internet are annoying to you and other cygwin experts -- not only > should they be unnecessary, but they also contain false and misleading > information. When they fail, people then come and post on this mailing > list annoying the experts, or give up, or have to spend a lot longer > trying to figure out the problem. > > Thus I make this suggestion: can we put this openssh+cygwin > documentation up on the cygwin web site? When people are looking for > documentation, it is generally the case they use a web search engine. > Because this documentation doesn't appear on the cygwin web site, > Google returns these step-by-step guides as the top hits. Thus it's > the first and sometimes the only documentation people use on the > subject. > > On Sun, Dec 2, 2012 at 4:28 PM, Christopher Faylor wrote: > > > > And, FYI, most of those step-by-step guides that I am aware of were just > > wrong. The whole point of a setup script is to set-up-ssh. If > > something isn't working then it's a bug to be reported and worked on. > > You can see many cases of Corinna changing the script when people report > > problems. The step-by-step guides should not be necessary. > > > > And, before anyone has an indignant reply to this, I'll say it again: If > > the setup scripts didn't work work for you then they can be fixed. A > > step-by-step guide is a band-aid. > > -- Problem reports: http://cygwin.com/problems.html FAQ: http://cygwin.com/faq/ Documentation: http://cygwin.com/docs.html Unsubscribe info: http://cygwin.com/ml/#unsubscribe-simple