Patched doc/setup-net.sgml

2003-03-22 Thread Joshua Daniel Franklin
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 [EMAIL PROTECTED]

* setup-net.sgml: Document setup.exe



Re: Patched doc/setup-net.sgml

2003-03-22 Thread Christopher Faylor
On Sat, Mar 22, 2003 at 02:11:32PM -0600, 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 [EMAIL PROTECTED]

* setup-net.sgml: Document setup.exe

Feel free to update the cygwin web pages if you want.

cgf


Re: Patched doc/setup-net.sgml

2003-03-22 Thread Joshua Daniel Franklin
--- Christopher Faylor [EMAIL PROTECTED] wrote:
 On Sat, Mar 22, 2003 at 02:11:32PM -0600, 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 [EMAIL PROTECTED]
 
 * setup-net.sgml: Document setup.exe
 
 Feel free to update the cygwin web pages if you want.

OK... how?

__
Do you Yahoo!?
Yahoo! Platinum - Watch CBS' NCAA March Madness, live on your desktop!
http://platinum.yahoo.com


Re: Patched doc/setup-net.sgml

2003-03-22 Thread Christopher Faylor
On Sat, Mar 22, 2003 at 12:17:40PM -0800, Joshua Daniel Franklin wrote:
--- Christopher Faylor [EMAIL PROTECTED] wrote:
 On Sat, Mar 22, 2003 at 02:11:32PM -0600, 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 [EMAIL PROTECTED]
 
 * setup-net.sgml: Document setup.exe
 
 Feel free to update the cygwin web pages if you want.

OK... how?

CVS - :ext:cygwin.com:/cvs/cygwin

cgf


Re: Patched doc/setup-net.sgml

2003-03-22 Thread Joshua Daniel Franklin
--- Christopher Faylor [EMAIL PROTECTED] wrote:
  Feel free to update the cygwin web pages if you want.
 
 OK... how?
 
 CVS - :ext:cygwin.com:/cvs/cygwin

I've got this ready to go, but there are quite a few small 
differences between the ones in htdocs/cygwin-ug-net and my
cygwin-ug-net, I suspect related to:

-CONTENT=Modular DocBook HTML Stylesheet Version 1.76b+
-LINK
+CONTENT=Modular DocBook HTML Stylesheet Version 1.44LINK

Is this going to matter? All the filenames are the same, but some
of the internal links change. 

__
Do you Yahoo!?
Yahoo! Platinum - Watch CBS' NCAA March Madness, live on your desktop!
http://platinum.yahoo.com


Re: Patched doc/setup-net.sgml

2003-03-22 Thread Pierre A. Humblet
At 02:11 PM 3/22/2003 -0600, 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 [EMAIL PROTECTED]

* setup-net.sgml: Document setup.exe

Thanks Joshua. Here are three comments

The Root Directory for Cygwin (default C:\cygwin) will become '/' within
your Cygwin installation. 
***
Perhaps add that you must have write access to the parent directory (here
c:\) 
and the inheritances in the acl of the parent will determine the access to
the 
installed files


All Windows drives can be accessed with the /cygdrive/X/ virtual directory
and Cygwin's mount utility. 

That's not setup related. Delete?


The Install For options of All Users or Just Me are especially for
multiuser systems or Domain users. If you have a single-user workstation,
this option probably does not concern you. If you are seeking to rollout
Cygwin on a large Domain, you will want to think carefully about the
implications of each type and possibly consult the Cygwin mailing list
archives about others' experiences.

This option is mysterious and the explanation above does not give any food for
thought in think carefully about the implications. Is it about the mounts
in the 
registry? Anything else? 
Given that the daemons use the system mounts, wouldn't it be a good idea to 
set them?


Pierre



Re: Patched doc/setup-net.sgml

2003-03-22 Thread Christopher Faylor
On Sat, Mar 22, 2003 at 12:47:08PM -0800, Joshua Daniel Franklin wrote:
Is this going to matter?

No.

cgf


Re: Patched doc/setup-net.sgml

2003-03-22 Thread Joshua Daniel Franklin
--- Christopher Faylor [EMAIL PROTECTED] wrote:
 On Sat, Mar 22, 2003 at 12:47:08PM -0800, Joshua Daniel Franklin wrote:
 Is this going to matter?
 
 No.

Committed.

__
Do you Yahoo!?
Yahoo! Platinum - Watch CBS' NCAA March Madness, live on your desktop!
http://platinum.yahoo.com


Re: Patched doc/setup-net.sgml

2003-03-22 Thread Christopher Faylor
On Sun, Mar 23, 2003 at 11:24:59AM +1100, Robert Collins wrote:
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 [EMAIL PROTECTED]
 
 * 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!

Megadittos.  Great job.

I agree with all of Robert's observations, too, fwiw.

cgf


Re: Patched doc/setup-net.sgml

2003-03-22 Thread Igor Pechtchanski
On 23 Mar 2003, Robert Collins wrote:

 [snip]
 * 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.

This doesn't work for me.  I'm still trying to figure out why, but since
the possibility is there, better err on the side of caution.

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

It's stored locally as setup.ini, though, isn't it?

 [snip]
 * 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 :].

How about Packages are assigned categories, and one package may belong to
multiple categories.

 * a very basic Cygwin
 to me, 'minimal' reads more clearly than 'very basic'. Just a thought.

Minimal is overloaded to mean other things, though...  I'm not sure what
the right term here would be, reasonable, perhaps?
Igor

 [snip]
 Fantastic job otherwise!
 Cheers,
 Rob

-- 
http://cs.nyu.edu/~pechtcha/
  |\  _,,,---,,_[EMAIL PROTECTED]
ZZZzz /,`.-'`'-.  ;-;;,_[EMAIL PROTECTED]
 |,4-  ) )-,_. ,\ (  `'-'   Igor Pechtchanski
'---''(_/--'  `-'\_) fL a.k.a JaguaR-R-R-r-r-r-.-.-.  Meow!

Oh, boy, virtual memory! Now I'm gonna make myself a really *big* RAMdisk!
  -- /usr/games/fortune



Re: Patched doc/setup-net.sgml

2003-03-22 Thread Robert Collins
On Sun, 2003-03-23 at 11:55, Igor Pechtchanski wrote:
 On 23 Mar 2003, Robert Collins wrote:
 
  [snip]
  * 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.
 
 This doesn't work for me.  I'm still trying to figure out why, but since
 the possibility is there, better err on the side of caution.

Mouse button scrolling doesn't work for some users. We don't disable it
for them. Setup was failing to setup ntsec just recently, but we didn't
err on caution there. I see no reason to err on caution here,
particularly when the benefits are huge.

  * 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.
 
 It's stored locally as setup.ini, though, isn't it?

In setups *private*, just to *change without notice* local package dir
yes. User programs MUST NOT consider whats there canonical unless the
authors sit on this list and track as setup changes. It's certainly not
something to tell folk about during the installation!

  [snip]
  * 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 :].
 
 How about Packages are assigned categories, and one package may belong to
 multiple categories.

Also good. Possibly we need a more user orientated flavour..
Packages are grouped into categories by the author, and can be found
under any of those categories in the 'categories' hierarchical chooser
view  ?

Rob
-- 
GPG key available at: http://users.bigpond.net.au/robertc/keys.txt.


signature.asc
Description: This is a digitally signed message part