a complete rewrite of the Win32 installation procedure description with a step-by...
authorulfl <ulfl@f5534014-38df-0310-8fa8-9805f1628bb7>
Sun, 26 Feb 2006 18:24:39 +0000 (18:24 +0000)
committerulfl <ulfl@f5534014-38df-0310-8fa8-9805f1628bb7>
Sun, 26 Feb 2006 18:24:39 +0000 (18:24 +0000)
git-svn-id: http://anonsvn.wireshark.org/wireshark/trunk@17414 f5534014-38df-0310-8fa8-9805f1628bb7

docbook/edg_src/EDG_chapter_tools.xml

index 86dfb62f4402afa792b8101d1da3baddc984a908..be0a40bf64a0b1545025fb98bef1c61982c581c4 100644 (file)
        <itemizedlist>
        <listitem>
        <para>
-       UNIX: as described above, the tools should be commonly available on the
-       supported UNIX platforms, and for Win32 platforms by the Cygwin UNIX 
-       emulation
+       UNIX (or Win32 Cygwin): as described above, the tools should be commonly 
+       available on the supported UNIX platforms, and for Win32 platforms by the 
+       Cygwin UNIX emulation
        </para>
        </listitem>
        <listitem>
        <para>
        Win32 native: some tools are available as native Win32 tools, no 
-       emulation is required
+       emulation is required (however, as the installation can be complicated, 
+       using the Cygwin tools is recommended)
        </para>
        </listitem>
        </itemizedlist>
        </para>
        <para>
+       General instructions to install the tools are given in:
+       <xref linkend="ChToolsInstallUNIX"/> and 
+       <xref linkend="ChToolsInstallWin32"/>.
+       </para>
+       <para>
        The following sections give a very brief description of 
        what the particular tool is doing, how it is used in the Ethereal project 
        and how it can be installed and tested.
        You will find explanations of the tool usage for some of the specific 
        development tasks in <xref linkend="ChapterSources"/>.
        </para>
-       <para>
-       Some recommendations are given for the
-       easiest way to get a Win32 development platform up and running, see 
-       <xref linkend="ChToolsWin32Recommended"/>.
-       </para>
   </section>
   
-  <section id="ChToolsInstall">
-       <title>Installation</title>
-       <para>
-       The installation of the tools depend on the platform you use:
-       </para>
-       
-       <section id="ChToolsInstallUnix">
-       <title>UNIX</title>
+  <section id="ChToolsInstallUNIX">
+       <title>UNIX: Installation</title>       
        <para>
        All the tools required are usually installed on a UNIX developer machine.
        </para>
        <para>
        If a tool is not already installed on your system, you will typically use 
-       the installation package from your distribution.
+       the installation package from your distribution (by your favourite package 
+       manager: apt, yum, synaptics, ...).
        </para>
        <para>
        If an install package is not available, or you have a reason not to use 
        from source code. The following sections will provide you with the webpage
        addresses where you can get these sources. 
        </para>
-       </section>
-       
-       <section id="ChToolsInstallWin32Native">
-       <title>Win32 native</title>
-       <para>
-       The native tools will typically be a bit faster, but more complicated to 
-       install. You will have to download a lot of tools from different webpages, 
-       and install them in the ways they have to be installed. The default 
-       installation location will typically not be the 
-       <filename>C:\Program Files</filename> folder. Have a look at 
-       <xref linkend="ChToolsWin32Recommended"/> for an overview of the 
-       recommended tools.
-       </para>
-       </section>
-       
-       <section id="ChToolsInstallCygwin">
-       <title>Win32 Cygwin</title>
-       <para>
-       Installation of the Cygwin tools is very simple. As Cygwin uses an 
-       UNIX emulation layer,
-       it might be a bit slower compared to the native tools, but at an 
-       acceptable level. All tools will be installed into one base folder, the 
-       default is <filename>C:\cygwin</filename>.
-       </para>
-       <para>
-       Cygwin provides a UNIX emulation layer with a lot of UNIX based tools
-       on the Win32 platform. Although Cygwin consists of several
-       seperate packages, the installation and update is done through a
-       single setup.exe, which acts similar to other web based installers.
-       </para>
-       <para>
-       You will find this network based setup.exe at: <ulink 
-       url="http://www.cygwin.com/"/>. Click on one
-       of the "Install Cygwin now" appearances. This will start the download
-       of the setup.exe.
-       </para>
-       <para>
-       After the download completed, start this setup.exe on your machine. It
-       will ask you for some
-       settings, the defaults should usually work well. The setup will
-       then download and install a basic set of packages.
-       </para>
-       <para>
-       Under: "Start -&gt; Programs -&gt; Cygwin -&gt; Cygwin Bash Shell" you
-       should now be able to start a new Cygwin bash shell, which is similar to 
-       the command line (command.exe/cmd.exe) in Win32, but much more powerful.
-       </para>
-       <para>
-       If you want to add additional, update installed or remove packages, you 
-       should start the setup.exe again. At the "Select Packages" page, the 
-       entry in the "New" column will control what is done (or not) with the 
-       package. If a new version of a package is available, the new version 
-       number will be displayed, so it will be automatically updated. You can 
-       change the current setting by simply clicking at it, it will change 
-       between:
-       <itemizedlist>
-       <listitem>
+  </section>
+
+  <section id="ChToolsInstallWin32">
+  <title>Win32: Installation</title>
        <para>
