From 21df1e503b6ca2d33fc8ca3b1e9bf9b6c2b43b8d Mon Sep 17 00:00:00 2001 From: Daniel Veillard Date: Wed, 22 Feb 2006 10:54:54 +0000 Subject: [PATCH] * configure.in libvirt.spec.in docs/Makefile.am docs/devhelp/*: added devhelp docs support, based on libxml2 stylesheets Daniel --- ChangeLog | 5 + configure.in | 2 +- docs/Makefile.am | 2 +- docs/devhelp/Makefile.am | 27 ++ docs/devhelp/devhelp.xsl | 127 +++++++++ docs/devhelp/home.png | Bin 0 -> 654 bytes docs/devhelp/html.xsl | 579 +++++++++++++++++++++++++++++++++++++++ docs/devhelp/left.png | Bin 0 -> 459 bytes docs/devhelp/right.png | Bin 0 -> 472 bytes docs/devhelp/style.css | 66 +++++ docs/devhelp/up.png | Bin 0 -> 406 bytes libvirt.spec.in | 4 + 12 files changed, 810 insertions(+), 2 deletions(-) create mode 100644 docs/devhelp/Makefile.am create mode 100644 docs/devhelp/devhelp.xsl create mode 100644 docs/devhelp/home.png create mode 100644 docs/devhelp/html.xsl create mode 100644 docs/devhelp/left.png create mode 100644 docs/devhelp/right.png create mode 100644 docs/devhelp/style.css create mode 100644 docs/devhelp/up.png diff --git a/ChangeLog b/ChangeLog index 9584af80e7..6c9a671be2 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +Wed Feb 22 11:53:45 CET 2006 Daniel Veillard + + * configure.in libvirt.spec.in docs/Makefile.am docs/devhelp/*: + added devhelp docs support, based on libxml2 stylesheets + Wed Feb 22 09:57:11 CET 2006 Daniel Veillard * TODO: updated diff --git a/configure.in b/configure.in index 75d62ce280..9086c317e9 100644 --- a/configure.in +++ b/configure.in @@ -236,6 +236,6 @@ rm -f COPYING cp COPYING.LIB COPYING AC_OUTPUT(Makefile src/Makefile include/Makefile docs/Makefile \ - docs/examples/Makefile \ + docs/examples/Makefile docs/devhelp/Makefile \ libvirt.pc libvirt.spec include/libvirt.h \ python/Makefile python/tests/Makefile) diff --git a/docs/Makefile.am b/docs/Makefile.am index ad1a2f1f5e..e488ba0e1a 100644 --- a/docs/Makefile.am +++ b/docs/Makefile.am @@ -1,5 +1,5 @@ ## Process this file with automake to produce Makefile.in -SUBDIRS=examples +SUBDIRS= . examples devhelp # The directory containing the source code (if it contains documentation). DOC_SOURCE_DIR=../src diff --git a/docs/devhelp/Makefile.am b/docs/devhelp/Makefile.am new file mode 100644 index 0000000000..c599989d60 --- /dev/null +++ b/docs/devhelp/Makefile.am @@ -0,0 +1,27 @@ +DEVHELP_DIR=$(datadir)/gtk-doc/html/libvirt +HTML_FILES=index.html general.html $(HTML_MODULES) +HTML_MODULES= \ + libvirt-libvirt.html + +EXTRA_FORMAT= \ + home.png \ + left.png \ + right.png \ + up.png \ + style.css + +EXTRA_DIST=devhelp.xsl html.xsl libvirt.devhelp $(HTML_FILES) $(EXTRA_FORMAT) + +all: libvirt.devhelp $(HTML_FILES) + +libvirt.devhelp $(HTML_FILES): devhelp.xsl html.xsl $(top_srcdir)/docs/libvirt-api.xml + -@(echo Rebuilding devhelp files) + -@(if [ -x $(XSLTPROC) ] ; then \ + $(XSLTPROC) --nonet -o $(srcdir)/libvirt.devhelp devhelp.xsl $(top_srcdir)/docs/libvirt-api.xml ; fi ); + +install-data-local: + $(mkinstalldirs) $(DESTDIR)$(DEVHELP_DIR) + -@INSTALL@ -m 0644 libvirt.devhelp $(DESTDIR)$(DEVHELP_DIR) + -@INSTALL@ -m 0644 $(EXTRA_FORMAT) $(DESTDIR)$(DEVHELP_DIR) + -@INSTALL@ -m 0644 $(HTML_FILES) $(DESTDIR)$(DEVHELP_DIR) + diff --git a/docs/devhelp/devhelp.xsl b/docs/devhelp/devhelp.xsl new file mode 100644 index 0000000000..ce67a50184 --- /dev/null +++ b/docs/devhelp/devhelp.xsl @@ -0,0 +1,127 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="concat(@name, ': ', summary)"/> + + + + + + + + + + + + + + + + + + + + +
PrevUpHomeNextlibvirt Reference Manual
+

+

-

+

+ +

WARNING: this module is deprecated !

+ +

Author(s):

+
+

Synopsis

+ 
+	    
+
+
+
+

Description

+
+
+

Details

+
+ + + + + +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/devhelp/home.png b/docs/devhelp/home.png new file mode 100644 index 0000000000000000000000000000000000000000..17003611d9df2b066afc682cbde962f3a575002d GIT binary patch literal 654 zcmV;90&)F`P)~yY zO1cF+0vxb!W?!x?K+*#62Jq)nA4q`)5S6sgX4ao{=)(Mgq+YMr)7sjak|a^9)zS!j zlk{-n29mabXYF=7SYBQx&vO8xC}MYams+hxqtO7sImhPaCf@rq;I^3!#u*2aUP)55 zT2&N90xmEJ0s&fGT~(T<3d2xYmK9C>IP*x-M@ib*+0pFm>>uW37N2Wzaq-fCnIZE9 zpb8}0+uN+KuQM2oZVHfP8U6kQdo3?>Wo2dT)WeM9So8DqhLi#T0 z-i(>mfjhvbsYV`;4sgfJ-p>G-SqJ!fjR6BQYs1h*y9xaN0l{VB;o%`08yiy@)$8@~ z2PD1gcDuiy;j1tR0v#V8OH%W)25-YKyx(j#IXO9*YWf0mb8}QG6@b@;cHxh9{t7+@ o!Yd`f8L$sLH?yBt^q3C6015TtIu@BS5dZ)H07*qoM6N<$f*igdr~m)} literal 0 HcmV?d00001 diff --git a/docs/devhelp/html.xsl b/docs/devhelp/html.xsl new file mode 100644 index 0000000000..1efcc7c9b1 --- /dev/null +++ b/docs/devhelp/html.xsl @@ -0,0 +1,579 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ( + + void + + + + + + + + + ,
+ + + + + + + + + + ); + + + + + + + + + + typedef + + + + + + + + + + + + ( + + void + + + + + + + + + ,
+ + + + + + + + + + ); + + + + + + + + + + + typedef + + + + + + ; + + + + + + #define + + + ( + + + + , + + + ) + + ; + + + + + + + + + + +
+

Structure

+ 
+     {
+
+    
+      The content of this structure is not made public by the API.
+
+    
+    
+            
+	
+	  
+	
+		
+	
+	
+	  	: 
+	  
+	    
+	  
+	
+	
+
+    
+    } 
+    
+    ;
+
+
+

+ + + +

+ +
+ + + + +
+

Typedef

+ 
+    
+      
+    
+     
+    
+    ;
+
+
+

+ + + +

+ +
+ + + + +
+

Variable

+ 
+    
+      
+    
+     
+    
+    ;
+
+
+

+ + + +

+ +
+ + + + +
+

Enum

+ 
+    enum 
+    
+     {
+
+    
+      
+          
+      
+      
+         = 
+	
+      
+      
+         /* 
+	
+         */
+      
+      
+
+    
+    };
+
+
+

