Re: [PATCH] Proposed clarification of the snapshot installation FAQ

2006-01-25 Thread Corinna Vinschen
On Jan 13 00:01, Igor Peshansky wrote:
 On Thu, 12 Jan 2006, Igor Peshansky wrote:
 
  On Thu, 12 Jan 2006, Christopher Faylor wrote:
 
   Nevertheless, the advice about using mv to rename cygwin1.dll won't
   work on every version of Windows and needs to be changed.
 
  Hmm, it's worked for me on Win98, Win2k, and WinXP (though I suppose
  there could be differences on, say, WinNT4 or something)...  I basically
  wanted to avoid giving too many things to do in Windows Explorer.  But
  no matter -- I'll submit a patch with this change shortly.
 
 And here it is.
   Igor
 ==
 2006-01-12  Igor Peshansky  [EMAIL PROTECTED]
 
   * faq-setup.xml (faq.setup.snapshots): Rename DLL using Windows tools.

Applied.


Thanks,
Corinna

-- 
Corinna Vinschen  Please, send mails regarding Cygwin to
Cygwin Project Co-Leader  cygwin AT cygwin DOT com
Red Hat


Re: [PATCH] Proposed clarification of the snapshot installation FAQ

2006-01-12 Thread Joshua Daniel Franklin
On 1/11/06, Igor Peshansky wrote:
 As mentioned in http://cygwin.com/ml/cygwin/2006-01/msg00537.html,
 here's a patch to the FAQ to clarify the section on installing snapshots.
 I didn't know whether the various *.texinfo files are still used, so I
 ported the modifications there as well, just in case.

Applied to faq-setup.xml (the texinfo files are no longer used... I suppose I
should remove them). It would be nice to have a sample batch file that automated
the cygwin1.dll replacement, too.


Re: [PATCH] Proposed clarification of the snapshot installation FAQ

2006-01-12 Thread Igor Peshansky
On Thu, 12 Jan 2006, Christopher Faylor wrote:

 On Thu, Jan 12, 2006 at 07:57:27PM -0800, Joshua Daniel Franklin wrote:
 On 1/11/06, Igor Peshansky wrote:
  As mentioned in http://cygwin.com/ml/cygwin/2006-01/msg00537.html,
  here's a patch to the FAQ to clarify the section on installing
  snapshots. I didn't know whether the various *.texinfo files are
  still used, so I ported the modifications there as well, just in
  case.
 
 Applied to faq-setup.xml

Thanks.

 (the texinfo files are no longer used... I suppose I should remove
 them).

Yes, please.

 It would be nice to have a sample batch file that automated the
 cygwin1.dll replacement, too.

 I was hoping for a little more discussion about this.  I think Corinna
 and I are both a little despondent over the fact that we have to be
 SUPER precise about obvious things like when you say something like cd
 /tmp it means that you should be doing it in a POSIX shell.  I have to
 wonder what kind of useful feedback we'll get from people who can't
 figure this out.  I also was going to caution against telling everyone
 to try a snapshot at the first hint of trouble.  I don't think that
 this should be used as a panacea, although I realize that the length of
 time since the last cygwin release has made it attractive.

 ...but that's not an issue for this mailing list...

Right.

 Nevertheless, the advice about using mv to rename cygwin1.dll won't
 work on every version of Windows and needs to be changed.

Hmm, it's worked for me on Win98, Win2k, and WinXP (though I suppose there
could be differences on, say, WinNT4 or something)...  I basically wanted
to avoid giving too many things to do in Windows Explorer.  But no matter
-- I'll submit a patch with this change shortly.

FWIW, I usually do cd /bin  cygstart cmd, and then close the bash
shell and do the renaming in the CMD window.  However, I don't think this
particular set of instructions can rely on the presence of cygstart...

 I didn't read much else besides that because I was just too depressed by
 the fact that the current words were quoteconfusing/unquote.

Sigh...  I'm sure there'll be complaints about my wording too.
Igor
-- 
http://cs.nyu.edu/~pechtcha/
  |\  _,,,---,,_[EMAIL PROTECTED] | [EMAIL PROTECTED]
