X-Recipient:	archive-cygwin AT delorie DOT com
X-SWARE-Spam-Status:	No, hits=-1.7 required=5.0 tests=AWL,BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FROM,RCVD_IN_DNSWL_NONE,T_TO_NO_BRKTS_FREEMAIL
X-Spam-Check-By:	sourceware.org
MIME-Version:	1.0
In-Reply-To:	<4C939F7A.1020902@cwilson.fastmail.fm>
References:	<AANLkTimP2TqucKt075ZyfTOMzEByUEUboBTz5V-SVEwX AT mail DOT gmail DOT com> <AANLkTi=uFBTQkY6BP03PO2+wsBeOVDitF0CNyLBDj-3C AT mail DOT gmail DOT com> <4C938040 DOT 3080704 AT cwilson DOT fastmail DOT fm> <4C9389EA DOT 7050704 AT cygwin DOT com> <AANLkTi=mGAdGLR_cMRZuXYQB-T9qxVcDNm7hQxpbcDwN AT mail DOT gmail DOT com> <4C939F7A DOT 1020902 AT cwilson DOT fastmail DOT fm>
Date:	Fri, 17 Sep 2010 19:38:03 +0200
Message-ID:	<AANLkTinwOhJjYZw0L-5qw8rhgzHxPF6qG2_HCQTzayY6@mail.gmail.com>
Subject:	Re: simplifying rebaseall
From:	Al <oss DOT elmar AT googlemail DOT com>
To:	cygwin AT cygwin DOT com
Mailing-List:	contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Id:	<cygwin.cygwin.com>
List-Unsubscribe:	<mailto:cygwin-unsubscribe-archive-cygwin=delorie DOT com AT cygwin DOT 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

Hi,

I appreciate you take the time to contribute all that information.
Hope it is not only red by me.

>
> Now, surely that is a lot of hunting around -- but I can only assume
> that many people did so, since you are apparently the first person to
> fail to locate the documentation when faced with the question "How do I
> run rebaseall"?

I wasn't faced with that question. I was face with error messages.
Google guided me by this messages (and many others) to exactly this
blog first:

http://www.mylifestartingup.com/2009/04/fatal-error-unable-to-remap-to-same=
.html

... not to Cygwin list, not to the readme, not to the FAQ. The blog
rather tells how to run rebaseall not much why. The comments document
well that many people follow that advice without any knowledge of any
readme. You don't even find the word readme on that blog.

> See above. =A0Most of that should be very familiar to a person with "10
> years of Linux experience" -- except for the bit about "Cygwin packages
> often put a cygwin-specific README file in /usr/share/doc/Cygwin/"
>

It's familiar that regular programs have a doc, man etc. It's also
familiar that small maintenance scripts don't have. Even your posting
has more lines the he rebaseall script itself. So you wouldn't really
follow the search path for docs you give here. That there is a readme
for such a small script is the positive execption. But I have doubts
that many people will find it.

Al

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

- Raw text -