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" <PMAGLINGER AT scvl DOT com>
To: "'cygwin AT cygwin DOT com'" <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: <cygwin.cygwin.com>
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
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