From ae641fcfc5430a8d9dd3c7ef587ce8fa8c5f3913 Mon Sep 17 00:00:00 2001
From: Justin Clift <jclift@redhat.com>
Date: Wed, 27 Oct 2010 14:17:38 +1100
Subject: [PATCH] docs: reworded and reordered the bindings page, plus minor
 tweaks

Reordered the bindings into alphabetical order, added a link to
the php-libvirt source on Github, plus gave the direct package
names needed for Python usage on RHEL/Fedora, and Ubuntu.
---
 docs/bindings.html.in | 62 +++++++++++++++++++++++++++++--------------
 1 file changed, 42 insertions(+), 20 deletions(-)

diff --git a/docs/bindings.html.in b/docs/bindings.html.in
index 0bc997e9dc..b190a382ad 100644
--- a/docs/bindings.html.in
+++ b/docs/bindings.html.in
@@ -4,42 +4,64 @@
     <h1 >Bindings for other languages</h1>
 
     <p>
-      Libvirt comes with bindings to support other languages than
-      pure <strong>C</strong>. First the headers embeds the necessary
-      declarations to allow direct access from <strong>C++</strong>
-      code, but also we have bindings for higher level kind of languages:
+      Libvirt supports C and C++ directly, and has bindings available
+      for other languages:
     </p>
 
     <ul>
       <li>
-        <strong>Python</strong>: Libvirt comes with direct support for
-        the Python language (just make sure you installed the libvirt-python
-        package if not compiling from sources). See below for more
-        information about using libvirt with python
+        <strong>C#</strong>: Arnaud Champion develops
+        <a href="csharp.html">C# bindings</a>.
       </li>
       <li>
-        <strong>Perl</strong>: Daniel Berrange provides
-        <a href="http://search.cpan.org/dist/Sys-Virt/">bindings for Perl</a>.
+        <strong>Java</strong>: Daniel Veillard develops
+        <a href="java.html">Java bindings</a>.
       </li>
       <li>
-        <strong>OCaml</strong>: Richard Jones supplies
-        <a href="http://libvirt.org/ocaml/">bindings for OCaml</a>.
+        <strong>OCaml</strong>: Richard Jones develops
+        <a href="http://libvirt.org/ocaml/">OCaml bindings</a>.
       </li>
       <li>
-        <strong>Ruby</strong>: David Lutterkort provides
-        <a href="http://libvirt.org/ruby/">bindings for Ruby</a>.
+        <strong>Perl</strong>: Daniel Berrange develops
+        <a href="http://search.cpan.org/dist/Sys-Virt/">Perl bindings</a>.
       </li>
       <li>
-        <strong>Java</strong>: Daniel Veillard maintains
-        <a href="java.html">Java bindings</a>.
+        <p>
+          <strong>PHP</strong>: Radek Hladik develops
+          <a href="http://phplibvirt.cybersales.cz/">PHP bindings</a>.
+        </p>
+        <p>
+          The php-libvirt bindings also have their source online
+          <a href="http://github.com/Kedarius/php-libvirt">here in Github</a>.
+        </p>
+        <p>
+          This allows you to easily see the code, make comments on it,
+          create your own forks, and contribute the changes back.
+        </p>
       </li>
       <li>
-        <strong>C#</strong>: Arnaud Champion maintains
-        <a href="csharp.html">C# bindings</a>.
+        <p>
+          <strong>Python</strong>: Libvirt comes with direct support for
+          the Python language.
+        </p>
+        <p>
+          If your libvirt is installed as packages, rather than compiled
+          by you from source code, ensure you have the appropriate
+          package installed.
+        </p>
+        <p>
+          This is named <b>libvirt-python</b> on RHEL/Fedora,
+          <a href="http://packages.ubuntu.com/search?keywords=python-libvirt"><b>python-libvirt</b></a>
+          on Ubuntu, and may be named differently on others.
+        </p>
+        <p>
+          For usage information, see the
+          <a href="python.html">Python API bindings</a> page.
+        </p>
       </li>
       <li>
-        <strong>PHP</strong>: Radek Hladik is developing
-        <a href="http://phplibvirt.cybersales.cz/">PHP bindings</a>.
+        <strong>Ruby</strong>: David Lutterkort develops
+        <a href="http://libvirt.org/ruby/">Ruby bindings</a>.
       </li>
     </ul>
 
-- 
2.47.2