-       a specific version number - this different package version will be 
-       installed
-       </para>
-       </listitem>
-       <listitem>
+       The tool installation on Win32 can be quite confusing as there are several 
+       ways to do so. 
+       The following will give you a step-by-step guide to install the 
+       development tools in the recommended way.
+       <warning><title>Warning!</title>
        <para>
-       Skip - not installed, no changes
+       <command>Unless you know exactly what you are doing, you should strictly 
+       follow the recommendations!</command>
        </para>
-       </listitem>
-       <listitem>
-       <para>
-       Keep - already installed, no changes
+       </warning>
        </para>
-       </listitem>
-       <listitem>
+
+       <section id="ChToolsInstallWin32Recommended">
+       <title>Recommendations (Cygwin vs. Win32 native)</title>
        <para>
-       Uninstall - uninstall this package
+       Cygwin provides a lot of UNIX based tools on the Win32 platform. It uses
+       a UNIX emulation layer which might be a bit slower compared to the native 
+       Win32 tools, but at an acceptable level.
+       The installation and update is pretty easy and done through a single 
+       (web based) setup.exe.
        </para>
-       </listitem>
-       <listitem>
        <para>
-       Reinstall - reinstall this package
-       </para>
-       </listitem>
-       </itemizedlist>
+       The native Win32 tools will typically be a bit faster, but more 
+       complicated to install. 
+       You will have to download the tools from different webpages, 
+       and install them in different ways, tweaking the PATH and alike. 
        </para>
-       <!--
-       <para>
-       You will find a list of required / recommended packages needed to develop 
-       Ethereal in <xref linkend="ChToolsWin32Recommended"/>.
-       </para> 
-       -->
-       </section>
-  </section>
-
-       <section id="ChToolsWin32Recommended">
-       <title>Win32: Recommended tools</title>
-       <para>
-       As there are different forms of the Win32 tools available, the following 
-       will give an overview of the recommended tools (which are highlighted in 
-       bold face).
        <note><title>Note!</title>
        <para>
-       <command>Unless you know exactly what you are doing, you should strictly 
-       following these recommendations!</command>
+       As there's no Win32 native bash version available, at least a basic 
+       installation of cygwin is required in any case.
        </para>
        </note>
+       <para>
+       For all these reasons, the following recommends to use Cygwin tools where 
+       appropriate.
+       </para>
        
-       <table frame='all'><title>The mandatory tools</title>
-       <tgroup cols='3' align='left' colsep='1' rowsep='1'>
+       <para>
+       <table frame='all'><title>The recommended tools</title>
+       <tgroup cols='4' align='left' colsep='1' rowsep='1'>
        <colspec colname='c1'/>
        <colspec colname='c2'/>
        <colspec colname='c3'/>
+       <colspec colname='c4'/>
        <thead>
        <row>
          <entry>Tool</entry>
-         <entry><link linkend="ChToolsInstallCygwin">Cygwin</link> package</entry>
+         <entry><link linkend="ChToolsInstallCygwin">Cygwin</link> (Category/Package)</entry>
          <entry>Win32 native</entry>
