gtk-doc r634 - in trunk: . tests/annotations/docs tests/annotations/src tests/bugs/docs tests/bugs/src tests/gobject/docs tests/gobject/docs-tmpl tests/gobject/src

[stefkost svn gnome org]

Author: stefkost
Date: Wed Jan  7 15:50:46 2009
New Revision: 634
URL: http://svn.gnome.org/viewvc/gtk-doc?rev=634&view=rev

Log:
	* NEWS:
	  Prepare for 1.12.
	* TODO:
	  More thinking about the documentation structure.
	* configure.in:
	  Add automake support for more distcheck. Use a real sourcefile for the
	  srcdir (something that we wont remove one day).
	* tests/annotations/docs/Makefile.am:
	* tests/annotations/src/Makefile.am:
	* tests/bugs/docs/Makefile.am:
	* tests/bugs/src/Makefile.am:
	* tests/gobject/docs-tmpl/Makefile.am:
	* tests/gobject/docs/Makefile.am:
	* tests/gobject/src/Makefile.am:
	  Add missing file to fix make distcheck. Use srcdir and not builddir to
	  locate includes.



Modified:
   trunk/ChangeLog
   trunk/NEWS
   trunk/TODO
   trunk/configure.in
   trunk/tests/annotations/docs/Makefile.am
   trunk/tests/annotations/src/Makefile.am
   trunk/tests/bugs/docs/Makefile.am
   trunk/tests/bugs/src/Makefile.am
   trunk/tests/gobject/docs-tmpl/Makefile.am
   trunk/tests/gobject/docs/Makefile.am
   trunk/tests/gobject/src/Makefile.am

Modified: trunk/NEWS
==============================================================================
--- trunk/NEWS	(original)
+++ trunk/NEWS	Wed Jan  7 15:50:46 2009
@@ -1,3 +1,7 @@
+GTK-Doc 1.12    (Xxx XX 2009)
+============
+
+
 GTK-Doc 1.11    (Nov 16 2008)
 ============
 

Modified: trunk/TODO
==============================================================================
--- trunk/TODO	(original)
+++ trunk/TODO	Wed Jan  7 15:50:46 2009
@@ -189,6 +189,11 @@
   * structure
   * docbook markup (part/chapter structure)
 * structure
+  Sugested structure for api-docs.
+  Idea is to have more content that api reference. It would be good to have a
+  gnome-platform document in devhelp, so that we could xref that instead of
+  explaining 100 times how to use pkg-config.
+
   * examples
     * gobject in devhelp
       * concepts / api / tools / tutorial / related tools
@@ -197,10 +202,19 @@
     * qt reference docs in qt assistant
       * classes / overview / tutorial&examples
   * recommendation
+    * front-page
+      * table with details
+        Logo, Module Version
+        Links
+        * homepage, mailing lists, irc channel
+        * repository, source releases, bugtracker
+      * TOC
     * introduction - what is is about
     * concepts - explain basic ideas and terminology
-    * development - how to build and run, env-vars
+    * development - how to build and run, env-vars, different platforms
     * api - classic api docs
     * tutorial & examples - integrated to keep it up-to-date and cross referenced
     * migration - how to for api changes, deprecations
     * (releated) tools - tools part of the package or recommended for development
+    * indexes - api-index, depretations, new api since xxx
+

