This is the mail archive of the cygwin-patches@cygwin.com mailing list for the Cygwin project.
Index Nav: | [Date Index] [Subject Index] [Author Index] [Thread Index] | |
---|---|---|
Message Nav: | [Date Prev] [Date Next] | [Thread Prev] [Thread Next] |
Other format: | [Raw text] |
On Sun, 2003-03-23 at 07:11, Joshua Daniel Franklin wrote: > I just committed a big pactch to doc/setup-net.sgml that more or less > documents setup.exe. Resulting HTML can temporarily be seen at: > > <http://iocc.com/~joshua/cygwin/setup-net.html> > > 2003-03-22 Joshua Daniel Franklin <joshuadfranklin at yahoo dot com> > > * setup-net.sgml: Document setup.exe > A few comments ( hope I'm not duplicating feedback here): * The cache should not be the same folder as the Cygwin root. Can you make this "must not be". setup *will* choke :[. * For most users, the Direct Connection method of downloading is the best choice. IMO the IE5 method is best. I've been considering making it the default. The IE5 method will leverage your IE5 cache and or organisational proxy server for performance. It will also honour browser auto-configuration scripts. * setup.ini setup actually downloads setup.bz2 these days, setup.ini is a suported legacy config file. I don't know if you want to mention that or not. * along with some basic information about each package (version number, dependencies, checksum, etc.) You might want to skip this bit, and / or link to http://sources.redhat.com/cygwin-apps/setup.html#setup.ini i.e.: "From each selected mirror site, setup.exe downloads a small text file called setup.bz2 that contains a list of packages available from that mirror. For details on the format see the setup.exe <home page>". * packages are divided into categories you might want to say 'grouped into', or 'categorized by'. divided into could suggest literal division of individual packages to a non english reader - i.e. /bin files go into the foo package :]. * a very basic Cygwin to me, 'minimal' reads more clearly than 'very basic'. Just a thought. * If you are interested in what is being done, the scripts are kept in the /etc/postinstall/ directory, renamed with a done extension after being run. I'd rather not have this in the users guide. It's one more place to update when things change... A reference to the setup package creation guide (http://cygwin.com/setup.html#postinstall) should suffice. Fantastic job otherwise! Cheers, Rob -- GPG key available at: <http://users.bigpond.net.au/robertc/keys.txt>.
Attachment:
signature.asc
Description: This is a digitally signed message part
Index Nav: | [Date Index] [Subject Index] [Author Index] [Thread Index] | |
---|---|---|
Message Nav: | [Date Prev] [Date Next] | [Thread Prev] [Thread Next] |