+         <entry>Remark</entry>
        </row>
        </thead>
        <tbody>
-       <row>
-         <entry><xref linkend="ChToolsBash"/></entry>
-         <entry><command>bash</command></entry>
-         <entry>-</entry>
-       </row>
        <row>
          <entry><xref linkend="ChToolsCompiler"/></entry>
-         <entry>gcc</entry>
-         <entry><command>cl.exe (MSVC)</command></entry>
+         <entry>-</entry>
+         <entry>cl.exe (MSVC V6)</entry>
        </row>
        <row>
          <entry><xref linkend="ChToolsDebugger"/></entry>
-         <entry>DDD</entry>
-         <entry><command>integrated debugger (MSVC)</command></entry>
+         <entry>-</entry>
+         <entry>integrated debugger (MSVC V6)</entry>
        </row>
        <row>
          <entry><xref linkend="ChToolsMake"/></entry>
-         <entry>make</entry>
-         <entry><command>nmake.exe (MSVC)</command></entry>
-       </row>
-       <row>
-         <entry><xref linkend="ChToolsPython"/></entry>
-         <entry><command>python</command></entry>
-         <entry><ulink url="http://python.org/download/"/></entry>
+         <entry>-</entry>
+         <entry>nmake.exe (MSVC V6)</entry>
        </row>
        <row>
-         <entry><xref linkend="ChToolsPerl"/></entry>
-         <entry><command>perl</command></entry>
-         <entry><ulink url="http://www.ActiveState.com"/></entry>
+         <entry><xref linkend="ChToolsBash"/></entry>
+         <entry>Base/bash</entry>
+         <entry>-</entry>
+         <entry>No Win32 native version available!</entry>
        </row>
        <row>
          <entry><xref linkend="ChToolsSed"/></entry>
-         <entry><command>sed (default installed)</command></entry>
-         <entry><ulink url="http://gnuwin32.sourceforge.net/"/></entry>
-       </row>
-       <row>
-         <entry><xref linkend="ChToolsYacc"/></entry>
-         <entry><command>bison</command></entry>
-         <entry><ulink url="http://gnuwin32.sourceforge.net/"/></entry>
-       </row>
-       <row>
-         <entry><xref linkend="ChToolsLexx"/></entry>
-         <entry><command>flex</command></entry>
-         <entry><ulink url="http://gnuwin32.sourceforge.net/"/></entry>
+         <entry>Base/sed</entry>
+         <entry>-</entry>
        </row>
-       </tbody>
-       </tgroup>
-       </table>        
-       
-       <table frame='all'><title>The optional tools</title>
-       <tgroup cols='3' align='left' colsep='1' rowsep='1'>
-       <colspec colname='c1'/>
-       <colspec colname='c2'/>
-       <colspec colname='c3'/>
-       <thead>
        <row>
-         <entry>Tool</entry>
-         <entry><link linkend="ChToolsInstallCygwin">Cygwin</link> package</entry>
-         <entry>Win32 native</entry>
+         <entry><xref linkend="ChToolsPython"/></entry>
+         <entry>Interpreters/python</entry>
+         <entry>-</entry>
        </row>
-       </thead>
-       <tbody>
        <row>
-         <entry><xref linkend="ChToolsSubversion"/></entry>
-         <entry>svn</entry>
-         <entry><command><ulink url="http://tortoisesvn.tigris.org/">TortoiseSVN</ulink></command></entry>
+         <entry><xref linkend="ChToolsPerl"/></entry>
+         <entry>Interpreters/perl</entry>
+         <entry>-</entry>
        </row>
        <row>
-         <entry><xref linkend="ChToolsDiff"/></entry>
-         <entry><command>diff (default installed)</command></entry>
-         <entry><ulink url="http://gnuwin32.sourceforge.net/"/></entry>
+         <entry><xref linkend="ChToolsYacc"/></entry>
+         <entry>Devel/bison</entry>
+         <entry>-</entry>
        </row>
        <row>
-         <entry><xref linkend="ChToolsPatch"/></entry>
-         <entry><command>patch (default installed)</command></entry>
-         <entry><ulink url="http://gnuwin32.sourceforge.net/"/></entry>
+         <entry><xref linkend="ChToolsLexx"/></entry>
+         <entry>Devel/flex</entry>
+         <entry>-</entry>
        </row>
        <row>
          <entry><xref linkend="ChToolsWget"/></entry>
