Changes between Version 53 and Version 54 of BoostDocs/GettingStarted

Timestamp:

May 26, 2010, 3:50:30 PM (12 years ago)

Author:

Beman Dawes

Comment:

Add instructions for Windows command prompt with Cygwin tools

BoostDocs/GettingStarted

@@ -20 +20 @@
 [[Image(https://svn.boost.org/trac/boost/raw-attachment/wiki/BoostDocs/GettingStarted/documentation-toolchain.png)]]
 
-=== Windows ===
+=== Windows, running under the Windows command prompt and using Cygwin tools ===
+
+First, you need to get the boost build tools set up.
+
+Install these [http://www.cygwin.com Cygwin] packages:
+
+  * `Libs/libxml2`
+  * `Libs/libxslt`
+  * `Text/docbook-xml42`
+  * `Text/docbook-xsl`
+  * `Devel/gcc4-g++` (optional, if you don't already have a compiler)
+  * `Devel/doxygen` (optional, used for several libraries)
+  * `Text/tetex-extra` (optional, used for the accumulators library documentation)
+  * `Graphics/ghostscript` (optional, also used for the accumulators library documentation)
+
+As of Cygwin 1.7.5, May 2010, the Cygwin installation isn't using Windows symlinks for a few packages, so you
+will need to set up your own in the Cygwin bin directory:
+
+  * `cd ''cygwin-root''/bin`
+  * `mklink latex.exe pdfetex.exe`
+  * `mklink gswin32c.exe gs.exe`
+
+If you have an older version of Windows that doesn't support symlinks, you might try copying pdfetex.exe -> latex.exe and gs.exe -> gwsin32c.exe. 
+
+Build bjam. Be sure to under the Windows command prompt rather than Cygwin bash:
+
+  * `cd ''boost-root''/tools/jam/src`
+  * `build`
+  * copy `bin.ntx86\bjam.exe` to a directory in your path.
+
+Be sure your home directory bjam configuration file (`%HOMEDRIVE%\%HOMEPATH%\user-config.jam`) is set up correctly:
+
+{{{
+using msvc ;  # or some other compiler
+
+using xsltproc ;
+
+using boostbook
+    : c:/boost/docbook/xsl
+    : c:/boost/docbook/dtd
+    ;
+
+using doxygen ;
+using quickbook ;
+}}}
+
+=== Windows, running under the Windows command prompt and using manually downloaded tools ===
 
 First, you need to get the boost build tools set up, see [http://www.boost.org/doc/libs/1_37_0/more/getting_started/index.html the getting started guide] for an introduction.
@@ -71 +117 @@
 }}}
 
-=== Cygwin ===
+=== Windows, running under bash and using Cygwin tools ===
 
 First, you need to get the boost build tools set up. `bjam` will need to be built using cygwin, so don't use the prebuilt windows binary.