[gtk-web/gtk-osx] Gtk-OSX: Improve the flow of the page and fix some small issues

[Martyn James Russell <mr src gnome org>]

commit 91b2072bdd88893dd66d5a214f6e6ae8552bbc50
Author: Martyn Russell <martyn lanedo com>
Date:   Mon Oct 3 09:13:48 2011 +0100

    Gtk-OSX: Improve the flow of the page and fix some small issues
    
    Try to highlight the features and fixed some typos in places.

 download/macos.php |  104 +++++++++++++++++++++++++++-------------------------
 1 files changed, 54 insertions(+), 50 deletions(-)
---
diff --git a/download/macos.php b/download/macos.php
index c7f3f50..f9cc506 100755
--- a/download/macos.php
+++ b/download/macos.php
@@ -5,66 +5,72 @@ ob_start();
 ?>
 
 <h2><a name="Download">Download for Mac OS X</a></h2>
-<p>Do you have a favorite GTK+  application that you'd like to
+
+<h3>About</h3>
+<p>Do you have a favorite GTK+ application that you'd like to
 run on your Mac, but you don't really like X-Windows, MacPorts, or
 Fink? Maybe you'd like to have a more Mac-like look and feel, with the
 menus up on the menu bar and standard Mac keyboard shortcuts like
-Command-Q?
-</p>
-
-<p>
-Or do you  maintain a GTK+ application and want to
+Command-Q? Perhaps you maintain a GTK+ application and want to
 expand your user base to Mac users who want a Mac experience, not a
 transplanted Unix experience?
 </p>
 
-<p> <strong>GTK-OSX</strong> can help. </p>
+<h3>Features</h3>
+<p>Integration with GTK+'s <a
+href="http://live.gnome.org/GTK%2B/OSX";>Quartz backend</a> provides a
+number of <a
+href="http://live.gnome.org/GTK%2B/OSX/Integration";>benefits</a> when
+running your GTK+ application on Mac OS:
+<ul>
+<li>Connection between your application and the Mac's display, mouse,
+and keyboard</li>
+<li>Application's menus integrate with the Mac Menubar</li>
+<li>Manipulate your application's dock tile</li>
+<li>Receive <q>open</q> events from Finder</li>
+<li>Find resources in your bundle</li>
+</ul>
+</p>
 
-<a href="http://live.gnome.org/GTK%2B/OSX/Building";>Build</a>: With <a
-href="https://live.gnome.org/Jhbuild";>jhbuild</a> and GTK-OSX's
-modulesets, you can build your application and all of its dependent
-libraries with a single command.  </p>
+<h3>Requirements</h3>
+<p>There are a number of requirements that need to be met by your
+system before you can build for OSX. These are updated from time to
+time and kept on the  <a
+href="http://live.gnome.org/GTK%2B/OSX/Building#Prerequisites";>live wiki</a>.</p>
 
-<p> <strong>Integrate</strong>: Gtk's <a
-href="http://live.gnome.org/GTK%2B/OSX";>Quartz Backend</a> provides
-the connection between your application and the Mac's display, mouse,
-and keyboard. <a
-href="http://live.gnome.org/GTK%2B/OSX/Integration";>Gtk-mac-integration</a>
-extends the integration with functions to integrate your Application's
-menus with the Mac Menubar, manipulate the app's dock tile, receive
-"open" events from Finder, and find resources in your bundle.  </p>
+<h3>Building</h3>
+<p><a href="http://live.gnome.org/GTK%2B/OSX/Building";>Building</a> with <a
+href="https://live.gnome.org/Jhbuild";>jhbuild</a> and the GTK-OSX
+modulesets, you can build your application and all of its dependent
+libraries with a single command.</p>
 
-<p>
-<a href="http://live.gnome.org/GTK%2B/OSX/Bundling";>Bundle</a>:
-GTK-OSX's gtk-mac-bundler is an easily configured python program which
-creates an application bundle for you and populates it with your
-application executable and all of the dependent libraries from your
-GTK+ build, changing the installed names as needed to point inside the
-bundle.
-</p>
+<h3>All-in-one bundles</h3>
+<p><a href="http://live.gnome.org/GTK%2B/OSX/Bundling";>Bundling</a>
+with the <strong>gtk-mac-bundler</strong> is an easily configured python
+program which creates an application bundle for you and populates it
+with your application executable and all of the dependent libraries
+from your GTK+ build, changing the installed names as needed to point
+inside the bundle.</p>
 
 <h3>Getting Started</h3>
-
-<p>Make sure that your system meets the <a
-href="http://live.gnome.org/GTK%2B/OSX/Building#Prerequisites";>Prerequisites</a>
-then download and run the <a
+<p>First, make sure that your system meets the requirements as
+mentioned above, then download and run the <a
 href="http://git.gnome.org/browse/gtk-osx/plain/gtk-osx-build-setup.sh";>
-installation script</a>. If your application already has a module,
-everything you need to build your application is handled by
-jhbuild. The <a
-href="http://live.gnome.org/GTK%2B/OSX/Building";>Build</a> page has
-detailed instructions.  </p>
+installation script</a> (gtk-osx-build-setup.sh). If your application
+already has a module, everything you need to build your application is
+handled by jhbuild. The <a
+href="http://live.gnome.org/GTK%2B/OSX/Building";>build</a> page has
+detailed instructions.</p>
 
 <h3>Success Stories</h3>
-
-<p> Some of the projects which have used Gtk-OSX to provide MacOSX
-users with a native installation have <a
-href="http://live.gnome.org/GTK%2B/OSX/PortedApps";>shared the
-news</a>.</p> <p>
-
-<h3>Mailing lists and Web Forum</h3>
-
-<p>Support for building, bundling, and the Gtk-mac-integration library
+<p>Some of the projects which have used GTK+ on Mac OS X have <a
+href="http://live.gnome.org/GTK%2B/OSX/PortedApps";>shared their
+experiences</a> for all to see. If you have any feedback you would
+like to give about your experiences here, please contact us on the
+the users mailing list as mentioned below.</p>
+
+<h3>Mailing lists &amp; web forum</h3>
+<p>Support for building, bundling, and the integration library
 is provided by a <a
 href="http://mail.gnome.org/mailman/listinfo/gtk-osx-users-list";>mailing
 list</a> and a <a
@@ -73,10 +79,8 @@ may wish to subscribe to the <a
 href="http://mail.gnome.org/mailman/listinfo/gtk-osx-devel-list";>developer's
 mailing list</a> as well.</p>
 
-<p>Bugs, patches and enhancements may be submitted to our <a
-href="http://sourceforge.net/apps/trac/gtk-osx/newticket";>tracker</a>.
-</p>
-
-
+<h3>Contributing</h3>
+<p>Bugs, patches and enhancements may be submitted to the <a
+href="http://sourceforge.net/apps/trac/gtk-osx/newticket";>tracker</a>.</p>
 
 <?php require '../template.php';