-         <entry><command>wget</command></entry>
-         <entry><ulink url="http://gnuwin32.sourceforge.net"/></entry>
+         <entry>Web/wget</entry>
+         <entry>-</entry>
        </row>
        <row>
          <entry><xref linkend="ChToolsUnzip"/></entry>
-         <entry><command>unzip</command></entry>
-         <entry><ulink url="http://gnuwin32.sourceforge.net"/></entry>
+         <entry>Archive/unzip</entry>
+         <entry>-</entry>
+       </row>
+       <row>
+         <entry><xref linkend="ChToolsSubversion"/></entry>
+         <entry>-</entry>
+         <entry><ulink url="http://tortoisesvn.tigris.org/">TortoiseSVN</ulink></entry>
+         <entry>Only needed if you access the Ethereal sources using 
+         the subversion repository (the recommended way).</entry>
        </row>
        <row>
          <entry><xref linkend="ChToolsNSIS"/></entry>
          <entry>-</entry>
-         <entry>
-         <command><ulink url="http://nsis.sourceforge.net">NSIS</ulink></command>
-         </entry>
+         <entry><ulink url="http://nsis.sourceforge.net">NSIS</ulink></entry>
+         <entry>Only needed if you want to build your own 
+         ethereal-setup.exe.</entry>
        </row>
        </tbody>
        </tgroup>
-       </table>        
+       </table>
+       Don't get confused by the (optional) marker at some of the items in the 
+       "Tool" column. 
+       Although these tools are not required to <command>build</command> 
+       Ethereal they can make development life much easier and some are even 
+       required by the following installation procedure.
        </para>
        </section>
 
-       <section id="ChToolsBash">
-       <title>bash</title>
+       <section id="ChToolsInstallMSVC">
+       <title>Install Microsoft Visual Studio Version 6</title>
        <para>
-       The bash shell is needed to run several shell scripts.
+       Install MSVC the usual way. Don't forget to install vcvars32.bat or call 
+       it manually before building Ethereal. vcvars32.bat will set some required 
+       environment settings.
        </para>
-       
-       <section id="ChToolsGNUBash">
-       <title>UNIX or Win32 Cygwin: GNU bash</title>
+       <warning><title>Warning!</title>
        <para>
-       The bash is available for most of the UNIX-like platforms and as the 
-       <application>bash</application> package from the <link 
-       linkend="ChToolsInstallCygwin">Cygwin setup</link>.
+       Using any other MSVC version is not recommended and will certainly not 
+       work (at least without a lot of advanced tweaking). 
+       For further details on this topic, see <xref linkend="ChToolsCompiler"/>.
        </para>
+       </warning>
+       </section>
+       <section id="ChToolsInstallCygwin">
+       <title>Install Cygwin</title>
        <para>
-       If the bash isn't already installed and also not available as a package 
-       for your platform, you can get it at: 
-       <ulink url="http://www.gnu.org/software/bash/bash.html"/>.
+       Although Cygwin consists of several     seperate packages, the installation 
+       and update is done through a single setup.exe, which acts similar to other 
+       web based installers.
+       All tools will be installed into one base folder, the default is 
+       <filename>C:\cygwin</filename>.
        </para>
        <para>
-       After correct installation, typing inside any shell:
+       You will find this network based setup.exe at: <ulink 
+       url="http://www.cygwin.com/"/>. Click on one of the "Install Cygwin now" 
+       appearances to download the <filename>setup.exe</filename>.
+       After the download completed, start this <filename>setup.exe</filename> 
+       on your machine. 
+       </para>
+       <para>
+       The setup will ask you for some settings, the defaults should usually 
+       work well for a first start. 
+       At the "Select Packages" page, you'll need to select some additional 
+       packages, which are not installed by default. 
+       Navigate to the required Category/Package row and click on the "Skip" 
+       item in the "New" column so it shows a version number for:
+       <itemizedlist>
+       <listitem><para>
+       Archive/unzip
+       </para></listitem>
+       <listitem><para>
+       Devel/bison
+       </para></listitem>
+       <listitem><para>
+       Devel/flex
+       </para></listitem>
+       <listitem><para>
+       Interpreters/perl
+       </para></listitem>
+       <listitem><para>
+       Interpreters/python
+       </para></listitem>
+       <listitem><para>
+       Utils/patch
+       </para></listitem>
+       <listitem><para>
+       Web/wget
+       </para></listitem>
+       </itemizedlist>
+       </para> 
+       After clicking the Next button several times, the setup will then 
+       download and install the selected packages (this may take a while).
+       <para>
+       Under: "Start -&gt; Programs -&gt; Cygwin -&gt; Cygwin Bash Shell" you
+       should now be able to start a new Cygwin bash shell, which is similar to 
+       the command line (command.exe/cmd.exe) in Win32, but much more powerful.
        </para>
