diff options
-rw-r--r-- | winsup/doc/ChangeLog | 8 | ||||
-rw-r--r-- | winsup/doc/faq-programming.xml | 17 | ||||
-rw-r--r-- | winsup/doc/faq-setup.xml | 26 |
3 files changed, 40 insertions, 11 deletions
diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog index d76fb3462..447b617a0 100644 --- a/winsup/doc/ChangeLog +++ b/winsup/doc/ChangeLog @@ -1,3 +1,11 @@ +2006-01-25 Joshua Daniel Franklin <joshuadfranklin@yahoo.com> + + * faq-programming.xml (faq.programming.building-cygwin): Add + list of packages required for building and exact check instructions. + * faq-setup.xml (faq.setup.uninstall-service): New instructions + on uninstalling a cygwin service. + (faq.setup.uninstall-all): Reference new service uninstall FAQ. + 2006-01-25 Igor Peshansky <pechtcha@cs.nyu.edu> * faq-setup.xml (faq.setup.snapshots): Rename DLL using Windows tools. diff --git a/winsup/doc/faq-programming.xml b/winsup/doc/faq-programming.xml index 856e93c37..9d7d23f7a 100644 --- a/winsup/doc/faq-programming.xml +++ b/winsup/doc/faq-programming.xml @@ -422,8 +422,15 @@ rewriting the runtime library in question from specs... <question><para>How do I build Cygwin on my own?</para></question> <answer> -<para>First, you need to get the Cygwin source. Ideally, you should check out -what you need from CVS (<ulink url="http://cygwin.com/cvs.html">http://cygwin.com/cvs.html</ulink>). This is the +<para>First, you need to make sure you have the necessary build tools +installed; you at least need <literal>gcc</literal>, <literal>make</literal>, +and <literal>perl</literal>. If you want to run the tests +<literal>cocom</literal> and <literal>dejagnu</literal> are also required, +and you need to have <literal>CYGWIN=server</literal> set as described at +<ulink url="http://www.cygwin.com/cygwin-ug-net/using-cygserver.html" />. + +Next, get the Cygwin source. Ideally, you should check out +what you need from CVS (<ulink url="http://cygwin.com/cvs.html" />). This is the <emphasis>preferred method</emphasis> for acquiring the sources. Otherwise, you can install the cygwin source package from the distribution. </para> @@ -450,10 +457,10 @@ cd build make install > install.log 2>&1 </screen> -<para>Normally, this procedure ignore errors in building the documentation. -which requires the <literal>docbook-xml</literal>, <literal>docbook-xsl</literal>, and +<para>Normally, this procedure ignores errors in building the documentation. +which requires the <literal>docbook-xml42</literal>, <literal>docbook-xsl</literal>, and <literal>xmlto</literal> packages. For more information on building the -documentation, see the README included in the cygwin-doc package. +documentation, see the README included in the <literal>cygwin-doc</literal> package. </para> <para>To check a cygwin1.dll, run "make check" in the winsup/testsuite directory. If that works, install everything <emphasis>except</emphasis> the dll (if diff --git a/winsup/doc/faq-setup.xml b/winsup/doc/faq-setup.xml index 9b40589e4..fa0710492 100644 --- a/winsup/doc/faq-setup.xml +++ b/winsup/doc/faq-setup.xml @@ -320,6 +320,20 @@ the action reads ``Uninstall''. Proceed by clicking ``Next''. </para> </answer></qandaentry> +<qandaentry id="faq.setup.uninstall-service"> +<question><para>How do I uninstall a Cygwin service?</para></question> +<answer> +<para>If you don't know the name of the service, you can list all +services you have installed with <literal>cygrunsrv -L</literal>. Before +removing the service, you should stop it with +<literal>cygrunsrv --stop <replaceable>service_name</replaceable></literal>. +If you have <literal>inetd</literal> configured to run as a standalone +service, it will not show up in the list, but <literal>cygrunsrv --stop inetd</literal> +will work to stop it as well. Lastly, remove the service with +<literal>cygrunsrv --remove <replaceable>service_name</replaceable></literal>. +</para> +</answer></qandaentry> + <qandaentry id="faq.setup.uninstall-all"> <question><para>How do I uninstall <emphasis role='bold'>all</emphasis> of Cygwin?</para></question> <answer> @@ -328,11 +342,11 @@ the action reads ``Uninstall''. Proceed by clicking ``Next''. of Cygwin is as follows: </para> <orderedlist> -<listitem><para>Remove all Cygwin services. If a service is currently running, it must -first be stopped with <literal>cygrunsrv -E name</literal>, where <literal>name</literal> -is the name of the service. Then use <literal>cygrunsrv -R name</literal> to uninstall the -service from the registry. Repeat this for all services that you installed. -Common services that might have been installed are <literal>sshd</literal>, <literal>cron</literal>, +<listitem><para>First remove all Cygwin services by repeating the instructions +in <ulink +url="http://cygwin.com/faq/faq.setup.html#faq.setup.uninstall-service" /> for +all services that you installed. Common services that might have been +installed are <literal>sshd</literal>, <literal>cron</literal>, <literal>cygserver</literal>, <literal>inetd</literal>, <literal>apache</literal>, and so on. </para> </listitem> @@ -341,7 +355,7 @@ that might be running in the background. Remove all mount information by typing <literal>umount -A</literal> 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 <literal>mount -m</literal> as described at -<ulink url="http://cygwin.com/cygwin-ug-net/using-utils.html#mount">http://cygwin.com/cygwin-ug-net/using-utils.html#mount</ulink>. +<ulink url="http://cygwin.com/cygwin-ug-net/using-utils.html#mount" />. </para> </listitem> <listitem><para>Delete the Cygwin root folder and all subfolders. If you get an error |