Mailing-List: contact cygwin-apps-help AT cygwin DOT com; run by ezmlm
Sender: cygwin-apps-owner AT cygwin DOT com
List-Subscribe: <mailto:cygwin-apps-subscribe AT cygwin DOT com>
List-Archive: <http://sources.redhat.com/ml/cygwin-apps/>
List-Post: <mailto:cygwin-apps AT cygwin DOT com>
List-Help: <mailto:cygwin-apps-help AT cygwin DOT com>, <http://sources.redhat.com/lists.html#faqs>
Delivered-To: mailing list cygwin-apps AT cygwin DOT com
Message-ID: <100801c18601$5e5ee090$0200a8c0@lifelesswks>
From: "Robert Collins" <robert DOT collins AT itdomain DOT com DOT au>
To: "Robert Collins" <robert DOT collins AT itdomain DOT com DOT au>,
   <cygwin-apps AT cygwin DOT com>
References: <FC169E059D1A0442A04C40F86D9BA760014A99 AT itdomain003 DOT itdomain DOT net DOT au>
Subject: Re: Made many changes to setup.html
Date: Sun, 16 Dec 2001 18:14:56 +1100
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 6.00.2600.0000
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2600.0000
X-OriginalArrivalTime: 16 Dec 2001 07:14:48.0503 (UTC) FILETIME=[58BE2470:01C18601]

Ok, here's my comments.

Chris, I'd like to make a few (non visible) changes for HTML conformance
to the header and menu on the main cygwin page. Is that ok with you?

Thank you for the examples - I think they will help a lot.

I've altered some things (mainly cosmetic or trivial). One in particular
was the recommendation to include bar as a dependency if you directly
require foo, and know that foo requires bar. That was wrong. The reason
it is wrong is that if foo is recompiled to not need bar, bar will be
pulled in _even though_ it is no longer needed. That would then require
work to correct your package's dependency list - and the whole point of
dependencies is to reduce effort, not increase it.

From memory - Jonathan's work was a little incorrect. According to
http://www.w3.org/TR/html401/struct/links.html#h-12.2.3 id is as equally
valid as name, and is required in certain circumstances. I see no reason
to change id to name, as there is no benefit (we're not using entities
or character references). I don't object to adding name to each A tag
though, although I don't really see the point.

Unfortunately I deleted Jonathan's email because I thought it went to
the list.... Jonathan could you please resend it to me (the id->name
change was all I recall :}).

Rob


===
----- Original Message -----
From: "Robert Collins" <robert DOT collins AT itdomain DOT com DOT au>
To: <cygwin-apps AT cygwin DOT com>
Sent: Friday, December 14, 2001 11:40 AM
Subject: RE: Made many changes to setup.html


I've not had a lot of time recently. I hope to get up to date on a lot
of things this weekend.

Rob

> -----Original Message-----
> From: Christopher Faylor [mailto:cgf AT redhat DOT com]
> Sent: Friday, December 14, 2001 8:56 AM
> To: cygwin-apps AT cygwin DOT com
> Subject: Made many changes to setup.html
>
>
> I added a few examples and some more clarifying words to
> setup.html, in
> line with the comments that have been showing up here.
>
> I hope I haven't interfered with any of Robert's work on this file.
>
> I haven't added Jonathan Kamen's submission (sent privately), though.
> I'll do that if Robert wants me to but I haven't seen him comment on
> it yet.
>
> cgf
>