[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

[libvirt] [PATCH] docs: add the app dev guide



   Added a workable initial page for the libvirt Application
   Development Guide, giving the online viewable options +
   the downloadable pdf.

   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.
---
 docs/devguide.html.in  |   44 ++++++++++++++
 docs/downloads.html.in |  150 +++++++++++++++++++++++++++++++-----------------
 docs/sitemap.html.in   |    4 +
 3 files changed, 146 insertions(+), 52 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..60feee0
--- /dev/null
+++ b/docs/devguide.html.in
@@ -0,0 +1,44 @@
+<?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>
+    </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 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>
+
+  </body>
+</html>
diff --git a/docs/downloads.html.in b/docs/downloads.html.in
index 6872272..01f2e4c 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:
+    </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>
+
+    <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>
-        <pre>
 
-      git clone git://libvirt.org/libvirt.git
-    </pre>
-        <p>
-      It can also be browsed at
+    <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>
-
-      <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>
 
+    <pre>
       ./autogen.sh --prefix=$HOME/usr
       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


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]