[libvirt] [PATCH] docs: Update devguide.html to point to the new Python dev guide
We have a new libvirt-appdev-guide-python which we need to
promote to users. Rewrite the existing page to mention it
too. Also use the new URL location which is automatically
refreshed once a day.
Signed-off-by: Daniel P. Berrange <berrange(a)redhat.com>
---
docs/devguide.html.in | 56 +++++++++++++++++++--------------------------------
1 file changed, 21 insertions(+), 35 deletions(-)
diff --git a/docs/devguide.html.in b/docs/devguide.html.in
index 122fe24..639e495 100644
--- a/docs/devguide.html.in
+++ b/docs/devguide.html.in
@@ -2,55 +2,41 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<body>
- <h1>libvirt Application Development Guide</h1>
-
- <ul id="toc"></ul>
-
- <p>
- The guide is both a learning tool for developing with libvirt and an
- API reference document. It is a work in progress, composed by a
- professional author from contributions written by members of the
- libvirt team.
- </p>
+ <h1>libvirt Application Development Guides</h1>
<p>
- Contributions to the guide are <b>VERY</b> welcome. If you'd like
to get
- your name on this and demonstrate your virtualisation prowess, a solid
- contribution to the content here will do it. :)
+ The libvirt API is accessible from a number of programming languages.
+ At this time, there are application development guides available
+ which cover the C API and the Python API. Of the two, the Python guide
+ is currently the more comprehensive document.
</p>
- <h2><a name="online">Browsable online</a></h2>
-
<ul>
- <li><a href="http://libvirt.org/guide/html/">
- HTML format using multiple pages</a></li>
- <li><a href="http://libvirt.org/guide/html-single/">
- HTML format using one big page</a></li>
- <li><a
href="http://libvirt.org/guide/pdf/Application_Development_Guide.pdf...
- PDF format</a></li>
- <li><a
href="http://libvirt.org/guide/libvirt-0.7.5-Application_Development...
- ePub format</a></li>
- <li><a
href="http://libvirt.org/guide/txt/Application_Development_Guide.txt...
- Plain text format</a></li>
- <li><a
href="http://libvirt.org/guide/libvirt-Application_Development_Guide...
- Source RPM format</a></li>
+ <li><a
href="http://libvirt.org/docs/libvirt-appdev-guide/en-US/html/"...
Development Guide (C language) HTML</a></li>
+ <li><a
href="http://libvirt.org/docs/libvirt-appdev-guide/en-US/pdf/"&...
Development Guide (C language) PDF</a></li>
+ <li><a
href="http://libvirt.org/docs/libvirt-appdev-guide-python/en-US/html...
Development Guide (Python language) HTML</a></li>
+ <li><a
href="http://libvirt.org/docs/libvirt-appdev-guide-python/en-US/pdf/...
Development Guide (Python language) PDF</a></li>
</ul>
- <h2><a name="git">GIT source repository</a></h2>
+ <h2>Contributing content</h2>
<p>
- The source is in a git repository:
+ These guides are written in DocBook and published with the
+ publican tool, which is also used for Fedora and Red Hat
+ documentation. The original content is provided in GIT and
+ any contributions to the guide are welcome.
</p>
<pre>
- git clone git://libvirt.org/libvirt-appdev-guide.git</pre>
+ # C language
+ $ git clone <a
href="http://libvirt.org/git/?p=libvirt-appdev-guide.git">gi...
- <p>
- Browsable here:
- </p>
+ # Python language
+ $ git clone <a
href="http://libvirt.org/git/?p=libvirt-appdev-guide-python.git"...
- <pre>
- <a
href="http://libvirt.org/git/?p=libvirt-appdev-guide.git;a=summary&q...
+ # Publican Style/Theme
+ $ git clone <a
href="http://libvirt.org/git/?p=libvirt-publican.git">git://...
+ </pre>
</body>
</html>
--
2.4.3