]> err.no Git - libchamplain/commitdiff
Version bump and doc updates
authorPierre-Luc Beaudoin <pierre-luc@squidy.info>
Sun, 28 Sep 2008 15:13:11 +0000 (11:13 -0400)
committerPierre-Luc Beaudoin <pierre-luc@squidy.info>
Sun, 28 Sep 2008 15:13:11 +0000 (11:13 -0400)
autogen.sh [new file with mode: 0755]
champlain-gtk/launcher.c
configure.ac
docs/reference/Makefile.am
docs/reference/libchamplain-gtk-docs.sgml
docs/reference/libchamplain-gtk-sections.txt
docs/reference/tmpl/champlainview.sgml [deleted file]

diff --git a/autogen.sh b/autogen.sh
new file mode 100755 (executable)
index 0000000..04e6af7
--- /dev/null
@@ -0,0 +1,500 @@
+#!/bin/sh
+# Run this to generate all the initial makefiles, etc.
+
+#name of package
+PKG_NAME=${PKG_NAME:-Package}
+srcdir=${srcdir:-.}
+
+# default version requirements ...
+REQUIRED_AUTOCONF_VERSION=${REQUIRED_AUTOCONF_VERSION:-2.53}
+REQUIRED_AUTOMAKE_VERSION=${REQUIRED_AUTOMAKE_VERSION:-1.9}
+REQUIRED_LIBTOOL_VERSION=${REQUIRED_LIBTOOL_VERSION:-1.5}
+REQUIRED_GETTEXT_VERSION=${REQUIRED_GETTEXT_VERSION:-0.12}
+REQUIRED_GLIB_GETTEXT_VERSION=${REQUIRED_GLIB_GETTEXT_VERSION:-2.2.0}
+REQUIRED_INTLTOOL_VERSION=${REQUIRED_INTLTOOL_VERSION:-0.30}
+REQUIRED_PKG_CONFIG_VERSION=${REQUIRED_PKG_CONFIG_VERSION:-0.14.0}
+REQUIRED_GTK_DOC_VERSION=${REQUIRED_GTK_DOC_VERSION:-1.0}
+REQUIRED_DOC_COMMON_VERSION=${REQUIRED_DOC_COMMON_VERSION:-2.3.0}
+REQUIRED_GNOME_DOC_UTILS_VERSION=${REQUIRED_GNOME_DOC_UTILS_VERSION:-0.4.2}
+
+# a list of required m4 macros.  Package can set an initial value
+REQUIRED_M4MACROS=${REQUIRED_M4MACROS:-}
+FORBIDDEN_M4MACROS=${FORBIDDEN_M4MACROS:-}
+
+# Not all echo versions allow -n, so we check what is possible. This test is
+# based on the one in autoconf.
+ECHO_C=
+ECHO_N=
+case `echo -n x` in
+-n*)
+  case `echo 'x\c'` in
+  *c*) ;;
+  *)   ECHO_C='\c';;
+  esac;;
+*)
+  ECHO_N='-n';;
+esac
+
+# some terminal codes ...
+boldface="`tput bold 2>/dev/null`"
+normal="`tput sgr0 2>/dev/null`"
+printbold() {
+    echo $ECHO_N "$boldface" $ECHO_C
+    echo "$@"
+    echo $ECHO_N "$normal" $ECHO_C
+}    
+printerr() {
+    echo "$@" >&2
+}
+
+# Usage:
+#     compare_versions MIN_VERSION ACTUAL_VERSION
+# returns true if ACTUAL_VERSION >= MIN_VERSION
+compare_versions() {
+    ch_min_version=$1
+    ch_actual_version=$2
+    ch_status=0
+    IFS="${IFS=         }"; ch_save_IFS="$IFS"; IFS="."
+    set $ch_actual_version
+    for ch_min in $ch_min_version; do
+        ch_cur=`echo $1 | sed 's/[^0-9].*$//'`; shift # remove letter suffixes
+        if [ -z "$ch_min" ]; then break; fi
+        if [ -z "$ch_cur" ]; then ch_status=1; break; fi
+        if [ $ch_cur -gt $ch_min ]; then break; fi
+        if [ $ch_cur -lt $ch_min ]; then ch_status=1; break; fi
+    done
+    IFS="$ch_save_IFS"
+    return $ch_status
+}
+
+# Usage:
+#     version_check PACKAGE VARIABLE CHECKPROGS MIN_VERSION SOURCE
+# checks to see if the package is available
+version_check() {
+    vc_package=$1
+    vc_variable=$2
+    vc_checkprogs=$3
+    vc_min_version=$4
+    vc_source=$5
+    vc_status=1
+
+    vc_checkprog=`eval echo "\\$$vc_variable"`
+    if [ -n "$vc_checkprog" ]; then
+       printbold "using $vc_checkprog for $vc_package"
+       return 0
+    fi
+
+    if test "x$vc_package" = "xautomake" -a "x$vc_min_version" = "x1.4"; then
+       vc_comparator="="
+    else
+       vc_comparator=">="
+    fi
+    printbold "checking for $vc_package $vc_comparator $vc_min_version..."
+    for vc_checkprog in $vc_checkprogs; do
+       echo $ECHO_N "  testing $vc_checkprog... " $ECHO_C
+       if $vc_checkprog --version < /dev/null > /dev/null 2>&1; then
+           vc_actual_version=`$vc_checkprog --version | head -n 1 | \
+                               sed 's/^.*[     ]\([0-9.]*[a-z]*\).*$/\1/'`
+           if compare_versions $vc_min_version $vc_actual_version; then
+               echo "found $vc_actual_version"
+               # set variables
+               eval "$vc_variable=$vc_checkprog; \
+                       ${vc_variable}_VERSION=$vc_actual_version"
+               vc_status=0
+               break
+           else
+               echo "too old (found version $vc_actual_version)"
+           fi
+       else
+           echo "not found."
+       fi
+    done
+    if [ "$vc_status" != 0 ]; then
+       printerr "***Error***: You must have $vc_package $vc_comparator $vc_min_version installed"
+       printerr "  to build $PKG_NAME.  Download the appropriate package for"
+       printerr "  from your distribution or get the source tarball at"
+        printerr "    $vc_source"
+       printerr
+    fi
+    return $vc_status
+}
+
+# Usage:
+#     require_m4macro filename.m4
+# adds filename.m4 to the list of required macros
+require_m4macro() {
+    case "$REQUIRED_M4MACROS" in
+       $1\ * | *\ $1\ * | *\ $1) ;;
+       *) REQUIRED_M4MACROS="$REQUIRED_M4MACROS $1" ;;
+    esac
+}
+
+forbid_m4macro() {
+    case "$FORBIDDEN_M4MACROS" in
+       $1\ * | *\ $1\ * | *\ $1) ;;
+       *) FORBIDDEN_M4MACROS="$FORBIDDEN_M4MACROS $1" ;;
+    esac
+}
+
+# Usage:
+#     add_to_cm_macrodirs dirname
+# Adds the dir to $cm_macrodirs, if it's not there yet.
+add_to_cm_macrodirs() {
+    case $cm_macrodirs in
+    "$1 "* | *" $1 "* | *" $1") ;;
+    *) cm_macrodirs="$cm_macrodirs $1";;
+    esac
+}
+
+# Usage:
+#     print_m4macros_error
+# Prints an error message saying that autoconf macros were misused
+print_m4macros_error() {
+    printerr "***Error***: some autoconf macros required to build $PKG_NAME"
+    printerr "  were not found in your aclocal path, or some forbidden"
+    printerr "  macros were found.  Perhaps you need to adjust your"
+    printerr "  ACLOCAL_FLAGS?"
+    printerr
+}
+
+# Usage:
+#     check_m4macros
+# Checks that all the requested macro files are in the aclocal macro path
+# Uses REQUIRED_M4MACROS and ACLOCAL variables.
+check_m4macros() {
+    # construct list of macro directories
+    cm_macrodirs=`$ACLOCAL --print-ac-dir`
+    # aclocal also searches a version specific dir, eg. /usr/share/aclocal-1.9
+    # but it contains only Automake's own macros, so we can ignore it.
+
+    # Read the dirlist file, supported by Automake >= 1.7.
+    if compare_versions 1.7 $AUTOMAKE_VERSION && [ -s $cm_macrodirs/dirlist ]; then
+       cm_dirlist=`sed 's/[    ]*#.*//;/^$/d' $cm_macrodirs/dirlist`
+       if [ -n "$cm_dirlist" ] ; then
+           for cm_dir in $cm_dirlist; do
+               if [ -d $cm_dir ]; then
+                   add_to_cm_macrodirs $cm_dir
+               fi
+           done
+       fi
+    fi
+
+    # Parse $ACLOCAL_FLAGS
+    set - $ACLOCAL_FLAGS
+    while [ $# -gt 0 ]; do
+       if [ "$1" = "-I" ]; then
+           add_to_cm_macrodirs "$2"
+           shift
+       fi
+       shift
+    done
+
+    cm_status=0
+    if [ -n "$REQUIRED_M4MACROS" ]; then
+       printbold "Checking for required M4 macros..."
+       # check that each macro file is in one of the macro dirs
+       for cm_macro in $REQUIRED_M4MACROS; do
+           cm_macrofound=false
+           for cm_dir in $cm_macrodirs; do
+               if [ -f "$cm_dir/$cm_macro" ]; then
+                   cm_macrofound=true
+                   break
+               fi
+               # The macro dir in Cygwin environments may contain a file
+               # called dirlist containing other directories to look in.
+               if [ -f "$cm_dir/dirlist" ]; then
+                   for cm_otherdir in `cat $cm_dir/dirlist`; do
+                       if [ -f "$cm_otherdir/$cm_macro" ]; then
+                           cm_macrofound=true
+                           break
+                       fi
+                   done
+               fi
+           done
+           if $cm_macrofound; then
+               :
+           else
+               printerr "  $cm_macro not found"
+               cm_status=1
+           fi
+       done
+    fi
+    if [ "$cm_status" != 0 ]; then
+        print_m4macros_error
+        return $cm_status
+    fi
+    if [ -n "$FORBIDDEN_M4MACROS" ]; then
+       printbold "Checking for forbidden M4 macros..."
+       # check that each macro file is in one of the macro dirs
+       for cm_macro in $FORBIDDEN_M4MACROS; do
+           cm_macrofound=false
+           for cm_dir in $cm_macrodirs; do
+               if [ -f "$cm_dir/$cm_macro" ]; then
+                   cm_macrofound=true
+                   break
+               fi
+           done
+           if $cm_macrofound; then
+               printerr "  $cm_macro found (should be cleared from macros dir)"
+               cm_status=1
+           fi
+       done
+    fi
+    if [ "$cm_status" != 0 ]; then
+        print_m4macros_error
+    fi
+    return $cm_status
+}
+
+# try to catch the case where the macros2/ directory hasn't been cleared out.
+forbid_m4macro gnome-cxx-check.m4
+
+want_libtool=false
+want_gettext=false
+want_glib_gettext=false
+want_intltool=false
+want_pkg_config=false
+want_gtk_doc=false
+want_gnome_doc_utils=false
+
+configure_files="`find $srcdir -name '{arch}' -prune -o -name '_darcs' -prune -o -name '.??*' -prune -o -name configure.ac -print -o -name configure.in -print`"
+for configure_ac in $configure_files; do
+    dirname=`dirname $configure_ac`
+    if [ -f $dirname/NO-AUTO-GEN ]; then
+       echo skipping $dirname -- flagged as no auto-gen
+       continue
+    fi
+    if grep "^A[CM]_PROG_LIBTOOL" $configure_ac >/dev/null ||
+       grep "^LT_INIT" $configure_ac >/dev/null; then
+       want_libtool=true
+    fi
+    if grep "^AM_GNU_GETTEXT" $configure_ac >/dev/null; then
+       want_gettext=true
+    fi
+    if grep "^AM_GLIB_GNU_GETTEXT" $configure_ac >/dev/null; then
+       want_glib_gettext=true
+    fi
+    if grep "^AC_PROG_INTLTOOL" $configure_ac >/dev/null ||
+       grep "^IT_PROG_INTLTOOL" $configure_ac >/dev/null; then
+       want_intltool=true
+    fi
+    if grep "^PKG_CHECK_MODULES" $configure_ac >/dev/null; then
+       want_pkg_config=true
+    fi
+    if grep "^GTK_DOC_CHECK" $configure_ac >/dev/null; then
+       want_gtk_doc=true
+    fi
+    if grep "^GNOME_DOC_INIT" $configure_ac >/dev/null; then
+        want_gnome_doc_utils=true
+    fi
+
+    # check to make sure gnome-common macros can be found ...
+    if grep "^GNOME_COMMON_INIT" $configure_ac >/dev/null ||
+       grep "^GNOME_DEBUG_CHECK" $configure_ac >/dev/null ||
+       grep "^GNOME_MAINTAINER_MODE_DEFINES" $configure_ac >/dev/null; then
+        require_m4macro gnome-common.m4
+    fi
+    if grep "^GNOME_COMPILE_WARNINGS" $configure_ac >/dev/null ||
+       grep "^GNOME_CXX_WARNINGS" $configure_ac >/dev/null; then
+        require_m4macro gnome-compiler-flags.m4
+    fi
+done
+
+DIE=0
+
+#tell Mandrake autoconf wrapper we want autoconf 2.5x, not 2.13
+WANT_AUTOCONF_2_5=1
+export WANT_AUTOCONF_2_5
+version_check autoconf AUTOCONF 'autoconf2.50 autoconf autoconf-2.53' $REQUIRED_AUTOCONF_VERSION \
+    "http://ftp.gnu.org/pub/gnu/autoconf/autoconf-$REQUIRED_AUTOCONF_VERSION.tar.gz" || DIE=1
+AUTOHEADER=`echo $AUTOCONF | sed s/autoconf/autoheader/`
+
+case $REQUIRED_AUTOMAKE_VERSION in
+    1.4*) automake_progs="automake-1.4" ;;
+    1.5*) automake_progs="automake-1.10 automake-1.9 automake-1.8 automake-1.7 automake-1.6 automake-1.5" ;;
+    1.6*) automake_progs="automake-1.10 automake-1.9 automake-1.8 automake-1.7 automake-1.6" ;;
+    1.7*) automake_progs="automake-1.10 automake-1.9 automake-1.8 automake-1.7" ;;
+    1.8*) automake_progs="automake-1.10 automake-1.9 automake-1.8" ;;
+    1.9*) automake_progs="automake-1.10 automake-1.9" ;;
+    1.10*) automake_progs="automake-1.10" ;;
+esac
+version_check automake AUTOMAKE "$automake_progs" $REQUIRED_AUTOMAKE_VERSION \
+    "http://ftp.gnu.org/pub/gnu/automake/automake-$REQUIRED_AUTOMAKE_VERSION.tar.gz" || DIE=1
+ACLOCAL=`echo $AUTOMAKE | sed s/automake/aclocal/`
+
+if $want_libtool; then
+    version_check libtool LIBTOOLIZE libtoolize $REQUIRED_LIBTOOL_VERSION \
+        "http://ftp.gnu.org/pub/gnu/libtool/libtool-$REQUIRED_LIBTOOL_VERSION.tar.gz" || DIE=1
+    require_m4macro libtool.m4
+fi
+
+if $want_gettext; then
+    version_check gettext GETTEXTIZE gettextize $REQUIRED_GETTEXT_VERSION \
+        "http://ftp.gnu.org/pub/gnu/gettext/gettext-$REQUIRED_GETTEXT_VERSION.tar.gz" || DIE=1
+    require_m4macro gettext.m4
+fi
+
+if $want_glib_gettext; then
+    version_check glib-gettext GLIB_GETTEXTIZE glib-gettextize $REQUIRED_GLIB_GETTEXT_VERSION \
+        "ftp://ftp.gtk.org/pub/gtk/v2.2/glib-$REQUIRED_GLIB_GETTEXT_VERSION.tar.gz" || DIE=1
+    require_m4macro glib-gettext.m4
+fi
+
+if $want_intltool; then
+    version_check intltool INTLTOOLIZE intltoolize $REQUIRED_INTLTOOL_VERSION \
+        "http://ftp.gnome.org/pub/GNOME/sources/intltool/" || DIE=1
+    require_m4macro intltool.m4
+fi
+
+if $want_pkg_config; then
+    version_check pkg-config PKG_CONFIG pkg-config $REQUIRED_PKG_CONFIG_VERSION \
+        "'http://www.freedesktop.org/software/pkgconfig/releases/pkgconfig-$REQUIRED_PKG_CONFIG_VERSION.tar.gz" || DIE=1
+    require_m4macro pkg.m4
+fi
+
+if $want_gtk_doc; then
+    version_check gtk-doc GTKDOCIZE gtkdocize $REQUIRED_GTK_DOC_VERSION \
+        "http://ftp.gnome.org/pub/GNOME/sources/gtk-doc/" || DIE=1
+    require_m4macro gtk-doc.m4
+fi
+
+if $want_gnome_doc_utils; then
+    version_check gnome-doc-utils GNOME_DOC_PREPARE gnome-doc-prepare $REQUIRED_GNOME_DOC_UTILS_VERSION \
+        "http://ftp.gnome.org/pub/GNOME/sources/gnome-doc-utils/" || DIE=1
+fi
+
+if [ "x$USE_COMMON_DOC_BUILD" = "xyes" ]; then
+    version_check gnome-common DOC_COMMON gnome-doc-common \
+        $REQUIRED_DOC_COMMON_VERSION " " || DIE=1
+fi
+
+check_m4macros || DIE=1
+
+if [ "$DIE" -eq 1 ]; then
+  exit 1
+fi
+
+if [ "$#" = 0 -a "x$NOCONFIGURE" = "x" ]; then
+  printerr "**Warning**: I am going to run \`configure' with no arguments."
+  printerr "If you wish to pass any to it, please specify them on the"
+  printerr \`$0\'" command line."
+  printerr
+fi
+
+topdir=`pwd`
+for configure_ac in $configure_files; do 
+    dirname=`dirname $configure_ac`
+    basename=`basename $configure_ac`
+    if [ -f $dirname/NO-AUTO-GEN ]; then
+       echo skipping $dirname -- flagged as no auto-gen
+    elif [ ! -w $dirname ]; then
+        echo skipping $dirname -- directory is read only
+    else
+       printbold "Processing $configure_ac"
+       cd $dirname
+
+        # Note that the order these tools are called should match what
+        # autoconf's "autoupdate" package does.  See bug 138584 for
+        # details.
+
+        # programs that might install new macros get run before aclocal
+       if grep "^A[CM]_PROG_LIBTOOL" $basename >/dev/null ||
+          grep "^LT_INIT" $basename >/dev/null; then
+           printbold "Running $LIBTOOLIZE..."
+           $LIBTOOLIZE --force --copy || exit 1
+       fi
+
+       if grep "^AM_GLIB_GNU_GETTEXT" $basename >/dev/null; then
+           printbold "Running $GLIB_GETTEXTIZE... Ignore non-fatal messages."
+           echo "no" | $GLIB_GETTEXTIZE --force --copy || exit 1
+       elif grep "^AM_GNU_GETTEXT" $basename >/dev/null; then
+          if grep "^AM_GNU_GETTEXT_VERSION" $basename > /dev/null; then
+               printbold "Running autopoint..."
+               autopoint --force || exit 1
+          else
+               printbold "Running $GETTEXTIZE... Ignore non-fatal messages."
+               echo "no" | $GETTEXTIZE --force --copy || exit 1
+          fi
+       fi
+
+       if grep "^AC_PROG_INTLTOOL" $basename >/dev/null ||
+           grep "^IT_PROG_INTLTOOL" $basename >/dev/null; then
+           printbold "Running $INTLTOOLIZE..."
+           $INTLTOOLIZE --force --copy --automake || exit 1
+       fi
+       if grep "^GTK_DOC_CHECK" $basename >/dev/null; then
+           printbold "Running $GTKDOCIZE..."
+           $GTKDOCIZE --copy || exit 1
+       fi
+
+       if [ "x$USE_COMMON_DOC_BUILD" = "xyes" ]; then
+           printbold "Running gnome-doc-common..."
+           gnome-doc-common --copy || exit 1
+       fi
+       if grep "^GNOME_DOC_INIT" $basename >/dev/null; then
+           printbold "Running $GNOME_DOC_PREPARE..."
+           $GNOME_DOC_PREPARE --force --copy || exit 1
+       fi
+
+        # Now run aclocal to pull in any additional macros needed
+
+       # if the AC_CONFIG_MACRO_DIR() macro is used, pass that
+       # directory to aclocal.
+       m4dir=`cat "$basename" | grep '^AC_CONFIG_MACRO_DIR' | sed -n -e 's/AC_CONFIG_MACRO_DIR(\([^()]*\))/\1/p' | sed -e 's/^\[\(.*\)\]$/\1/' | sed -e 1q`
+       if [ -n "$m4dir" ]; then
+           m4dir="-I $m4dir"
+       fi
+       printbold "Running $ACLOCAL..."
+       $ACLOCAL $m4dir $ACLOCAL_FLAGS || exit 1
+
+       if grep "GNOME_AUTOGEN_OBSOLETE" aclocal.m4 >/dev/null; then
+           printerr "*** obsolete gnome macros were used in $configure_ac"
+       fi
+
+       # Now that all the macros are sorted, run autoconf and autoheader ...
+       printbold "Running $AUTOCONF..."
+       $AUTOCONF || exit 1
+       if grep "^A[CM]_CONFIG_HEADER" $basename >/dev/null; then
+           printbold "Running $AUTOHEADER..."
+           $AUTOHEADER || exit 1
+           # this prevents automake from thinking config.h.in is out of
+           # date, since autoheader doesn't touch the file if it doesn't
+           # change.
+           test -f config.h.in && touch config.h.in
+       fi
+
+       # Finally, run automake to create the makefiles ...
+       printbold "Running $AUTOMAKE..."
+        if [ -f COPYING ]; then
+          cp -pf COPYING COPYING.autogen_bak
+        fi
+        if [ -f INSTALL ]; then
+          cp -pf INSTALL INSTALL.autogen_bak
+        fi
+       if [ $REQUIRED_AUTOMAKE_VERSION != 1.4 ]; then
+           $AUTOMAKE --gnu --add-missing --force --copy || exit 1
+       else
+           $AUTOMAKE --gnu --add-missing --copy || exit 1
+       fi
+        if [ -f COPYING.autogen_bak ]; then
+          cmp COPYING COPYING.autogen_bak > /dev/null || cp -pf COPYING.autogen_bak COPYING
+          rm -f COPYING.autogen_bak
+        fi
+        if [ -f INSTALL.autogen_bak ]; then
+          cmp INSTALL INSTALL.autogen_bak > /dev/null || cp -pf INSTALL.autogen_bak INSTALL
+          rm -f INSTALL.autogen_bak
+        fi
+
+       cd "$topdir"
+    fi
+done
+
+conf_flags="--enable-maintainer-mode"
+
+if test x$NOCONFIGURE = x; then
+    printbold Running $srcdir/configure $conf_flags "$@" ...
+    $srcdir/configure $conf_flags "$@" \
+       && echo Now type \`make\' to compile $PKG_NAME || exit 1
+else
+    echo Skipping configure process.
+fi
index c13a9e3f047aad06ce03cd00e49064c09b870e99..b7e66f9f196006bcb2d2437f21781e25074bb888 100644 (file)
@@ -57,7 +57,7 @@ create_marker_layer ()
   champlain_marker_set_position(CHAMPLAIN_MARKER(marker), 47.130885, -70.764141);
   clutter_container_add(CLUTTER_CONTAINER(layer), marker, NULL);
   
-  clutter_actor_show(layer);
+  clutter_actor_hide(layer);
   return layer;
 }
 
index 020fcb5e947dc481982c36f55978e0e3b47225b6..ff0381d83ec6a8ccf29ec9661ac7ed59cdd8825e 100644 (file)
@@ -2,7 +2,7 @@
 # Process this file with autoconf to produce a configure script.
 
 AC_PREREQ(2.61)
-AC_INIT(libchamplain-gtk, 0.2.1, pierre-luc@squidy.info)
+AC_INIT(libchamplain-gtk, 0.2.2, pierre-luc@squidy.info)
 AC_CONFIG_SRCDIR([champlain-gtk/champlainviewembed.h])
 AC_CONFIG_HEADER([config.h])
 AC_CONFIG_MACRO_DIR(m4)
@@ -37,6 +37,7 @@ GTK_DOC_CHECK(1.9)
 AC_CONFIG_FILES([Makefile
                  champlain-gtk/Makefile
                  docs/reference/Makefile
+                 docs/reference/version.xml
                  champlain-gtk.pc])
 AC_OUTPUT
 
index 1d16a938d57dffe10c9ded4a195c92693a85dce8..f0e62558c4ac56fbde9b23ba776751e319d67330 100644 (file)
@@ -49,7 +49,7 @@ HTML_IMAGES=
 
 # Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
 # e.g. content_files=running.sgml building.sgml changes-2.0.sgml
-content_files=
+content_files= version.xml
 
 # SGML files where gtk-doc abbrevations (#GtkWidget) are expanded
 # These files must be listed here *and* in content_files
index bcb0b4e78940b697d5e51269e525d79fa4af5814..b1b45e0a9c0512fbeef890bc7607df4015f85d04 100644 (file)
@@ -1,18 +1,20 @@
 <?xml version="1.0"?>
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
-               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
+               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+<!ENTITY version SYSTEM "version.xml">
+]>
 <book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
   <bookinfo>
     <title>libchamplain-gtk Reference Manual</title>
     <releaseinfo>
-      for libchamplain-gtk 0.2.1
+      for libchamplain-gtk &version;
       The latest version of this documentation can be found on-line at
       <ulink role="online-location" url="http://blog.squidy.info/projects/libchamplain/">http://blog.squidy.info/projects/libchamplain/</ulink>.
     </releaseinfo>
   </bookinfo>
 
   <chapter>
-    <title>API Reference</title>
+    <title>I. API Reference</title>
     <xi:include href="xml/champlainviewembed.xml"/>
   </chapter>
 </book>
index e74925fcbcd216c1edb7184cab5129fb1337a40f..a04f9c26f79fbd036a0f995afb151a1b87dc0ac1 100644 (file)
@@ -1,8 +1,6 @@
 <SECTION>
 <FILE>champlainviewembed</FILE>
-ChamplainViewEmbedPrivate
 <TITLE>ChamplainViewEmbed</TITLE>
-ChamplainViewEmbed
 champlain_view_embed_new
 champlain_view_embed_get_view
 <SUBSECTION Standard>
diff --git a/docs/reference/tmpl/champlainview.sgml b/docs/reference/tmpl/champlainview.sgml
deleted file mode 100644 (file)
index fa75da2..0000000
+++ /dev/null
@@ -1,131 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-ChamplainView
-
-<!-- ##### SECTION Short_Description ##### -->
-A widget to display maps
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The #ChamplainView widget is a Clutter based widget to display maps.  It supports two modes of scrolling:
-<itemizedlist>
-  <listitem><para>Push: the normal behavior where the maps doesn't move after the user stopped scrolling;</para></listitem>
-  <listitem><para>Kinetic: the iPhone-like behavior where the maps decelerate after the user stopped scrolling.</para></listitem>
-</itemizedlist>
-</para>
-<para>
-You can use the same #ChamplainView to display many types of maps.  In Champlain they are called map sources.  You can change the #map-source property at anytime to replace the current displayed map.
-</para>
-<para>
-The maps are downloaded from Internet from open maps sources (like <ulink role="online-location" url="http://www.openstreetmap.org">OpenStreetMap</ulink>).  Maps are divided in tiles for each zoom level.  When a tile is requested, #ChamplainView will first check if it is in cache (in
-the user's cache dir under champlain). If an error occurs during download, an error tile will be displayed (if not in offline mode).
-</para>
-
-<para>
-
-</para>
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### ENUM ChamplainMapSource ##### -->
-<para>
-
-</para>
-
-@CHAMPLAIN_MAP_SOURCE_DEBUG: 
-@CHAMPLAIN_MAP_SOURCE_OPENSTREETMAP: 
-@CHAMPLAIN_MAP_SOURCE_OPENARIALMAP: 
-@CHAMPLAIN_MAP_SOURCE_MAPSFORFREE_RELIEF: 
-@CHAMPLAIN_MAP_SOURCE_COUNT: 
-
-<!-- ##### ENUM ChamplainViewMode ##### -->
-<para>
-
-</para>
-
-@CHAMPLAIN_VIEW_MODE_PUSH: 
-@CHAMPLAIN_VIEW_MODE_KINETIC: 
-
-<!-- ##### STRUCT ChamplainView ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### ARG ChamplainView:decel-rate ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG ChamplainView:latitude ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG ChamplainView:longitude ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG ChamplainView:map-source ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG ChamplainView:offline ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG ChamplainView:zoom-level ##### -->
-<para>
-
-</para>
-
-<!-- ##### FUNCTION champlain_view_get_type ##### -->
-<para>
-
-</para>
-
-@Returns: 
-
-
-<!-- ##### FUNCTION champlain_view_new ##### -->
-<para>
-
-</para>
-
-@mode: 
-@Returns: 
-
-
-<!-- ##### FUNCTION champlain_view_center_on ##### -->
-<para>
-
-</para>
-
-@view: 
-@longitude: 
-@latitude: 
-
-
-<!-- ##### FUNCTION champlain_view_zoom_in ##### -->
-<para>
-
-</para>
-
-@champlainView: 
-
-
-<!-- ##### FUNCTION champlain_view_zoom_out ##### -->
-<para>
-
-</para>
-
-@champlainView: 
-
-