+ + + +

+ +
+ + + + +
+

Macro

+ 
+    #define 
+    
+    
+      (
+      
+        
+	
+	  , 
+	
+      
+      )
+    
+    ;
+
+
+

+ + + +

+ +
+ + + + + + +
: + + + +
+ + + +
+ + + + + + + +
+

()

+ 
+    
+      
+    
+    	
+    
+    
+      	
+    
+    
+      	
+    
+    	(
+    
+      void
+    
+    
+      
+        
+      
+       
+      
+      
+        , 

+	
+	  	
+	
+	
+	  	
+	
+						 
+      
+    
+    )

+    
+
+
+

+ + + +

+ + +
+ + + + + + + + + + + + +
: + + + +
Returns: + + + +
+ +
+ + + + + + + +
+

Function type

+ 
+    
+      
+    
+    	
+    
+    
+      	
+    
+    
+      	
+    
+    	(
+    
+      void
+    
+    
+      
+        
+      
+       
+      
+      
+        , 

+	
+	  	
+	
+	
+	  	
+	
+						 
+      
+    
+    )

+    
+
+
+

+ + + +

+ + +
+ + + + + + + + + + + + +
: + + + +
Returns: + + + +
+ +
+ + + + + + + + + + <xsl:value-of select="concat(@name, ': ', summary)"/> + + + + + + + + + + + + + + + + + +
UpHomeNextlibvirt Reference Manual
+

