[PATCHv2] docs: add the app dev guide

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

 



    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


[Index of Archives]     [Virt Tools]     [Libvirt Users]     [Lib OS Info]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Big List of Linux Books]     [Yosemite News]     [KDE Users]     [Fedora Tools]