2005-12-02 01:16:36 +03:00
## Process this file with automake to produce Makefile.in
2011-07-28 22:56:24 +04:00
## Copyright (C) 2005-2011 Red Hat, Inc.
## See COPYING.LIB for the License of this software
2009-10-02 15:29:15 +04:00
SUBDIRS = schemas
2005-12-02 01:16:36 +03:00
2010-09-21 19:40:32 +04:00
PERL = perl
2005-12-02 01:16:36 +03:00
# The directory containing the source code (if it contains documentation).
DOC_SOURCE_DIR = ../src
2009-10-02 15:29:15 +04:00
DEVHELP_DIR = $( datadir) /gtk-doc/html/libvirt
2011-05-27 14:16:43 +04:00
BUILT_SOURCES = hvsupport.html.in
2008-04-28 12:29:35 +04:00
apihtml = \
html/index.html \
html/libvirt-libvirt.html \
html/libvirt-virterror.html
2007-11-15 16:04:28 +03:00
2008-04-23 21:08:31 +04:00
apipng = \
2008-04-28 12:29:35 +04:00
html/left.png \
html/up.png \
html/home.png \
html/right.png
2007-11-15 16:04:28 +03:00
2010-02-25 11:28:51 +03:00
devhelphtml = \
2009-10-02 15:29:15 +04:00
devhelp/libvirt.devhelp \
devhelp/index.html \
devhelp/general.html \
devhelp/libvirt-libvirt.html \
devhelp/libvirt-virterror.html
2010-10-26 18:34:33 +04:00
css = \
generic.css \
libvirt.css \
main.css
2009-10-02 15:29:15 +04:00
devhelppng = \
devhelp/home.png \
devhelp/left.png \
devhelp/right.png \
devhelp/up.png
devhelpcss = devhelp/style.css
devhelpxsl = devhelp/devhelp.xsl devhelp/html.xsl
2008-04-23 21:08:31 +04:00
png = \
32favicon.png \
footer_corner.png \
footer_pattern.png \
libvirt-header-bg.png \
libvirt-header-logo.png \
libvirtLogo.png \
libvirt-net-logical.png \
libvirt-net-physical.png \
2009-04-16 00:42:50 +04:00
libvirt-daemon-arch.png \
libvirt-driver-arch.png \
libvirt-object-model.png \
2008-04-23 21:08:31 +04:00
madeWith.png \
Add documentation about migration.
This adds a page documenting many aspects of migration:
- The types of migration (managed direct, p2p, unmanaged direct)
- Data transports (native, tunnelled)
- Migration URIs
- Config file handling
- Example scenarios
* libvirt.css: Rules for data tables and diagrams
* Makefile.am: Include extra png/fig files
* migration-managed-direct.fig, migration-managed-direct.png,
migration-managed-direct.png, migration-managed-p2p.png,
migration-native.fig, migration-native.png,
migration-tunnel.fig, migration-tunnel.png,
migration-unmanaged-direct.fig, migration-unmanaged-direct.png:
Diagrams of migration
* migration.html.in, sitemap.html.in: New migration doc
2009-10-02 20:53:51 +04:00
et.png \
migration-managed-direct.png \
migration-managed-p2p.png \
migration-native.png \
migration-tunnel.png \
migration-unmanaged-direct.png
2008-04-23 21:08:31 +04:00
2007-11-15 16:04:28 +03:00
gif = \
architecture.gif \
2008-04-28 12:29:35 +04:00
node.gif
2007-11-15 16:04:28 +03:00
2011-05-13 14:00:56 +04:00
dot_html_in = $( notdir $( wildcard $( srcdir) /*.html.in) ) todo.html.in hvsupport.html.in \
2010-05-25 17:14:46 +04:00
$( patsubst $( srcdir) /%,%,$( wildcard $( srcdir) /internals/*.html.in) )
2008-04-23 21:08:31 +04:00
dot_html = $( dot_html_in:%.html.in= %.html)
2007-11-15 16:04:28 +03:00
2011-02-19 00:40:35 +03:00
patches = $( patsubst $( srcdir) /%,%,$( wildcard $( srcdir) /api_extension/*.patch) )
2009-06-09 15:42:41 +04:00
2007-11-15 16:04:28 +03:00
xml = \
libvirt-api.xml \
2009-09-16 22:02:59 +04:00
libvirt-refs.xml
2007-11-15 16:04:28 +03:00
2011-09-14 07:38:39 +04:00
qemu_xml = \
libvirt-qemu-api.xml \
libvirt-qemu-refs.xml
2008-04-23 21:08:31 +04:00
fig = \
libvirt-net-logical.fig \
2009-04-16 00:42:50 +04:00
libvirt-net-physical.fig \
libvirt-daemon-arch.fig \
libvirt-driver-arch.fig \
Add documentation about migration.
This adds a page documenting many aspects of migration:
- The types of migration (managed direct, p2p, unmanaged direct)
- Data transports (native, tunnelled)
- Migration URIs
- Config file handling
- Example scenarios
* libvirt.css: Rules for data tables and diagrams
* Makefile.am: Include extra png/fig files
* migration-managed-direct.fig, migration-managed-direct.png,
migration-managed-direct.png, migration-managed-p2p.png,
migration-native.fig, migration-native.png,
migration-tunnel.fig, migration-tunnel.png,
migration-unmanaged-direct.fig, migration-unmanaged-direct.png:
Diagrams of migration
* migration.html.in, sitemap.html.in: New migration doc
2009-10-02 20:53:51 +04:00
libvirt-object-model.fig \
migration-managed-direct.fig \
migration-managed-p2p.fig \
migration-native.fig \
migration-tunnel.fig \
migration-unmanaged-direct.fig
2008-04-23 21:08:31 +04:00
2007-11-15 16:04:28 +03:00
EXTRA_DIST = \
2010-06-26 02:27:07 +04:00
apibuild.py \
2010-10-22 09:50:27 +04:00
site.xsl newapi.xsl news.xsl page.xsl \
2011-02-11 13:03:31 +03:00
hacking1.xsl hacking2.xsl wrapstring.xsl \
2008-04-28 12:29:35 +04:00
$( dot_html) $( dot_html_in) $( gif) $( apihtml) $( apipng) \
2009-10-02 15:29:15 +04:00
$( devhelphtml) $( devhelppng) $( devhelpcss) $( devhelpxsl) \
2011-09-14 07:38:39 +04:00
$( xml) $( qemu_xml) $( fig) $( png) $( css) \
2009-06-09 15:42:41 +04:00
$( patches) \
2010-02-24 16:15:26 +03:00
sitemap.html.in \
2011-05-13 14:00:56 +04:00
todo.pl hvsupport.pl todo.cfg-example
2007-11-15 16:04:28 +03:00
2011-02-18 14:12:28 +03:00
MAINTAINERCLEANFILES = \
$( addprefix $( srcdir) /,$( dot_html) ) \
$( addprefix $( srcdir) /,$( apihtml) ) \
$( addprefix $( srcdir) /,$( devhelphtml) )
2009-09-16 21:56:56 +04:00
2009-10-07 14:15:45 +04:00
all : web
2005-12-02 01:16:36 +03:00
2011-02-16 17:09:09 +03:00
api : $( srcdir ) /libvirt -api .xml $( srcdir ) /libvirt -refs .xml
2011-09-14 07:38:39 +04:00
qemu_api : $( srcdir ) /libvirt -qemu -api .xml $( srcdir ) /libvirt -qemu -refs .xml
2005-12-02 01:16:36 +03:00
2009-10-02 15:29:15 +04:00
web : $( dot_html ) html /index .html devhelp /index .html
2005-12-02 01:16:36 +03:00
2010-09-21 19:40:32 +04:00
todo.html.in : todo .pl
if [ -f todo.cfg ] ; then \
echo " Generating $@ " ; \
2011-07-14 19:41:38 +04:00
$( PERL) $< > $@ \
2010-09-21 19:40:32 +04:00
|| { rm $@ && exit 1; } ; \
else \
echo " Stubbing $@ " ; \
echo "<html><body><h1>Todo list</h1></body></html>" > $@ ; \
fi
todo :
rm -f todo.html.in
$( MAKE) todo.html
2011-05-13 14:00:56 +04:00
hvsupport.html.in : $( srcdir ) /hvsupport .pl $( srcdir ) /../src /libvirt_public .syms \
$( srcdir) /../src/libvirt_qemu.syms $( srcdir) /../src/driver.h
$( AM_V_GEN) $( PERL) $( srcdir) /hvsupport.pl $( srcdir) /../src > $@ || { rm $@ && exit 1; }
2010-09-21 19:40:32 +04:00
.PHONY : todo
2009-04-16 00:42:50 +04:00
%.png : %.fig
convert -rotate 90 $< $@
2010-05-25 17:14:46 +04:00
internals/%.html.tmp : internals /%.html .in subsite .xsl page .xsl sitemap .html .in
@if [ -x $( XSLTPROC) ] ; then \
echo " Generating $@ " ; \
2011-06-02 18:17:25 +04:00
$( MKDIR_P) internals; \
2010-05-25 17:14:46 +04:00
name = ` echo $@ | sed -e 's/.tmp//' ` ; \
$( XSLTPROC) --stringparam pagename $$ name --nonet --html \
$( top_srcdir) /docs/subsite.xsl $< > $@ \
|| { rm $@ && exit 1; } ; fi
2008-04-23 21:08:31 +04:00
%.html.tmp : %.html .in site .xsl page .xsl sitemap .html .in
2010-04-29 05:32:20 +04:00
@if [ -x $( XSLTPROC) ] ; then \
2008-04-23 21:08:31 +04:00
echo " Generating $@ " ; \
name = ` echo $@ | sed -e 's/.tmp//' ` ; \
2010-04-29 05:32:20 +04:00
$( XSLTPROC) --stringparam pagename $$ name --nonet --html \
$( top_srcdir) /docs/site.xsl $< > $@ \
|| { rm $@ && exit 1; } ; fi
2008-04-23 21:08:31 +04:00
%.html : %.html .tmp
2010-04-29 05:32:20 +04:00
@if test -x $( XMLLINT) && test -x $( XMLCATALOG) ; then \
2010-10-26 19:07:00 +04:00
if $( XMLCATALOG) '$(XML_CATALOG_FILE)' \
2010-04-29 05:32:20 +04:00
"-//W3C//DTD XHTML 1.0 Strict//EN" > /dev/null ; then \
2008-04-23 21:08:31 +04:00
echo " Validating $@ " ; \
2010-10-26 19:07:00 +04:00
SGML_CATALOG_FILES = '$(XML_CATALOG_FILE)' \
2011-02-17 00:47:39 +03:00
$( XMLLINT) --catalogs --nonet --format --valid $< > $( srcdir) /$@ \
|| { rm $( srcdir) /$@ && exit 1; } ; \
2010-04-29 05:32:20 +04:00
else echo "missing XHTML1 DTD" ; fi ; fi
2005-12-02 01:16:36 +03:00
2009-09-16 21:56:56 +04:00
html/index.html : libvirt -api .xml newapi .xsl page .xsl sitemap .html .in
2011-05-12 14:19:42 +04:00
$( AM_V_GEN) if [ -x $( XSLTPROC) ] ; then \
2011-02-18 14:12:28 +03:00
$( XSLTPROC) --nonet -o $( srcdir) / \
2011-07-19 17:34:34 +04:00
$( srcdir) /newapi.xsl $( srcdir) /libvirt-api.xml ; fi && \
2011-05-12 14:19:42 +04:00
if test -x $( XMLLINT) && test -x $( XMLCATALOG) ; then \
2010-10-26 19:07:00 +04:00
if $( XMLCATALOG) '$(XML_CATALOG_FILE)' "-//W3C//DTD XHTML 1.0 Strict//EN" \
2010-04-01 00:58:40 +04:00
> /dev/null ; then \
2010-10-26 19:07:00 +04:00
SGML_CATALOG_FILES = '$(XML_CATALOG_FILE)' \
2011-02-18 14:12:28 +03:00
$( XMLLINT) --catalogs --nonet --valid --noout $( srcdir) /html/*.html ; \
2010-04-29 05:32:20 +04:00
else echo "missing XHTML1 DTD" ; fi ; fi
2005-12-02 01:16:36 +03:00
2010-06-26 02:27:07 +04:00
$(addprefix $(srcdir)/,$(devhelphtml)) : $( srcdir ) /libvirt -api .xml $( devhelpxsl )
2011-05-12 14:19:42 +04:00
$( AM_V_GEN) if [ -x $( XSLTPROC) ] ; then \
2011-02-18 14:12:28 +03:00
$( XSLTPROC) --nonet -o $( srcdir) /devhelp/ \
2011-02-16 17:09:09 +03:00
$( top_srcdir) /docs/devhelp/devhelp.xsl $( srcdir) /libvirt-api.xml ; fi
2009-10-02 15:29:15 +04:00
2011-09-14 07:38:39 +04:00
2010-06-26 02:27:07 +04:00
python_generated_files = \
$( srcdir) /html/libvirt-libvirt.html \
2011-09-14 07:38:39 +04:00
$( srcdir) /html/libvirt-libvirt-qemu.html \
2010-06-26 02:27:07 +04:00
$( srcdir) /html/libvirt-virterror.html \
$( srcdir) /libvirt-api.xml \
2011-09-14 07:38:39 +04:00
$( srcdir) /libvirt-refs.xml \
$( srcdir) /libvirt-qemu-api.xml \
$( srcdir) /libvirt-qemu-refs.xml
2005-12-02 01:16:36 +03:00
2010-06-26 02:27:07 +04:00
$(python_generated_files) : $( srcdir ) /apibuild .py \
$( srcdir) /../include/libvirt/*.h \
$( srcdir) /../src/libvirt.c \
2011-09-14 07:38:39 +04:00
$( srcdir) /../src/libvirt-qemu.c \
2010-02-25 12:35:20 +03:00
$( srcdir) /../src/util/virterror.c
2011-07-01 19:46:52 +04:00
$( AM_V_GEN) srcdir = $( srcdir) $( PYTHON) $( srcdir) /apibuild.py
2010-02-25 12:35:20 +03:00
2010-05-27 01:56:04 +04:00
check-local : all
2005-12-02 01:16:36 +03:00
clean-local :
2010-07-10 16:49:26 +04:00
rm -f *~ *.bak *.hierarchy *.signals *-unused.txt *.html
2005-12-02 01:16:36 +03:00
maintainer-clean-local : clean -local
2011-05-13 14:00:56 +04:00
rm -rf $( srcdir) /libvirt-api.xml $( srcdir) /libvirt-refs.xml todo.html.in hvsupport.html.in
2011-09-14 07:38:39 +04:00
rm -rf $( srcdir) /libvirt-qemu-api.xml $( srcdir) /libvirt-qemu-refs.xml
2005-12-02 01:16:36 +03:00
2011-09-14 07:38:39 +04:00
rebuild : api qemu_api all
2005-12-02 01:16:36 +03:00
2008-02-05 22:27:37 +03:00
install-data-local :
2005-12-07 16:45:20 +03:00
$( mkinstalldirs) $( DESTDIR) $( HTML_DIR)
2010-10-26 18:34:33 +04:00
for f in $( css) $( dot_html) $( gif) $( png) ; do \
$( INSTALL) -m 0644 $( srcdir) /$$ f $( DESTDIR) $( HTML_DIR) ; done
2005-12-07 16:45:20 +03:00
$( mkinstalldirs) $( DESTDIR) $( HTML_DIR) /html
2008-04-23 21:08:31 +04:00
for h in $( apihtml) ; do \
2008-04-28 12:29:35 +04:00
$( INSTALL) -m 0644 $( srcdir) /$$ h $( DESTDIR) $( HTML_DIR) /html; done
2008-04-23 21:08:31 +04:00
for p in $( apipng) ; do \
2008-04-28 12:29:35 +04:00
$( INSTALL) -m 0644 $( srcdir) /$$ p $( DESTDIR) $( HTML_DIR) /html; done
2009-10-02 15:29:15 +04:00
$( mkinstalldirs) $( DESTDIR) $( DEVHELP_DIR)
for file in $( devhelphtml) $( devhelppng) $( devhelpcss) ; do \
2010-01-15 13:09:01 +03:00
$( INSTALL) -m 0644 $( srcdir) /$$ { file} $( DESTDIR) $( DEVHELP_DIR) ; \
2009-10-02 15:29:15 +04:00
done
2007-11-15 16:04:28 +03:00
uninstall-local :
2008-04-28 12:29:35 +04:00
for h in $( apihtml) ; do rm $( DESTDIR) $( HTML_DIR) /$$ h; done
for p in $( apipng) ; do rm $( DESTDIR) $( HTML_DIR) /$$ p; done
2009-10-02 15:29:15 +04:00
for f in $( devhelphtml) $( devhelppng) $( devhelpcss) ; do \
2010-01-09 11:56:20 +03:00
rm $( DESTDIR) $( DEVHELP_DIR) /$$ ( basename $$ f) ; \
done