+       <section id="ChToolsInstallCygwinPackages">
+       <title>Add/Update/Remove Cygwin Packages</title>        
+       <para>
+       If you want to add additional, update installed or remove packages later, 
+       you have to start the setup.exe again. 
+       At the "Select Packages" page, the entry in the "New" column will control 
+       what is done (or not) with the package. If a new version of a package is 
+       available, the new version number will be displayed, so it will be 
+       automatically updated. 
+       You can change the current setting by simply clicking at it, it will 
+       change between:
+       <itemizedlist>
+       <listitem>
        <para>
-       <prompt>$</prompt> <userinput>bash --version</userinput>
+       a specific version number - this different package version will be 
+       installed
        </para>
+       </listitem>
+       <listitem>
        <para>
-       should result in something like:
-       <programlisting>
-<![CDATA[GNU bash, version 2.05b.0(1)-release (i686-pc-cygwin)
-Copyright (C) 2002 Free Software Foundation, Inc.]]>
-       </programlisting>
-       However, the version string may vary.
+       Skip - not installed, no changes
+       </para>
+       </listitem>
+       <listitem>
+       <para>
+       Keep - already installed, no changes
+       </para>
+       </listitem>
+       <listitem>
+       <para>
+       Uninstall - uninstall this package
+       </para>
+       </listitem>
+       <listitem>
+       <para>
+       Reinstall - reinstall this package
+       </para>
+       </listitem>
+       </itemizedlist>
        </para>
        </section>
-       
-       <section id="ChToolsWin32Bash">
-       <title>Win32 native: -</title>
+       </section>
+
+       <section id="ChToolsInstallAdditional">
+       <title>Install Additional Tools</title> 
        <para>
-       The authors don't know of any working Win32 native bash implementation.
+       Depending on your actual task the following tools are recommended. 
+       Please note that they are not required to build Ethereal but can be 
+       quite helpful.
+       </para>
+       <section>
+       <title>TortoiseSVN</title>
+       <para>
+       If you want to work with the Ethereal subversion source repositories 
+       (which is highly recommended, see <xref linkend="ChSrcObtain"/>), 
+       it's recommended to use TortoiseSVN. You can download the setup from 
+       <ulink url="http://tortoisesvn.tigris.org/"/> and simply install it.
        </para>
        </section>