libvirt API Modules

+

+ + -
+ +

+ + + + + + + + + + + + libvirt Reference Manual + + + + + + + + + + + +
HomeNextlibvirt Reference Manual
+

libvirt Reference Manual

+

Libvir is a C toolkit to interract with the virtualization capabilities of +recent versions of Linux (and other OSes). It is free software available +under the GNU +Lesser General Public License. Virtualization of the Linux Operating +System means the ability to run multiple instances of Operating Systems +concurently on a single hardware system where the basic resources are driven +by a Linux instance. The library aim at providing long term stable C API +initially for the Xen +paravirtualization but should be able to integrate other virtualization +mechanisms if needed.

+

If you get lost searching for some specific API use, try +the online search +engine hosted on libvirt.org +it indexes the project page, the APIs as well as the mailing-list archives.

+ + + + + + + + diff --git a/docs/devhelp/left.png b/docs/devhelp/left.png new file mode 100644 index 0000000000000000000000000000000000000000..2d05b3d5b4aeec9384bbfe404bfc4ed0897051c4 GIT binary patch literal 459 zcmV;+0W|)JP)40xL?wO*>WZ(J#ML5j2<9jD6A%Q&kC}jOeEc;X{s;`zcnxLeZR6?6h#^ihmNF6NpGdilO$m<82oD9WQ|6nVv1`? z>KufRi{?QPXg;4;wroQu4?mN1Ydd@|kaQ|ZyWLK!)yi7Wb%=0{}lD)tfliHAUyWRQ+fD_;aV6j->y6!O_8bENg6P)Cd4HCN^TYHBC0dz3r5|}*T3c5!K}0^NPTey!^rYo;W&eW{b1SE%dR-1ljcju- zJITo5P_e{cPDWDszO|97o#m$fni3V4d%~7^?0HU4-k!+X`e~w55Q}HA=c?CM9`EK` z^o5GF_RsnG`ey+9wOf8O4bzg>7W*;jU~M?g`OZAA$mNp|Lz<$s+~N9!2`ir8RcClo$(Q~19INM~9}j;&*|enC yGd}kJak0wj?aUKd8;%}`i}SSew>!A-2iw}^5}Rh(M>+vRkipZ{&t;ucLK6U4uc96R literal 0 HcmV?d00001 diff --git a/libvirt.spec.in b/libvirt.spec.in index efb47abc51..6983010020 100644 --- a/libvirt.spec.in +++ b/libvirt.spec.in @@ -77,6 +77,10 @@ rm -fr %{buildroot} %{_libdir}/lib*.so %{_includedir}/libvirt/*.h %{_libdir}/pkgconfig/libvirt.pc +%doc %{_datadir}/gtk-doc/html/libvirt/*.devhelp +%doc %{_datadir}/gtk-doc/html/libvirt/*.html +%doc %{_datadir}/gtk-doc/html/libvirt/*.png +%doc %{_datadir}/gtk-doc/html/libvirt/*.css %doc docs/*.html docs/html docs/*.gif %doc docs/examples