Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Installation now requires gtk-doc. Reference documentation builds in doc/reference. The actual documentation is a work in progress.
- Loading branch information
Showing
7 changed files
with
155 additions
and
3 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,3 +1,3 @@ | ||
ACLOCAL_AMFLAGS = -I build/autotools | ||
DISTCHECK_CONFIGURE_FLAGS = --enable-introspection | ||
SUBDIRS=i3ipc-glib | ||
DISTCHECK_CONFIGURE_FLAGS = --enable-gtk-doc --enable-introspection | ||
SUBDIRS=i3ipc-glib doc |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
SUBDIRS = reference |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,81 @@ | ||
# This is a blank Makefile.am for using gtk-doc. | ||
# Copy this to your project's API docs directory and modify the variables to | ||
# suit your project. See the GTK+ Makefiles in gtk+/docs/reference for examples | ||
# of using the various options. | ||
|
||
# The name of the module, e.g. 'glib'. | ||
DOC_MODULE = i3ipc-glib | ||
|
||
# The top-level XML file. You can change this if you want to. | ||
DOC_MAIN_SGML_FILE = $(DOC_MODULE)-docs.xml | ||
|
||
# The directory containing the source code. Relative to $(srcdir). | ||
# gtk-doc will search all .c & .h files beneath here for inline comments | ||
# documenting the functions and macros. | ||
# e.g. DOC_SOURCE_DIR=../../../gtk | ||
DOC_SOURCE_DIR = ../../i3ipc-glib | ||
|
||
# Extra options to pass to gtkdoc-scangobj. Not normally needed. | ||
SCANGOBJ_OPTIONS = | ||
|
||
# Extra options to supply to gtkdoc-scan. | ||
# e.g. SCAN_OPTIONS=--deprecated-guards="GTK_DISABLE_DEPRECATED" | ||
SCAN_OPTIONS = --deprecated-guards="I3IPC_DISABLE_DEPRECATED" | ||
|
||
# Extra options to supply to gtkdoc-mkdb. | ||
# e.g. MKDB_OPTIONS=--sgml-mode --output-format=xml | ||
MKDB_OPTIONS = --sgml-mode --output-format=xml --name-space=i3ipc | ||
|
||
# Extra options to supply to gtkdoc-mktmpl | ||
# e.g. MKTMPL_OPTIONS=--only-section-tmpl | ||
MKTMPL_OPTIONS = | ||
|
||
# Extra options to supply to gtkdoc-fixref. Not normally needed. | ||
# e.g. FIXXREF_OPTIONS=--extra-dir=../gdk-pixbuf/html --extra-dir=../gdk/html | ||
FIXXREF_OPTIONS = \ | ||
--extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/glib \ | ||
--extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/gobject \ | ||
--extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html/gio | ||
|
||
# Used for dependencies. The docs will be rebuilt if any of these change. | ||
# e.g. HFILE_GLOB=$(top_srcdir)/gtk/*.h | ||
# e.g. CFILE_GLOB=$(top_srcdir)/gtk/*.c | ||
HFILE_GLOB = $(top_srcdir)/i3ipc-glib/*.h $(top_builddir)/i3ipc-glib/*.h | ||
CFILE_GLOB = $(top_srcdir)/i3ipc-glib/*.c | ||
|
||
# Header files to ignore when scanning. | ||
# e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h | ||
IGNORE_HFILES = \ | ||
i3ipc-con-private.h \ | ||
i3ipc-enum-types.h \ | ||
i3ipc-glib.h | ||
|
||
EXTRA_HFILES = | ||
|
||
# Images to copy into HTML directory. | ||
# e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png | ||
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 = \ | ||
version.xml | ||
|
||
# SGML files where gtk-doc abbrevations (#GtkWidget) are expanded | ||
# These files must be listed here *and* in content_files | ||
# e.g. expand_content_files=running.sgml | ||
expand_content_files = | ||
|
||
# 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. | ||
# e.g. INCLUDES=-I$(top_srcdir) -I$(top_builddir) $(GTK_DEBUG_FLAGS) | ||
# e.g. GTKDOC_LIBS=$(top_builddir)/gtk/$(gtktargetlib) | ||
|
||
AM_CPPFLAGS = -I$(top_srcdir) -I$(top_builddir) $(gobject_CFLAGS) | ||
GTKDOC_LIBS = $(top_builddir)/i3ipc-glib/libi3ipc-glib-1.0.la $(gobject_LIBS) | ||
|
||
# This includes the standard gtk-doc make rules, copied by gtkdocize. | ||
include $(top_srcdir)/gtk-doc.make | ||
|
||
EXTRA_DIST += version.xml.in |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,40 @@ | ||
<?xml version="1.0"?> | ||
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" | ||
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" | ||
[ | ||
<!ENTITY version SYSTEM "version.xml"> | ||
<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'"> | ||
]> | ||
<book id="index"> | ||
<bookinfo> | ||
<title>i3ipc-glib Reference Manual</title> | ||
<releaseinfo> | ||
for i3ipc-glib &version; | ||
The latest version of this documentation can be found on-line at | ||
<ulink role="online-location" url="http://dubstepdish.com/i3ipc-glib/index.html">http://dubstepdish.com/i3ipc-glib/</ulink>. | ||
</releaseinfo> | ||
</bookinfo> | ||
|
||
<chapter> | ||
<title>Data Types</title> | ||
<xi:include href="xml/i3ipc-con.xml"/> | ||
<xi:include href="xml/i3ipc-connection.xml"/> | ||
<xi:include href="xml/i3ipc-event-types.xml"/> | ||
<xi:include href="xml/i3ipc-reply-types.xml"/> | ||
|
||
</chapter> | ||
<chapter id="object-tree"> | ||
<title>Object Hierarchy</title> | ||
<xi:include href="xml/tree_index.sgml"/> | ||
</chapter> | ||
<index id="api-index-full"> | ||
<title>API Index</title> | ||
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include> | ||
</index> | ||
<index id="deprecated-api-index" role="deprecated"> | ||
<title>Index of deprecated API</title> | ||
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include> | ||
</index> | ||
|
||
<xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include> | ||
</book> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
@I3IPC_VERSION@ |