+       <section>
+       <title>Nullsoft Scriptable Install System (NSIS)</title>
+       <para>
+       If you want to build your own ethereal-setup.exe, you'll need NSIS. 
+       You can download the NSIS setup from 
+       <ulink url="http://nsis.sourceforge.net"/> and simply install it.
+       </para>
+       <para>
+       You may check the MAKENSIS setting in the file 
+       <filename>config.nmake</filename> of the Ethereal sources.
+       </para>
+       </section>
+       </section>
+
+       <section id="ChToolsWin32Verify">
+       <title>Verify installed tools</title>
+       <para>
+       After you've installed the Ethereal sources (see <xref 
+       linkend="ChSrcObtain"/>), you can check the correct installation of 
+       all tools by using the verify_tools target of the 
+       <filename>Makefile.nmake</filename> from the source package.
+       </para>
+       <warning><title>Warning!</title>
+       <para>
+       You will need the Ethereal sources and some tools (nmake, bash) installed, 
+       before this verification is able to work.
+       </para>
+       </warning>
+       <para>
+       Enter at the command line (cmd.exe, not Cygwin's bash!):
+       </para>
+       <para>
+       <prompt>&gt;</prompt> 
+       <userinput>nmake -f Makefile.nmake verify_tools</userinput>
+       </para>
+       <para>
+       This will check for the various tools needed to build Ethereal:
+       </para>
+       <para>
+       <programlisting>
+<![CDATA[Checking for required applications:
+        cl: /cygdrive/c/Program Files/Microsoft Visual Studio/VC98/bin/cl
+        link: /cygdrive/c/Program Files/Microsoft Visual Studio/VC98/bin/link
+        nmake: /cygdrive/c/Program Files/Microsoft Visual Studio/VC98/bin/nmake
 
+        bash: /usr/bin/bash
+        bison: /usr/bin/bison
+        flex: /usr/bin/flex
+        env: /usr/bin/env
+        grep: /usr/bin/grep
+        /usr/bin/find: /usr/bin/find
+        perl: /usr/bin/perl
+        env: /usr/bin/env
+        python: /usr/bin/python
+        sed: /usr/bin/sed
+        unzip: /usr/bin/unzip
+        wget: /usr/bin/wget]]>
+       </programlisting>
+       </para> 
+       <para>  
+       If you have problems with all the first three ones, check if you called 
+       ...\Microsoft Visual Studio\VC98\Bin\vcvars32.bat before 
+       (which will "fix" your PATH settings).
+       </para> 
+       <para>  
+       Unfortunately, the link command is defined both from cygwin and from MSVC 
+       with completely different purpose, you'll need the MSVC link. 
+       If your link command looks something like: /usr/bin/link, the link command 
+       of cygwin takes precedence over the MSVC one. To fix this, you can change 
+       your PATH environment setting or simply renaming the link.exe in cygwin. 
+       If you rename it, make sure to remember that a cygwin update may provide 
+       a new version of it.
+       </para> 
+       </section>
        </section>
 
        <section id="ChToolsCompiler">
@@ -354,7 +432,7 @@ Copyright (C) 2002 Free Software Foundation, Inc.]]>
        </note>
        <para>
        The GCC C compiler is available for most of the UNIX-like platforms and 
-       as the <application>gcc</application> package from the <link 
+       as the <application>Devel/gcc</application> package from the <link 
        linkend="ChToolsInstallCygwin">Cygwin setup</link>.
        </para>
        <para>
@@ -490,7 +568,7 @@ usage: cl [ option... ] filename... [ /link linkoption... ]]]>
        <title>UNIX or Win32 Cygwin: GDB (GNU project debugger)</title>
        <para>
        GDB is the debugger for the GCC compiler. It is available for many (if 
-       not all) UNIX-like platforms and as the <application>gdb</application> 
+       not all) UNIX-like platforms and as the <application>Devel/gdb</application> 
        package from the <link 
        linkend="ChToolsInstallCygwin">Cygwin setup</link>      
        </para>
@@ -504,7 +582,7 @@ usage: cl [ option... ] filename... [ /link linkoption... ]]]>
        <ulink url="http://www.gnu.org/software/gdb/gdb.html"/>.
        </para>
        <para>
-       After correct installation, typing inside the bash:
+       After correct installation:
        </para>
        <para>
        <prompt>$</prompt> <userinput>gdb --version</userinput>
@@ -583,7 +661,7 @@ This GDB was configured as "i686-pc-cygwin".]]>
        </note>
        <para>
        GNU Make is available for most of the UNIX-like platforms and 
-       also as the <application>make</application> package from the <link 
+       also as the <application>Devel/make</application> package from the <link 
        linkend="ChToolsInstallCygwin">Cygwin setup</link>.
        </para>
        <para>
@@ -592,7 +670,7 @@ This GDB was configured as "i686-pc-cygwin".]]>
        <ulink url="http://www.gnu.org/software/make/"/>.
        </para>
        <para>
-       After correct installation, typing inside the bash:
+       After correct installation:
        </para>
        <para>
        <prompt>$</prompt> <userinput>make --version</userinput>
@@ -674,6 +752,49 @@ Stop.]]>
 
        </section>
 