Modified: trunk/configure.in
==============================================================================
--- trunk/configure.in	(original)
+++ trunk/configure.in	Wed Jan  7 15:50:46 2009
@@ -9,9 +9,9 @@
         [http://bugzilla.gnome.org/enter_bug.cgi?product=gtk-doc])
 
 AC_CONFIG_MACRO_DIR([m4])
-AC_CONFIG_SRCDIR([gtk-doc.dsl.in])
+AC_CONFIG_SRCDIR([gtkdoc-common.pl.in])
 
-AM_INIT_AUTOMAKE
+AM_INIT_AUTOMAKE([check-news std-options])
 AM_MAINTAINER_MODE
 
 GNOME_DOC_INIT

Modified: trunk/tests/annotations/docs/Makefile.am
==============================================================================
--- trunk/tests/annotations/docs/Makefile.am	(original)
+++ trunk/tests/annotations/docs/Makefile.am	Wed Jan  7 15:50:46 2009
@@ -58,7 +58,7 @@
 # CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library.
 # Only needed if you are using gtkdoc-scangobj to dynamically query widget
 # signals and properties.
-GTKDOC_CFLAGS = -I$(top_builddir) -I$(top_builddir)/tests/annotations/src $(TEST_DEPS_CFLAGS)
+GTKDOC_CFLAGS = -I$(top_srcdir)/tests/annotations/src $(TEST_DEPS_CFLAGS)
 GTKDOC_LIBS = $(TEST_DEPS_LIBS) $(top_builddir)/tests/annotations/src/libtester.la
 
 # include generic part

Modified: trunk/tests/annotations/src/Makefile.am
==============================================================================
--- trunk/tests/annotations/src/Makefile.am	(original)
+++ trunk/tests/annotations/src/Makefile.am	Wed Jan  7 15:50:46 2009
@@ -7,7 +7,7 @@
 libtester_la_SOURCES = tester.c tester.h
 #libtester_la_LIBADD = $(TEST_DEPS_LIBS)
 
-INCLUDES = $(TEST_DEPS_CFLAGS)
+AM_CPPFLAGS = $(TEST_DEPS_CFLAGS)
 
 endif
 

Modified: trunk/tests/bugs/docs/Makefile.am
==============================================================================
--- trunk/tests/bugs/docs/Makefile.am	(original)
+++ trunk/tests/bugs/docs/Makefile.am	Wed Jan  7 15:50:46 2009
@@ -58,7 +58,7 @@
 # CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library.
 # Only needed if you are using gtkdoc-scangobj to dynamically query widget
 # signals and properties.
-GTKDOC_CFLAGS = -I$(top_builddir) -I$(top_builddir)/tests/bugs/src $(TEST_DEPS_CFLAGS)
+GTKDOC_CFLAGS = -I$(top_srcdir)/tests/bugs/src $(TEST_DEPS_CFLAGS)
 GTKDOC_LIBS = $(TEST_DEPS_LIBS) $(top_builddir)/tests/bugs/src/libtester.la
 
 # include generic part

Modified: trunk/tests/bugs/src/Makefile.am
==============================================================================
--- trunk/tests/bugs/src/Makefile.am	(original)
+++ trunk/tests/bugs/src/Makefile.am	Wed Jan  7 15:50:46 2009
@@ -7,7 +7,7 @@
 libtester_la_SOURCES = tester.c tester.h
 #libtester_la_LIBADD = $(TEST_DEPS_LIBS)
 
-INCLUDES = $(TEST_DEPS_CFLAGS)
+AM_CPPFLAGS = $(TEST_DEPS_CFLAGS)
 
 endif
 

Modified: trunk/tests/gobject/docs-tmpl/Makefile.am
==============================================================================
--- trunk/tests/gobject/docs-tmpl/Makefile.am	(original)
+++ trunk/tests/gobject/docs-tmpl/Makefile.am	Wed Jan  7 15:50:46 2009
@@ -56,7 +56,7 @@
 # CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library.
 # Only needed if you are using gtkdoc-scangobj to dynamically query widget
 # signals and properties.
-GTKDOC_CFLAGS = -I$(top_builddir) -I$(top_builddir)/tests/gobject/src $(TEST_DEPS_CFLAGS)
+GTKDOC_CFLAGS = -I$(top_srcdir)/tests/gobject/src $(TEST_DEPS_CFLAGS)
 GTKDOC_LIBS = $(TEST_DEPS_LIBS) $(top_builddir)/tests/gobject/src/libtester.la
 
 # include generic part

Modified: trunk/tests/gobject/docs/Makefile.am
==============================================================================
--- trunk/tests/gobject/docs/Makefile.am	(original)
+++ trunk/tests/gobject/docs/Makefile.am	Wed Jan  7 15:50:46 2009
@@ -56,7 +56,7 @@
 # CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library.
 # Only needed if you are using gtkdoc-scangobj to dynamically query widget
 # signals and properties.
-GTKDOC_CFLAGS = -I$(top_builddir) -I$(top_builddir)/tests/gobject/src $(TEST_DEPS_CFLAGS)
+GTKDOC_CFLAGS = -I$(top_srcdir)/tests/gobject/src $(TEST_DEPS_CFLAGS)
 GTKDOC_LIBS = $(TEST_DEPS_LIBS) $(top_builddir)/tests/gobject/src/libtester.la
 
 # include generic part

Modified: trunk/tests/gobject/src/Makefile.am
==============================================================================
--- trunk/tests/gobject/src/Makefile.am	(original)
+++ trunk/tests/gobject/src/Makefile.am	Wed Jan  7 15:50:46 2009
@@ -4,10 +4,10 @@
 
 noinst_LTLIBRARIES = libtester.la
 
-libtester_la_SOURCES = gobject.c gobject.h giface.c giface.h
+libtester_la_SOURCES = gobject.c gobject.h giface.c giface.h tester.h
 #libtester_la_LIBADD = $(TEST_DEPS_LIBS)
 
-INCLUDES = $(TEST_DEPS_CFLAGS)
+AM_CPPFLAGS = $(TEST_DEPS_CFLAGS)
 
 endif