[gtk-web] Revamp the download page for Windows

[Emmanuele Bassi <ebassi src gnome org>]

commit 8d768a1f55dab8a86c0b7c98ee805a927de25890
Author: Luis Menina <liberforce freeside fr>
Date:   Mon Mar 13 18:55:57 2017 +0100

    Revamp the download page for Windows
    
    It now gives more information about the packages one needs to install in
    MSYS2.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=779994

 download/windows.php |   87 +++++++++++++++++++++++++++++++++++++++-----------
 1 files changed, 68 insertions(+), 19 deletions(-)
---
diff --git a/download/windows.php b/download/windows.php
index 3431e19..15e8dc5 100755
--- a/download/windows.php
+++ b/download/windows.php
@@ -5,33 +5,82 @@ ob_start();
 ?>
 <h2><a name="Download">Download for Windows</a></h2>
 
+<p>Note: These instructions are intended for developpers wanting to develop applications based on GTK+, not 
for end-users.</p>
+
 <h3><a name="Requirements">Requirements</a></h3>
  
-<h4>Packages</h4>
- 
-<p>You will need the GLib, cairo, Pango, ATK, gdk-pixbuf and GTK+ developer packages to build software 
against GTK+. To run GTK+ programs you will also need the gettext-runtime, fontconfig, freetype, expat, 
libpng and zlib packages.</p>
+<h4>Windows version</h4>
+<p>GTK+ requires Windows Vista or later.</p>
 
-<p>This page is not intended directly for end-users. It is expected that people who build installers for 
GTK+ applications for Windows bundle GTK+ with them.</p>
- 
-<p>You are welcome to redistribute GTK+ binaries, including applications that bundle them, on other web 
sites, CD-ROM, and other media. You don't have to ask for permission. That's one of the points of Free 
Software. One important thing that the <a href="http://www.fsf.org/licenses/licenses.html";>GNU licenses</a> 
require is that <strong>you must also redistribute the source</strong> code. This usually means at least the 
gettext, GLib, GTK+, Pango and Atk sources.</p>
- 
-<h4>Downloading GTK and its dependencies</h4>
+<p>For older versions of Windows, you should do a custom build of older versions of GLib and GTK+.</p>
+
+<h3>Installing GTK+ and its dependencies</h3>
+
+<p>The easiest way to install GTK+ and its dependencies in binary form is through the <a 
href="https://msys2.github.io/";>MSYS2</a> project. MSYS2 provides a UNIX-like development environment for 
Windows. It provides packages for many software applications and libraries, including the GTK+ stack. These 
packages are installed using the <a 
href="https://github.com/msys2/msys2/wiki/MSYS2-installation#iv-general-package-management";>pacman package 
manager</a>.</p>
+
+<p>Note: in the following steps, we'll assume you're using a 64-bits Windows. Therefore, the package names 
include the <tt>x86_64</tt> architecture identifier. If you're using a 32-bits Windows, please adapt the 
instructions below using the <tt>i686</tt> architecture identifier.</p>
+
+<h4>Step 1: Install MSYS2</h4>
+<a href="https://msys2.github.io/";>Download the MSYS2 installer</a> that matches your platform and follow 
the installation instructions.
+
+<h4>Step 2: Install GTK+3 and its dependencies</h4>
+
+<p>Open a MSYS2 shell, and run:</p>
+<tt>pacman -S mingw-w64-x86_64-gtk3</tt>
+
+<h4>Step 3 (recommended): Install GTK+ core applications</h4>
+<p><strong>Glade</strong> is a GUI designer for GTK+. It lets you design your GUI and export it in XML 
format.
+You can then import your GUI from your code using the <tt>GtkBuilder</tt> API. Read the <tt>GtkBuilder</tt> 
section in GTK+ manual for more information.</p>
+<p>To install Glade:</p>
+<tt>pacman -S mingw-w64-x86_64-glade</tt>
+
+<p><strong>Devhelp</strong> is a help browser. It lets you easily navigate offline in the GTK+, glib and 
gobject API help relative to the version of these libraries installed on your system.</p>
+<p>To install Devhelp:</p>
+<tt>pacman -S mingw-w64-x86_64-devhelp</tt>
+
+<h4>Step 4 (optional): Install the python bindings</h4>
+<p>If you want to develop a GTK+3 application in python, you need to install the python bindings.</p>
+
+<p>If you develop in python 3:</p>
+<tt>pacman -S mingw-w64-x86_64-python3-gobject</tt>
+
+<p>If you develop in python 2:</p>
+<tt>pacman -S mingw-w64-x86_64-python2-gobject</tt>
+
+<h4>Step 5 (optional): Install build tools</h4>
+<p>If you want to develop a GTK+3 application in other languages like C, C++, Fortran, etc, you'll need a 
compiler like gcc and other development tools:</p>
+<tt>pacman -S mingw-w64-x86_64-toolchain base-devel</tt>
 