+       <section id="ChToolsBash">
+       <title>bash</title>
+       <para>
+       The bash shell is needed to run several shell scripts.
+       </para>
+       
+       <section id="ChToolsGNUBash">
+       <title>UNIX or Win32 Cygwin: GNU bash</title>
+       <para>
+       The bash is available for most of the UNIX-like platforms and as the 
+       <application>bash</application> package from the <link 
+       linkend="ChToolsInstallCygwin">Cygwin setup</link>.
+       </para>
+       <para>
+       If the bash isn't already installed and also not available as a package 
+       for your platform, you can get it at: 
+       <ulink url="http://www.gnu.org/software/bash/bash.html"/>.
+       </para>
+       <para>
+       After correct installation, typing inside any shell:
+       </para>
+       <para>
+       <prompt>$</prompt> <userinput>bash --version</userinput>
+       </para>
+       <para>
+       should result in something like:
+       <programlisting>
+<![CDATA[GNU bash, version 2.05b.0(1)-release (i686-pc-cygwin)
+Copyright (C) 2002 Free Software Foundation, Inc.]]>
+       </programlisting>
+       However, the version string may vary.
+       </para>
+       </section>
+       
+       <section id="ChToolsWin32Bash">
+       <title>Win32 native: -</title>
+       <para>
+       The authors don't know of any working Win32 native bash implementation.
+       </para>
+       </section>
+
+       </section>
+
 
        <section id="ChToolsPython">
        <title>python</title>
@@ -973,10 +1094,10 @@ warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.]]>
        </para>
 
        <section id="ChToolsUnixSVN">
-       <title>UNIX or Win32 Cygwin: svn</title>
+       <title>UNIX or Win32 Cygwin: svn (subversion)</title>
        <para>
        SVN is available for most of the UNIX-like platforms and as the 
-       <application>SVN</application> package from the <link 
+       <application>Devel/subversion</application> package from the <link 
        linkend="ChToolsInstallCygwin">Cygwin setup</link>
        </para>
        <para>
@@ -1252,66 +1373,5 @@ written by Larry Wall and Paul Eggert]]>
        </section>
 
 
-       <section id="ChToolsWin32Verify">
-       <title>Win32: Verify installed tools</title>
-       <para>
-       After you've installed the Ethereal sources (see <xref 
-       linkend="ChSrcObtain"/>), you can check the correct installation of 
-       all tools by using the verify_tools target of the 
-       <filename>Makefile.nmake</filename> from the source package.
-       </para>
-       <warning><title>Warning!</title>
-       <para>
-       You will need the Ethereal sources and some tools (nmake, bash) installed, 
-       before this verification is able to work.
-       </para>
-       </warning>
-       <para>
-       Enter at the command line:
-       </para>
-       <para>
-       <prompt>&gt;</prompt> 
-       <userinput>nmake -f Makefile.nmake verify_tools</userinput>
-       </para>
-       <para>
-       This will check for the various tools needed to build Ethereal:
-       </para>
-       <para>
-       <programlisting>
-<![CDATA[Checking for required applications:
-        cl: /cygdrive/c/Program Files/Microsoft Visual Studio/VC98/bin/cl
-        link: /cygdrive/c/Program Files/Microsoft Visual Studio/VC98/bin/link
-        nmake: /cygdrive/c/Program Files/Microsoft Visual Studio/VC98/bin/nmake
-
-        bash: /usr/bin/bash
-        bison: /usr/bin/bison
-        flex: /usr/bin/flex
-        env: /usr/bin/env
-        grep: /usr/bin/grep
-        /usr/bin/find: /usr/bin/find
-        perl: /usr/bin/perl
-        env: /usr/bin/env
-        python: /usr/bin/python
-        sed: /usr/bin/sed
-        unzip: /usr/bin/unzip
-        wget: /usr/bin/wget]]>
-       </programlisting>
-       </para> 
-       <para>  
-       If you have problems with all the first three ones, check if you called 
-       ...\Microsoft Visual Studio\VC98\Bin\vcvars32.bat before 
-       (which will "fix" your PATH settings).
-       </para> 
-       <para>  
-       Unfortunately, the link command is defined both from cygwin and from MSVC 
-       with completely different purpose, you'll need the MSVC link. 
-       If your link command looks something like: /usr/bin/link, the link command 
-       of cygwin takes precedence over the MSVC one. To fix this, you can change 
-       your PATH environment setting or simply renaming the link.exe in cygwin. 
-       If you rename it, make sure to remember that a cygwin update may provide 
-       a new version of it.
-       </para> 
-       </section>
-
 </chapter>
 <!-- End of EUG Chapter Tools -->