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

diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index d76fb34..447b617 100644 (file)
--- 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 856e93c..9d7d23f 100644 (file)
--- 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 &gt; install.log 2&gt;&amp;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 9b40589..fa07104 100644 (file)
--- 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