-<p>The preferred way to obtain GTK+ and its dependencies in binary form for Windows is to use the <a 
href="https://msys2.github.io/";>MSYS2</a> project.</p>
+<h2>Building and distributing your application</h2>
 
-<p>You can use the installer to set up the MSYS2 environment for developing your application by following 
the instructions on the
-website. MSYS2 provides packages for the GTK stack, so all you have to do is install them and build your 
application inside the MSYS2
-environment. You can also use MSYS2 to build your application, and create an installer with all the build 
artifacts necessary for
-distributing it. You can find more information in <a 
href="https://blogs.gnome.org/nacho/2014/08/01/how-to-build-your-gtk-application-on-windows/";>this 
article</a>.</p>
+<h3>Building your application with MSYS2</h3>
+<p>You may use MSYS2 to <a 
href="https://blogs.gnome.org/nacho/2014/08/01/how-to-build-your-gtk-application-on-windows/";>build your GTK+ 
application and create an installer to distribute it</a>. Your installer will need to ship your application 
build artifacts as well as GTK+ binaries and runtime dependencies.</p>
 
-<p>GTK releases also provide project files for Microsoft Visual Studio, which you can use to build GTK 
itself and use it in your own
-project. You can find more information on <a 
href="https://wiki.gnome.org/Projects/GTK+/Win32/MSVCCompilationOfGTKStack";>the Wiki</a>
-and in <a href="https://blogs.gnome.org/nacho/2015/02/19/building-gtk-3-with-msvc-2013/";>this 
article</a>.</p>
+<h3>Building your application with Visual Studio</h3>
+<p>GTK+ releases provide project files for Microsoft Visual Studio. You can use them to build GTK+ itself 
and use it in your own project. Learn more on <a 
href="https://wiki.gnome.org/Projects/GTK+/Win32/MSVCCompilationOfGTKStack";>how to build the GTK+ stack using 
Microsoft Visual Studio</a> and read these other tips on <a 
href="https://blogs.gnome.org/nacho/2015/02/19/building-gtk-3-with-msvc-2013/";>how to build GTK+ with MSVC on 
Windows</a>.</p>
 
-<h4>Which Windows versions?</h4>
-<p>The current GTK+ stack uses APIs that are available only on Windows Vista or later.</p>
+<h3>Distributing GTK+ with your application</h3>
+<p>You are welcome to redistribute GTK+ binaries, including applications that bundle them, on other web 
sites, CD-ROM, and other media. You don't have to ask for permission. That's one of the points of Free 
Software. One important thing that the <a href="http://www.fsf.org/licenses/licenses.html";>GNU licenses</a> 
require is that <strong>you must also redistribute the source code</strong>. This usually means at least the 
gettext, GLib, GTK+, Pango and Atk sources.</p>
 
-<p>If you require builds for unsupported versions of Windows, you should do a custom build of an older 
version of GLib and GTK+.</p>
+<h4>List of GTK+ dependencies</h4>
+<p>GTK+ depends on several libraries:
+<ul>
+<li>GLib</li>
+<li>cairo</li>
+<li>Pango</li>
+<li>ATK</li>
+<li>gdk-pixbuf</li>
+</ul>
+</p>
 
+<p>To run GTK+ programs you will also need:
+<ul>
+<li>gettext-runtime</li>
+<li>fontconfig</li>
+<li>freetype</li>
+<li>expat</li>
+<li>libpng</li>
+<li>zlib</li>
+</p>
 
 <?php require '../template.php';