[gnomeweb-wml] nm: update developer documentation

[Dan Williams <dcbw src gnome org>]

commit 99de4e6c7772d8be212df2d3eee29e5b577d0c12
Author: Dan Williams <dcbw redhat com>
Date:   Thu Aug 25 10:55:37 2011 -0500

    nm: update developer documentation

 .../NetworkManager/developers/index.html           |   62 +++++++++++++++++---
 1 files changed, 53 insertions(+), 9 deletions(-)
---
diff --git a/projects.gnome.org/NetworkManager/developers/index.html b/projects.gnome.org/NetworkManager/developers/index.html
index b85c4ce..9555631 100644
--- a/projects.gnome.org/NetworkManager/developers/index.html
+++ b/projects.gnome.org/NetworkManager/developers/index.html
@@ -16,18 +16,54 @@
 	</div>
 
 	<h2>So you want to talk to NetworkManager?</h2>
-	<p>NetworkManager provides a detailed and capable D-Bus interface on the system bus.  You can use this interface to query NetworkManager about the overall state of the network and details of network devices like current IP addresses or DHCP options, and to activate and deactivate network connections.  A network connection is a bundle of settings that describe a connection to a particular computer network, like a specific mobile broadband provider or a single wifi network.  These connections are provided by other D-Bus services, called "settings services", which also provide a D-Bus interface and allow you to query and change stored network connections and preferences.  The NetworkManager D-Bus API specification (<a href="api/07/spec-07.html">[0.7]</a> <a href="api/08/spec-08.html">[0.8]</a> <a href="api/09/spec.html">[0.9]</a>) provides a detailed description of each object and interface that NetworkManager provides.</p>
+	<p>NetworkManager provides a detailed and capable D-Bus interface on the
+	system bus.  You can use this interface to query NetworkManager about
+	the overall state of the network and details of network devices like
+	current IP addresses or DHCP options, and to activate and deactivate
+	network connections.  A network connection is a bundle of settings that
+	describe a connection to a particular computer network, like a specific
+	mobile broadband provider or a single wifi network.  These connections
+	are provided by other D-Bus services, called "settings services", which
+	also provide a D-Bus interface and allow you to query and change stored
+	network connections and preferences.  The NetworkManager D-Bus API
+	specification (<a href="api/07/spec-07.html">[0.7]</a>
+	<a href="api/08/spec-08.html">[0.8]</a>
+	<a href="api/09/spec.html">[0.9]</a>) provides a detailed description
+	of each object and interface that NetworkManager provides.</p>
 
 	<h2>Migrating to NetworkManager 0.9</h2>
-	<p>The 0.9 release is a significant milestone, and provides more simplified D-Bus interface that makes it easier to write user applications that take full advantage of the networking state.  That means quite a few things have changed.  To help smooth the process of updating applications, check out the <a href="api/09/ref-migrating.html">0.9 Migration Guide</a>.  Let us know if you have tips, suggestions, problems!</p>
+	<p>The 0.9 release is a significant milestone, and provides more simplified
+	D-Bus interface that makes it easier to write user applications that take
+	full advantage of the networking state.  That means quite a few things have
+	changed.  To help smooth the process of updating applications, check out
+	the <a href="api/09/ref-migrating.html">0.9 Migration Guide</a>.  Let us
+	know if you have tips, suggestions, problems!</p>
+
+	<h2>Using the GLib API</h2>
+	<p>NetworkManager also provides two glib-based convenience libraries
+	called libnm-util and libnm-glib.  These wrap the D-Bus interface in
+	easy-to-use GObjects.  Documentation for libnm-util is here: 
+	<a href="http://projects.gnome.org/NetworkManager/developers/libnm-util/08/";>[libnm-util 08]</a>
+	<a href="http://projects.gnome.org/NetworkManager/developers/libnm-util/09/";>[libnm-util 09]</a>
+	and documentation for libnm-glib is here:
+	<a href="http://projects.gnome.org/NetworkManager/developers/libnm-glib/08/";>[libnm-glib 08]</a>
+	<a href="http://projects.gnome.org/NetworkManager/developers/libnm-glib/09/";>[libnm-glib 09]</a>.
+	</p>
 
 	<h2>Show me some examples!</h2>
