diff options
Diffstat (limited to 'docs/reference/st')
-rw-r--r-- | docs/reference/st/meson.build | 23 | ||||
-rw-r--r-- | docs/reference/st/st-docs.sgml | 69 | ||||
-rw-r--r-- | docs/reference/st/version.xml.in | 1 |
3 files changed, 93 insertions, 0 deletions
diff --git a/docs/reference/st/meson.build b/docs/reference/st/meson.build new file mode 100644 index 0000000..0c4b420 --- /dev/null +++ b/docs/reference/st/meson.build @@ -0,0 +1,23 @@ +private_headers = [ + 'st-private.h', + 'st-theme-node-private.h' +] + +configure_file( + input: 'version.xml.in', + output: 'version.xml', + configuration: version_conf +) + +gnome.gtkdoc('st', + main_sgml: 'st-docs.sgml', + src_dir: [ + join_paths(meson.project_source_root(), 'src', 'st'), + join_paths(meson.project_build_root(), 'src', 'st') + ], + scan_args: [ + '--ignore-headers=' + ' '.join(private_headers), + '--rebuild-sections' + ], + install: true +) diff --git a/docs/reference/st/st-docs.sgml b/docs/reference/st/st-docs.sgml new file mode 100644 index 0000000..4e5fd99 --- /dev/null +++ b/docs/reference/st/st-docs.sgml @@ -0,0 +1,69 @@ +<?xml version="1.0"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" +[ + <!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'"> + <!ENTITY version SYSTEM "version.xml"> +]> +<book id="index"> + <bookinfo> + <title>St Reference Manual</title> + <releaseinfo> + for St &version;. + <!--The latest version of this documentation can be found on-line at + <ulink role="online-location" url="http://[SERVER]/st/index.html">http://[SERVER]/st/</ulink>.--> + </releaseinfo> + </bookinfo> + + <part> + <title>API reference</title> + <chapter id="base"> + <title>Abstract classes and Interfaces</title> + <xi:include href="xml/st-widget.xml"/> + <xi:include href="xml/st-widget-accessible.xml"/> + <xi:include href="xml/st-scrollable.xml"/> + </chapter> + <chapter id="widgets"> + <title>Widgets</title> + <xi:include href="xml/st-button.xml"/> + <xi:include href="xml/st-drawing-area.xml"/> + <xi:include href="xml/st-entry.xml"/> + <xi:include href="xml/st-icon.xml"/> + <xi:include href="xml/st-label.xml"/> + </chapter> + <chapter id="containers"> + <title>Containers</title> + <xi:include href="xml/st-bin.xml"/> + <xi:include href="xml/st-box-layout.xml"/> + <xi:include href="xml/st-scroll-view.xml"/> + </chapter> + + <chapter id="styling"> + <title>Styling</title> + <xi:include href="xml/st-theme.xml"/> + <xi:include href="xml/st-theme-context.xml"/> + <xi:include href="xml/st-theme-node.xml"/> + <xi:include href="xml/st-theme-node-transition.xml"/> + <xi:include href="xml/st-texture-cache.xml"/> + </chapter> + </part> + <!-- FIXME: + Not generated at the moment, find out whether to blame gtk-doc or meson + --> + <!-- + <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> diff --git a/docs/reference/st/version.xml.in b/docs/reference/st/version.xml.in new file mode 100644 index 0000000..d78bda9 --- /dev/null +++ b/docs/reference/st/version.xml.in @@ -0,0 +1 @@ +@VERSION@ |