Added a workable initial page for the libvirt Application
Development Guide, giving the online viewable options +
the available download ones (pdf, epub, srpm).
Added a link to the PDF to the main Downloads page, plus
neatened the html tags throughout the page as they
were a bit of a mess.
Added --enable-compile-warnings=error to the autogen line,
as suggested by Eric Blake.
---
This 2nd version of the patch has Erics suggested
--enable-compile-warnings=error addition to autogen.sh,
plus now includes the other formats the App Dev Guide
is available in (epub, .txt, .src.rpm).
Tried breaking up a long <a ...> line, as per Eric's email,
but ending up rejecting it because it doesn't work well
when done inside <pre></pre> tags. In Firefox (at least),
the whitespace becomes part of the underlined link and looks
weird. :/
docs/devguide.html.in | 53 ++++++++++++++++
docs/downloads.html.in | 154 +++++++++++++++++++++++++++++++-----------------
docs/sitemap.html.in | 4 +
3 files changed, 157 insertions(+), 54 deletions(-)
create mode 100644 docs/devguide.html.in
diff --git a/docs/devguide.html.in b/docs/devguide.html.in
new file mode 100644
index 0000000..e4f1b42
--- /dev/null
+++ b/docs/devguide.html.in
@@ -0,0 +1,53 @@
+<?xml version="1.0"?>
+<html>
+ <body>
+ <h1>libvirt Application Development Guide</h1>
+
+ <p>
+ This is both a guide to developing with libvirt, and a useful
+ reference document. It is a work in progress, contributed to by the
+ members of the libvirt team and being authored by a professional
+ author.
+ </p>
+
+ <p>
+ Contributors to this are <b>VERY</b> welcome, so if you'd like to
+ get your name in this and demonstrate your virtualisation prowess,
+ contributing solidly to the content here will do it. :)
+ </p>
+
+ <h2>Browsable online</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_Guide-en-US.epub";>
+ 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-0.7.5-web-en-US-1-9.el5.src.rpm";>
+ Source RPM format</a></li>
+ </ul>
+
+ <h2>GIT source repository</h2>
+
+ <p>
+ The source is in a git repository:
+ </p>
+
+ <pre>
+ git clone git://libvirt.org/libvirt-appdev-guide.git</pre>
+
+ <p>
+ Browsable here:
+ </p>
+
+ <pre>
+ <a href="http://libvirt.org/git/?p=libvirt-appdev-guide.git;a=summary";>http://libvirt.org/git/?p=libvirt-appdev-guide.git;a=summary</a></pre>
+
+ </body>
+</html>
diff --git a/docs/downloads.html.in b/docs/downloads.html.in
index 6872272..66b99e1 100644
--- a/docs/downloads.html.in
+++ b/docs/downloads.html.in
@@ -1,7 +1,7 @@
<?xml version="1.0"?>
<html>
<body>
- <h1 >Downloads</h1>
+ <h1>Downloads</h1>
<h2>Official Releases</h2>
@@ -27,62 +27,108 @@
<li><a href="http://libvirt.org/sources/libvirt-git-snapshot.tar.gz";>libvirt.org HTTP server</a></li>
</ul>
- <h2>GIT source repository</h2>
- <p> Libvirt code source is now maintained in a <a
- href="http://git-scm.com/";>git</a> repository available on
- <a href="http://libvirt.org/git/";>libvirt.org</a>:
+ <h2>GIT source repository</h2>
+
+ <p>
+ Libvirt code source is now maintained in a <a href="http://git-scm.com/";>git</a>
+ repository available on <a href="http://libvirt.org/git/";>libvirt.org</a>:
</p>
- <pre>
- git clone git://libvirt.org/libvirt.git
- </pre>
- <p>
- It can also be browsed at
+ <pre>
+ git clone git://libvirt.org/libvirt.git</pre>
+
+ <p>
+ It can also be browsed at:
+ </p>
+
+ <pre>
+ <a href="http://libvirt.org/git/?p=libvirt.git;a=summary";>http://libvirt.org/git/?p=libvirt.git;a=summary</a></pre>
+
+ <br />
+
+ <h1>libvirt Application Development Guide</h1>
+
+ <p>
+ This is both a guide to developing with libvirt, and a useful
+ reference document. It is a work in progress, contributed to by the
+ members of the libvirt team and being authored by a professional
+ author.
+ </p>
+
+ <p>
+ Contributors to this are <b>VERY</b> welcome, so if you'd like to
+ get your name in this and demonstrate your virtualisation prowess,
+ contributing solidly to the content here will do it. :)
</p>
- <pre>
-
- <a href="http://libvirt.org/git/?p=libvirt.git;a=summary";>http://libvirt.org/git/?p=libvirt.git;a=summary</a>
- </pre>
-
- <h1>Installation</h1>
- <h2>
- <a name="Compilatio" id="Compilatio">Compilation</a>
- </h2>
- <p>As most UNIX libraries libvirt follows the "standard":</p>
- <p>
- <code>gunzip -c libvirt-xxx.tar.gz | tar xvf -</code>
- </p>
- <p>
- <code>cd libvirt-xxxx</code>
- </p>
- <p>
- <code>./configure --help</code>
- </p>
- <p>to see the options, then the compilation/installation proper</p>
- <p>
- <code>./configure [possible options]</code>
- </p>
- <p>
- <code>make</code>
- </p>
- <p>
- <code>make install</code>
- </p>
- <p>At that point you may have to rerun ldconfig or a similar utility to
- update your list of installed shared libs.
- </p>
-
- <h2>Building from a source code checkout</h2>
- <p> The libvirt build process uses GNU autotools, so after obtaining a
- checkout it is necessary to generate the configure script and Makefile.in
- templates using the <code>autogen.sh</code> command, passing the extra
- arguments as for configure. As an example, to do a complete build and
- install it into your home directory run:</p>
- <pre>
-
- ./autogen.sh --prefix=$HOME/usr
+
+ <h2>Downloadable PDF</h2>
+
+ <p>
+ PDF download is available here:
+ </p>
+
+ <ul>
+ <li><a href="http://libvirt.org/guide/pdf/Application_Development_Guide.pdf";>libvirt App Dev Guide</a> (PDF)</li>
+ </ul>
+
+ <h2>GIT source repository</h2>
+
+ <p>
+ The source is also in a git repository:
+ </p>
+
+ <pre>
+ git clone git://libvirt.org/libvirt-appdev-guide.git</pre>
+
+ <p>
+ Browsable at:
+ </p>
+
+ <pre>
+ <a href="http://libvirt.org/git/?p=libvirt-appdev-guide.git;a=summary";>http://libvirt.org/git/?p=libvirt-appdev-guide.git;a=summary</a></pre>
+
+ <br />
+
+ <h1>libvirt Installation</h1>
+
+ <h2><a name="Compilatio" id="Compilatio">Compilation</a></h2>
+
+ <p>
+ libvirt uses the standard configure/make/install steps:
+ </p>
+
+ <pre>
+ gunzip -c libvirt-xxx.tar.gz | tar xvf -
+ cd libvirt-xxxx
+ ./configure --help</pre>
+
+ <p>
+ To see the options, then the compilation/installation proper:
+ </p>
+
+ <pre>
+ ./configure [possible options]
+ make
+ make install</pre>
+
+ <p>
+ At that point you may have to rerun ldconfig or a similar utility to
+ update your list of installed shared libs.
+ </p>
+
+ <h2>Building from a source code checkout</h2>
+
+ <p>
+ The libvirt build process uses GNU autotools, so after obtaining a
+ checkout it is necessary to generate the configure script and Makefile.in
+ templates using the <code>autogen.sh</code> command, passing the extra
+ arguments as for configure. As an example, to do a complete build and
+ install it into your home directory run:
+ </p>
+
+ <pre>
+ ./autogen.sh --prefix=$HOME/usr --enable-compile-warnings=error
make
- make install
- </pre>
+ make install</pre>
</body>
</html>
diff --git a/docs/sitemap.html.in b/docs/sitemap.html.in
index e9ab591..bb9cd8e 100644
--- a/docs/sitemap.html.in
+++ b/docs/sitemap.html.in
@@ -258,6 +258,10 @@
</li>
</ul>
</li>
+ <li>
+ <a href="devguide.html">Development Guide</a>
+ <span>A guide and reference for developing with libvirt</span>
+ </li>
</ul>
</li>
<li>
--
1.7.2.2
--
libvir-list mailing list
libvir-list@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/libvir-list