-	<p>Sure, there's a bunch of examples for Python, C, and glib, and Qt right here: <a href="http://cgit.freedesktop.org/NetworkManager/NetworkManager/tree/examples";>[09]</a> <a href="http://cgit.freedesktop.org/NetworkManager/NetworkManager/tree/examples?h=NM_0_8";>[08]</a>.</p>
+	<p>Sure, there's a bunch of examples for Python, C, and glib, and Qt
+	right here: <a href="http://cgit.freedesktop.org/NetworkManager/NetworkManager/tree/examples";>[09]</a>
+	<a href="http://cgit.freedesktop.org/NetworkManager/NetworkManager/tree/examples?h=NM_0_8";>[08]</a>.</p>
 
 	<h2>Or you want to hack on NetworkManager?</h2>
-	<p>First, you should probably consider joining the mailing list as there is a lot of useful information there from other NM hackers: <a 
-href="http://mail.gnome.org/mailman/listinfo/networkmanager-list";>http://mail.gnome.org/mailman/listinfo/networkmanager-list</a>.</p>
-	<p>Second, read the <a href="design_goals.html">Design Goals</a> of NetworkManager to get an idea of why things work the way they do, and check <a href="http://live.gnome.org/NetworkManager";>out the wiki</a> for more information on the architecture.</p>
+	<p>First, you should probably consider joining the mailing list as
+	there is a lot of useful information there from other NM hackers:
+	<a href="http://mail.gnome.org/mailman/listinfo/networkmanager-list";>http://mail.gnome.org/mailman/listinfo/networkmanager-list</a>.</p>
+	<p>Second, read the <a href="design_goals.html">Design Goals</a> of
+	NetworkManager to get an idea of why things work the way they do, and
+	check <a href="http://live.gnome.org/NetworkManager";>out the wiki</a>
+	for more information on the architecture.</p>
+
 	<p>To checkout and build the latest, hottest sources of the core NetworkManager daemon from git:<br>
 	<code>
 		<kbd>git clone git://anongit.freedesktop.org/NetworkManager/NetworkManager.git</kbd><br>
@@ -55,7 +91,9 @@ href="http://mail.gnome.org/mailman/listinfo/networkmanager-list";>http://mail.gn
 		<kbd>sudo make install</kbd>
 	</code>
 	</p>
-	<p>There are also VPN service plugins for vpnc, openvpn, and pptp.  Each has its own git module, so replace 'vpnc' as appropriate in the following example:<br>
+	<p>There are also VPN service plugins for vpnc, openvpn, and pptp.  Each
+	has its own git module, so replace 'vpnc' as appropriate in the following
+	example:<br>
 	<code>
 		<kbd>git clone git://git.gnome.org/network-manager-vpnc</kbd><br>
 		<kbd>cd network-manager-vpnc</kbd><br/>
@@ -66,10 +104,16 @@ href="http://mail.gnome.org/mailman/listinfo/networkmanager-list";>http://mail.gn
 	</p>
 
 	<h2>Actually hacking on it</h2>
-	<p>If you make changes to NetworkManager, create the patch using a Unified diff format (ie, diff -u) and mail the patch to the NetworkManager list.  Others on the list may make suggestions, please take these into consideration.  Eventually, your patch can be checked into the NetworkManager git source repositories.</p>
+	<p>If you make changes to NetworkManager, create the patch using a
+	Unified diff format (ie, diff -u) and mail the patch to the NetworkManager
+	list.  Others on the list may make suggestions, please take these into
+	consideration.  Eventually, your patch can be checked into the
+	NetworkManager git source repositories.</p>
 
 	<h2>Stuff to work on</h2>
-	<p>The most up-to-date list of work items is kept in the <a href="http://cgit.freedesktop.org/NetworkManager/NetworkManager/tree/TODO";>TODO file in NetworkManager git</a>.  If you see anything you'd like to work on, please send a patch!</p>
+	<p>The most up-to-date list of work items is kept in the
+	<a href="http://cgit.freedesktop.org/NetworkManager/NetworkManager/tree/TODO";>TODO file in NetworkManager git</a>.
+	If you see anything you'd like to work on, please send a patch!</p>
 
 </div>
 <div id="copyright">