[cairo-commit] [cairo-www] src/download.mdwn

[Carl Worth]

 src/download.mdwn |   31 +++++++++++++++++++++++++++----
 1 file changed, 27 insertions(+), 4 deletions(-)

New commits:
commit 944dddcffacbb8ab7ae68dee44089957cb41546f
Author: ionous <noise at ionous.net>
Date:   Fri Aug 24 18:57:51 2007 -0700

    added to the windows section to detail how to get cygwin, and what packages are needed to install.  updated the top "visual studio" link to tell all users there's more information on building the source below.

diff --git a/src/download.mdwn b/src/download.mdwn
index 3dee7ff..966b031 100644
--- a/src/download.mdwn
+++ b/src/download.mdwn
@@ -5,9 +5,9 @@
 ## Releases
 
 Please download one of the latest [releases](/releases) in order to
-get an API-stable version of cairo.
+get an API-stable version of cairo. 
 
-( Additional Visual Studio specific files can be found [here](http://cairographics.org/visualstudio/). )
+See In-Progress Development ( [below](#development)) for details on getting and building the latest source.
 
 ## Binary Packages
 
@@ -84,7 +84,7 @@ In general, fink is more conservative about upgrading packages than
 Macports, so the Macports version will be closer to the bleeding edge,
 while the fink version may well be more stable.
 
-# In-Progress Development
+<h1 id="development">In-Progress Development</h1>
 
 If you want to stay on the absolute cutting-edge of what's happening
 with cairo, and you don't mind playing with software that is unstable
@@ -103,7 +103,7 @@ The cairo library itself is maintained with the
 source online using the [gitweb
 interface](http://gitweb.freedesktop.org/?p=cairo).
 
-## Downloading with git
+<h2 id="git"> Downloading the source with git </h2>
 
 You may also use git to clone a local copy of the cairo library source
 code. The following git commands are provided for your cut-and-paste
@@ -134,6 +134,29 @@ check for a git-core package as well), you can get tar files from
 
 There is a port of git to the [Cygwin](http://www.cygwin.com/) environment.
 
+For users new to Cygwin, it's fairly straight forward to install.
+Simply download and run the Cygwin Setup.exe from its site.
+Walk through the initial dialog boxes until you reach the "Select Packages" page.
+Click the "View" button to display an alphabetical list of packages and select the 'git' package.
+
+If you want to build using gcc, you will also need to select the following packages:
+
+* 'automake' ( anything >=1.7 )
+* 'gcc-core' 
+* 'git' ( no need to click on this again if you did so above )
+* 'gtkdoc'
+* 'libtool' 
+* 'pkg-config' 
+
+Whether you build with gcc or not:
+
+Click 'Next' and Cygwin setup will download all you need.
+After downloading, go to the directory where Cygwin is installed, and run "cygwin.bat". This will open a command prompt.
+[Mount](http://www.cygwin.com/cygwin-ug-net/using-utils.html#mount) an existing directory on your hard drive,
+cd to that directory, and then follow the "Downloading with git" instructions [above](#git).
+
+If you want to build using Visual Studio and still want the latest source, you *will* need cygwin, but you will only need to select the 'git' package.  See the [Visual Studio](http://cairographics.org/visualstudio/) page for more details.
+
 ## CVS repository for supporting modules
 Previously, cairo was maintained with cvs. Some of the supporting
 modules for cairo, (such as language bindings), are still maintained