Re: [patch] update documentation Was: cygwin-host-setup does not install sshd

[Brian Dessent <brian at dessent dot net>]

Corinna Vinschen wrote:

> > 2005-05-17  Brian Dessent  <brian@XXX.YYY>
> 
> http://cygwin.com/acronyms#PCYMTNQREAIYR ;-)

Yeah, I know.  Spammers have had my address for some time, I don't feel
like hiding.  Me <heart> SpamAssassin.  :)

> "Close all Cygwin command prompts, xterms, etc. and stop the X11 server [...]"
> 
> one item up and then to begin the next item with
> 
> "Open a single Cygwin command promt, remove all mount information with
>  @samp{umount -A} [...]"

Ah, right.  I guess I was trying to avoid saying "close down everything"
followed by "open a command prompt and..."  I combined the two steps
into one, hopefully less confusing.

2005-05-18  Brian Dessent  <brian@dessent.net>

	* install.texinfo ("How do I uninstall..."): Rewrite to cover
	removing services, dealing with permissions, and other common
	tasks for removing Cygwin completely.

Index: install.texinfo
===================================================================
RCS file: /cvs/src/src/winsup/doc/install.texinfo,v
retrieving revision 1.52
diff -u -r1.52 install.texinfo
--- install.texinfo	29 Jan 2005 22:35:17 -0000	1.52
+++ install.texinfo	18 May 2005 10:33:20 -0000
@@ -252,29 +252,59 @@
 
 @subsection How do I uninstall @strong{all} of Cygwin?
 
-Setup has no automatic uninstall facility.  Just delete everything
-manually:
+Setup has no automatic uninstall facility.  The recommended method to remove all 
+of Cygwin is as follows:
 
-@itemize @bullet
-@item Cygwin shortcuts on the Desktop and Start Menu
-
-@item The registry tree @samp{Software\Cygnus Solutions} under
-@code{HKEY_LOCAL_MACHINE} and/or @code{HKEY_CURRENT_USER}.
-
-@item Anything under the Cygwin root folder, @samp{C:\cygwin} by
-default.
-
-@item Anything created by setup in its temporary working directory.
+@enumerate
 
-@end itemize
+@item Remove all Cygwin services.  If a service is currently running, it must 
+first be stopped with @samp{cygrunsrv -E name}, where @samp{name} 
+is the name of the service.  Then use @samp{cygrunsrv -R name} to uninstall the 
+service from the registry.  Repeat this for all services that you installed.  
+Common services that might have been installed are @code{sshd}, @code{cron}, 
+@code{cygserver}, @code{inetd}, @code{apache}, and so on.
+
+@item Stop the X11 server if it is running, and terminate any Cygwin programs 
+that might be running in the background.  Remove all mount information by typing 
+@samp{umount -A} and then exit the command prompt and ensure that no Cygwin 
+processes remain.  Note: If you want to save your mount points for a later 
+reinstall, first save the output of @samp{mount -m} as described at 
+@file{http://cygwin.com/cygwin-ug-net/using-utils.html#mount}.
 
-It's up to you to deal with other changes you made to your system, such
-as installing the inetd service, altering system paths, etc.  Setup
-would not have done any of these things for you.
+@item Delete the Cygwin root folder and all subfolders.  If you get an error 
+that an object is in use, then ensure that you've stopped all services and 
+closed all Cygwin programs.  If you get a 'Permission Denied' error then you 
+will need to modify the permissions and/or ownership of the files or folders 
+that are causing the error.  For example, sometimes files used by system 
+services end up owned by the SYSTEM account and not writable by regular users.  
+
+The quickest way to delete the entire tree if you run into this problem is to 
+change the ownership of all files and folders to your account.  To do this in 
+Windows Explorer, right click on the root Cygwin folder, choose Properties, then 
+the Security tab.  Select Advanced, then go to the Owner tab and make sure your 
+account is listed as the owner.  Select the 'Replace owner on subcontainers and 
+objects' checkbox and press Ok.  After Explorer applies the changes you should 
+be able to delete the entire tree in one operation.  Note that you can also 
+achieve this in Cygwin by typing @samp{chown -R user /} or by using other tools 
+such as CACLS.EXE.
+
+@item Delete the Cygwin shortcuts on the Desktop and Start Menu, and anything 
+left by setup.exe in the download directory.  However, if you plan to reinstall 
+Cygwin it's a good idea to keep your setup.exe download directory since you can 
+reinstall the packages left in its cache without redownloading them.
+
+@item If you added Cygwin to your system path, you should remove it unless you 
+plan to reinstall Cygwin to the same location.  Similarly, if you set your 
+CYGWIN environment variable system-wide and don't plan to reinstall, you should 
+remove it.
+
+@item Finally, if you want to be thorough you can delete the registry tree 
+@samp{Software\Cygnus Solutions} under @code{HKEY_LOCAL_MACHINE} and/or 
+@code{HKEY_CURRENT_USER}.  However, if you followed the directions above you 
+will have already removed all the mount information which is typically the only 
+thing stored in the registry.
 
-If you want to save your mount points for a later reinstall, save the
-output of @samp{mount -m} as described at
-@file{http://cygwin.com/cygwin-ug-net/using-utils.html#mount}.
+@end enumerate
 
 @subsection How do I install snapshots?