Made many changes to setup.html

[Robert Collins]

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.collins@itdomain.com.au>
To: <cygwin-apps@cygwin.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@redhat.com]
> Sent: Friday, December 14, 2001 8:56 AM
> To: cygwin-apps@cygwin.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
>