ZZZzz /,`.-'`'-.  ;-;;,_Igor Peshansky, Ph.D. (name changed!)
 |,4-  ) )-,_. ,\ (  `'-'   old name: Igor Pechtchanski
'---''(_/--'  `-'\_) fL a.k.a JaguaR-R-R-r-r-r-.-.-.  Meow!

Las! je suis sot... -Mais non, tu ne l'es pas, puisque tu t'en rends compte.
But no -- you are no fool; you call yourself a fool, there's proof enough in
that! -- Rostand, Cyrano de Bergerac


[PATCH] Proposed clarification of the snapshot installation FAQ

2006-01-11 Thread Igor Peshansky
As mentioned in http://cygwin.com/ml/cygwin/2006-01/msg00537.html,
here's a patch to the FAQ to clarify the section on installing snapshots.
I didn't know whether the various *.texinfo files are still used, so I
ported the modifications there as well, just in case.
The ChangeLog is below.
Igor
===
2006-01-11  Igor Peshansky  [EMAIL PROTECTED]

* faq-setup.xml (faq.setup.setup): Correct URL typo.
(faq.setup.snapshots): Clarify.
* install.texinfo (Contents): Correct URL typo.
(How do I install snapshots): Clarify.

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

Las! je suis sot... -Mais non, tu ne l'es pas, puisque tu t'en rends compte.
But no -- you are no fool; you call yourself a fool, there's proof enough in
that! -- Rostand, Cyrano de BergeracIndex: faq-setup.xml
===
RCS file: /cvs/src/src/winsup/doc/faq-setup.xml,v
retrieving revision 1.2
diff -u -p -r1.2 faq-setup.xml
--- faq-setup.xml   4 Dec 2005 03:55:28 -   1.2
+++ faq-setup.xml   12 Jan 2006 02:33:20 -
@@ -15,7 +15,7 @@ that the GUI installer is a work in pro
 difficulties, especially if you are behind a firewall or have other
 specific requirements.  If something doesn't work right for you, and
 it's not covered here or in the latest development snapshot at
-ulink url=http://cygwin.com/setup/;http://cygwin.com/setup//ulink, then 
by all means report it to the
+ulink 
url=http://cygwin.com/snapshots/;http://cygwin.com/snapshots//ulink, then 
by all means report it to the
 mailing list.
 /para
 paraFor a searchable list of packages that can be installed with Cygwin,
@@ -392,37 +392,54 @@ thing stored in the registry.
 paraFirst, are you sure you want to do this?  Snapshots are risky.  They
 have not been tested.  Use them emphasis role='bold'only/emphasis if there 
is a feature or
 bugfix that you need to try, and you are willing to deal with any
-problems.
-/para
-paraBefore installing a snapshot, you must first Close emphasis 
role='bold'all/emphasis Cygwin
-applications, including shells and services (e.g. inetd, sshd), before
-updating literalcygwin1.dll/literal.  You may have to restart Windows to 
clear
-the DLL from memory.
-/para
-paraYou cannot use Setup to install a snapshot.
+problems, or at the request of a Cygwin developer.
 /para
 paraYou should generally install the full
 literalcygwin-inst-MMDD.tar.bz2/literal update, rather than just the 
DLL,
-otherwise some components may be out of sync.  Cygwin tar won't be
-able to update literal/usr/bin/cygwin1.dll/literal, but it should succeed 
with
-everything else.
+otherwise some components may be out of sync.
 /para
-orderedlist
-listitemparaDownload the snapshot, and run:
+paraYou cannot use Cygwin Setup to install a snapshot.
+/para
+paraFirst, you will need to download the snapshot from the snapshots
+page at ulink 
url=http://cygwin.com/snapshots/;http://cygwin.com/snapshots//ulink.  Note 
the directory where
+you saved the snapshot tarball.
+/para
+paraBefore installing a snapshot, you must first Close emphasis 
role='bold'all/emphasis Cygwin
+applications, including shells and services (e.g., literalinetd/literal, 
literalsshd/literal).
+You will not be able to replace literalcygwin1.dll/literal if any Cygwin 
process is
+running.  You may have to restart Windows to clear the DLL from memory
+(beware of automatic service startup).
+/para
+paraMost of the downloaded snapshot can be installed using 
literaltar/literal.  Cygwin
+literaltar/literal won't be able to update 
literal/usr/bin/cygwin1.dll/literal (because it's
+used by literaltar/literal itself), but it should succeed with everything 
else.  If
+you are only installing the DLL snapshot, skip the first tar command.  Open
+a literalbash/literal shell (it should be the only running Cygwin process) 
and issue
+the following commands:
 screen
-   cd /
-tar jxvf /posix/path/to/cygwin-inst-MMDD.tar.bz2 
--exclude=usr/bin/cygwin1.dll
-cd /tmp
-tar jxvf /posix/path/to/cygwin-inst-MMDD.tar.bz2 
usr/bin/cygwin1.dll
+   /bin/tar -C/ -jxvf /posix/path/to/cygwin-inst-MMDD.tar.bz2 
--exclude=usr/bin/cygwin1.dll
+   /bin/tar -C/tmp -jxvf /posix/path/to/cygwin-inst-MMDD.tar.bz2 
usr/bin/cygwin1.dll
+   /bin/mv /bin/cygwin1.dll /bin/cygwin1-prev.dll
 /screen
 /para
-/listitem
-listitemparaAfter closing all Cygwin apps (see above), use Explorer or the
+paraNote that after the literalmv/literal command you will not be able 
to run any
+Cygwin programs.  Exit the bash shell, and use