Generating documentation through Gtk-doc
This commit is contained in:
parent
f53572c3bc
commit
6ffb4aed9a
12
Makefile
12
Makefile
|
@ -1,6 +1,6 @@
|
||||||
PACKAGE = Mailer
|
PACKAGE = Mailer
|
||||||
VERSION = 0.1.4
|
VERSION = 0.1.4
|
||||||
SUBDIRS = data include po src
|
SUBDIRS = data doc include po src
|
||||||
RM ?= rm -f
|
RM ?= rm -f
|
||||||
LN ?= ln -f
|
LN ?= ln -f
|
||||||
TAR ?= tar -czvf
|
TAR ?= tar -czvf
|
||||||
|
@ -48,6 +48,16 @@ dist:
|
||||||
$(PACKAGE)-$(VERSION)/data/48x48/mailer-outbox.png \
|
$(PACKAGE)-$(VERSION)/data/48x48/mailer-outbox.png \
|
||||||
$(PACKAGE)-$(VERSION)/data/48x48/mailer-sent.png \
|
$(PACKAGE)-$(VERSION)/data/48x48/mailer-sent.png \
|
||||||
$(PACKAGE)-$(VERSION)/data/48x48/project.conf \
|
$(PACKAGE)-$(VERSION)/data/48x48/project.conf \
|
||||||
|
$(PACKAGE)-$(VERSION)/doc/Makefile \
|
||||||
|
$(PACKAGE)-$(VERSION)/doc/GRAMMAR \
|
||||||
|
$(PACKAGE)-$(VERSION)/doc/gtkdoc.sh \
|
||||||
|
$(PACKAGE)-$(VERSION)/doc/project.conf \
|
||||||
|
$(PACKAGE)-$(VERSION)/doc/gtkdoc/Makefile \
|
||||||
|
$(PACKAGE)-$(VERSION)/doc/gtkdoc/Mailer-docs.xml \
|
||||||
|
$(PACKAGE)-$(VERSION)/doc/gtkdoc/project.conf \
|
||||||
|
$(PACKAGE)-$(VERSION)/doc/gtkdoc/tmpl/Makefile \
|
||||||
|
$(PACKAGE)-$(VERSION)/doc/gtkdoc/tmpl/Mailer.sgml \
|
||||||
|
$(PACKAGE)-$(VERSION)/doc/gtkdoc/tmpl/project.conf \
|
||||||
$(PACKAGE)-$(VERSION)/include/Mailer.h \
|
$(PACKAGE)-$(VERSION)/include/Mailer.h \
|
||||||
$(PACKAGE)-$(VERSION)/include/Makefile \
|
$(PACKAGE)-$(VERSION)/include/Makefile \
|
||||||
$(PACKAGE)-$(VERSION)/include/project.conf \
|
$(PACKAGE)-$(VERSION)/include/project.conf \
|
||||||
|
|
45
doc/Makefile
Normal file
45
doc/Makefile
Normal file
|
@ -0,0 +1,45 @@
|
||||||
|
SUBDIRS = gtkdoc
|
||||||
|
TARGETS = gtkdoc/Mailer.types gtkdoc/tmpl.stamp gtkdoc/sgml.stamp gtkdoc/html.stamp
|
||||||
|
PREFIX = /usr/local
|
||||||
|
DESTDIR =
|
||||||
|
RM ?= rm -f
|
||||||
|
LN ?= ln -f
|
||||||
|
MKDIR ?= mkdir -p
|
||||||
|
INSTALL ?= install
|
||||||
|
|
||||||
|
|
||||||
|
all: subdirs $(TARGETS)
|
||||||
|
|
||||||
|
subdirs:
|
||||||
|
@for i in $(SUBDIRS); do (cd $$i && $(MAKE)) || exit; done
|
||||||
|
|
||||||
|
gtkdoc/Mailer.types: ../config.sh
|
||||||
|
./gtkdoc.sh -P "$(PREFIX)" -- "gtkdoc/Mailer.types"
|
||||||
|
|
||||||
|
gtkdoc/tmpl.stamp: gtkdoc/Mailer.types
|
||||||
|
./gtkdoc.sh -P "$(PREFIX)" -- "gtkdoc/tmpl.stamp"
|
||||||
|
|
||||||
|
gtkdoc/sgml.stamp: gtkdoc/tmpl.stamp
|
||||||
|
./gtkdoc.sh -P "$(PREFIX)" -- "gtkdoc/sgml.stamp"
|
||||||
|
|
||||||
|
gtkdoc/html.stamp: gtkdoc/Mailer-docs.xml gtkdoc/sgml.stamp
|
||||||
|
./gtkdoc.sh -P "$(PREFIX)" -- "gtkdoc/html.stamp"
|
||||||
|
|
||||||
|
clean:
|
||||||
|
@for i in $(SUBDIRS); do (cd $$i && $(MAKE) clean) || exit; done
|
||||||
|
$(RM) -- $(gtkdoc/Mailer.types_OBJS) $(gtkdoc/tmpl.stamp_OBJS) $(gtkdoc/sgml.stamp_OBJS) $(gtkdoc/html.stamp_OBJS)
|
||||||
|
|
||||||
|
distclean:
|
||||||
|
@for i in $(SUBDIRS); do (cd $$i && $(MAKE) distclean) || exit; done
|
||||||
|
$(RM) -- $(gtkdoc/Mailer.types_OBJS) $(gtkdoc/tmpl.stamp_OBJS) $(gtkdoc/sgml.stamp_OBJS) $(gtkdoc/html.stamp_OBJS)
|
||||||
|
$(RM) -- $(TARGETS)
|
||||||
|
|
||||||
|
install: $(TARGETS)
|
||||||
|
@for i in $(SUBDIRS); do (cd $$i && $(MAKE) install) || exit; done
|
||||||
|
./gtkdoc.sh -P "$(DESTDIR)$(PREFIX)" -i -- "gtkdoc/html.stamp"
|
||||||
|
|
||||||
|
uninstall:
|
||||||
|
@for i in $(SUBDIRS); do (cd $$i && $(MAKE) uninstall) || exit; done
|
||||||
|
./gtkdoc.sh -P "$(DESTDIR)$(PREFIX)" -u -- "gtkdoc/html.stamp"
|
||||||
|
|
||||||
|
.PHONY: all subdirs clean distclean install uninstall
|
160
doc/gtkdoc.sh
Executable file
160
doc/gtkdoc.sh
Executable file
|
@ -0,0 +1,160 @@
|
||||||
|
#!/bin/sh
|
||||||
|
#$Id$
|
||||||
|
#Copyright (c) 2012 Pierre Pronchery <khorben@defora.org>
|
||||||
|
#
|
||||||
|
#Redistribution and use in source and binary forms, with or without
|
||||||
|
#modification, are permitted provided that the following conditions are met:
|
||||||
|
#
|
||||||
|
# * Redistributions of source code must retain the above copyright notice, this
|
||||||
|
# list of conditions and the following disclaimer.
|
||||||
|
# * Redistributions in binary form must reproduce the above copyright notice,
|
||||||
|
# this list of conditions and the following disclaimer in the documentation
|
||||||
|
# and/or other materials provided with the distribution.
|
||||||
|
#
|
||||||
|
#THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
||||||
|
#AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||||
|
#IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||||
|
#DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
|
||||||
|
#FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||||
|
#DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||||
|
#SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
||||||
|
#CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
||||||
|
#OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
||||||
|
#OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
#variables
|
||||||
|
PREFIX="/usr/local"
|
||||||
|
. "../config.sh"
|
||||||
|
DEBUG="_debug"
|
||||||
|
GTKDOC_FIXXREF="gtkdoc-fixxref"
|
||||||
|
GTKDOC_MKDB="gtkdoc-mkdb"
|
||||||
|
GTKDOC_MKHTML="gtkdoc-mkhtml"
|
||||||
|
GTKDOC_MKTMPL="gtkdoc-mktmpl"
|
||||||
|
GTKDOC_SCAN="gtkdoc-scan"
|
||||||
|
INSTALL="install -m 0644"
|
||||||
|
MKDIR="mkdir -p"
|
||||||
|
MODULE="$PACKAGE"
|
||||||
|
RM="rm -f"
|
||||||
|
TOUCH="touch"
|
||||||
|
|
||||||
|
|
||||||
|
#functions
|
||||||
|
#debug
|
||||||
|
_debug()
|
||||||
|
{
|
||||||
|
echo $@
|
||||||
|
$@
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
#usage
|
||||||
|
_usage()
|
||||||
|
{
|
||||||
|
echo "Usage: gtkdoc.sh [-i|-u][-P prefix] target" 1>&2
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
#main
|
||||||
|
install=0
|
||||||
|
uninstall=0
|
||||||
|
while getopts "iuP:" "name"; do
|
||||||
|
case "$name" in
|
||||||
|
i)
|
||||||
|
uninstall=0
|
||||||
|
install=1
|
||||||
|
;;
|
||||||
|
u)
|
||||||
|
install=0
|
||||||
|
uninstall=1
|
||||||
|
;;
|
||||||
|
P)
|
||||||
|
PREFIX="$2"
|
||||||
|
;;
|
||||||
|
?)
|
||||||
|
_usage
|
||||||
|
exit $?
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
shift $((OPTIND - 1))
|
||||||
|
if [ $# -eq 0 ]; then
|
||||||
|
_usage
|
||||||
|
exit $?
|
||||||
|
fi
|
||||||
|
|
||||||
|
[ -z "$DATADIR" ] && DATADIR="$PREFIX/share"
|
||||||
|
instdir="$DATADIR/gtk-doc/html"
|
||||||
|
|
||||||
|
while [ $# -gt 0 ]; do
|
||||||
|
target="$1"
|
||||||
|
shift
|
||||||
|
|
||||||
|
#uninstall
|
||||||
|
if [ "$uninstall" -eq 1 ]; then
|
||||||
|
for i in gtkdoc/html/*.*; do
|
||||||
|
file="${i##*/}"
|
||||||
|
echo $DEBUG $RM "$instdir/$MODULE/$file" \
|
||||||
|
|| exit 2
|
||||||
|
done
|
||||||
|
continue
|
||||||
|
fi
|
||||||
|
|
||||||
|
#create
|
||||||
|
case "$target" in
|
||||||
|
gtkdoc/html.stamp)
|
||||||
|
$MKDIR "gtkdoc/html" &&
|
||||||
|
(cd "gtkdoc/html" &&
|
||||||
|
$DEBUG $GTKDOC_MKHTML "$MODULE" \
|
||||||
|
"../$MODULE-docs.xml") &&
|
||||||
|
(cd "gtkdoc" &&
|
||||||
|
$DEBUG $GTKDOC_FIXXREF \
|
||||||
|
--module="$MODULE" \
|
||||||
|
--module-dir="html" \
|
||||||
|
--html-dir="$instdir")
|
||||||
|
;;
|
||||||
|
gtkdoc/sgml.stamp)
|
||||||
|
(cd "gtkdoc" &&
|
||||||
|
$DEBUG $GTKDOC_MKDB \
|
||||||
|
--module="$MODULE" \
|
||||||
|
--output-dir="xml" \
|
||||||
|
--output-format="xml" \
|
||||||
|
--tmpl-dir="tmpl")
|
||||||
|
;;
|
||||||
|
gtkdoc/tmpl.stamp)
|
||||||
|
(cd "gtkdoc" &&
|
||||||
|
$DEBUG $GTKDOC_MKTMPL \
|
||||||
|
--module="$MODULE" \
|
||||||
|
--output-dir="tmpl")
|
||||||
|
;;
|
||||||
|
gtkdoc/*.types)
|
||||||
|
(cd ".." &&
|
||||||
|
$DEBUG $GTKDOC_SCAN \
|
||||||
|
--module="$MODULE" \
|
||||||
|
--source-dir="include" \
|
||||||
|
--output-dir="doc/gtkdoc")
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
echo "$0: $target: Unknown type" 1>&2
|
||||||
|
exit 2
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
#XXX ignore errors
|
||||||
|
if [ $? -ne 0 ]; then
|
||||||
|
echo "$0: $target: Could not create documentation" 1>&2
|
||||||
|
install=0
|
||||||
|
fi
|
||||||
|
$TOUCH "$target"
|
||||||
|
|
||||||
|
#install
|
||||||
|
if [ "$install" -eq 1 ]; then
|
||||||
|
$DEBUG $MKDIR "$instdir/$MODULE" || exit 2
|
||||||
|
for i in gtkdoc/html/*.*; do
|
||||||
|
file="${i##*/}"
|
||||||
|
$DEBUG $INSTALL "$i" "$instdir/$MODULE/$file" \
|
||||||
|
|| exit 2
|
||||||
|
done
|
||||||
|
fi
|
||||||
|
done
|
40
doc/gtkdoc/Mailer-docs.xml
Normal file
40
doc/gtkdoc/Mailer-docs.xml
Normal file
|
@ -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 % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
|
||||||
|
<!ENTITY server "www.defora.org/doc/html">
|
||||||
|
<!ENTITY title "DeforaOS Mailer">
|
||||||
|
<!ENTITY version "0.1.4">
|
||||||
|
]>
|
||||||
|
<book id="index">
|
||||||
|
<bookinfo>
|
||||||
|
<title>Mailer Reference Manual</title>
|
||||||
|
<releaseinfo>
|
||||||
|
for Mailer &version;.
|
||||||
|
The latest version of this documentation can be found on-line at
|
||||||
|
<ulink role="online-location" url="http://&server;/Mailer/index.html">http://&server;/Mailer/</ulink>.
|
||||||
|
</releaseinfo>
|
||||||
|
</bookinfo>
|
||||||
|
|
||||||
|
<chapter>
|
||||||
|
<title>&title;</title>
|
||||||
|
<xi:include href="xml/account.xml"/>
|
||||||
|
<xi:include href="xml/folder.xml"/>
|
||||||
|
<xi:include href="xml/helper.xml"/>
|
||||||
|
<xi:include href="xml/mailer.xml"/>
|
||||||
|
<xi:include href="xml/message.xml"/>
|
||||||
|
<xi:include href="xml/plugin.xml"/>
|
||||||
|
|
||||||
|
</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>
|
21
doc/gtkdoc/Makefile
Normal file
21
doc/gtkdoc/Makefile
Normal file
|
@ -0,0 +1,21 @@
|
||||||
|
SUBDIRS = tmpl
|
||||||
|
|
||||||
|
|
||||||
|
all: subdirs
|
||||||
|
|
||||||
|
subdirs:
|
||||||
|
@for i in $(SUBDIRS); do (cd $$i && $(MAKE)) || exit; done
|
||||||
|
|
||||||
|
clean:
|
||||||
|
@for i in $(SUBDIRS); do (cd $$i && $(MAKE) clean) || exit; done
|
||||||
|
|
||||||
|
distclean:
|
||||||
|
@for i in $(SUBDIRS); do (cd $$i && $(MAKE) distclean) || exit; done
|
||||||
|
|
||||||
|
install:
|
||||||
|
@for i in $(SUBDIRS); do (cd $$i && $(MAKE) install) || exit; done
|
||||||
|
|
||||||
|
uninstall:
|
||||||
|
@for i in $(SUBDIRS); do (cd $$i && $(MAKE) uninstall) || exit; done
|
||||||
|
|
||||||
|
.PHONY: all subdirs clean distclean install uninstall
|
2
doc/gtkdoc/project.conf
Normal file
2
doc/gtkdoc/project.conf
Normal file
|
@ -0,0 +1,2 @@
|
||||||
|
subdirs=tmpl
|
||||||
|
dist=Makefile,Mailer-docs.xml
|
0
doc/gtkdoc/tmpl/Mailer-unused.sgml
Normal file
0
doc/gtkdoc/tmpl/Mailer-unused.sgml
Normal file
22
doc/gtkdoc/tmpl/Mailer.sgml
Normal file
22
doc/gtkdoc/tmpl/Mailer.sgml
Normal file
|
@ -0,0 +1,22 @@
|
||||||
|
<!-- ##### SECTION Title ##### -->
|
||||||
|
Mailer
|
||||||
|
|
||||||
|
<!-- ##### SECTION Short_Description ##### -->
|
||||||
|
DeforaOS Desktop Mailer
|
||||||
|
|
||||||
|
<!-- ##### SECTION Long_Description ##### -->
|
||||||
|
<para>
|
||||||
|
e-mail client for the DeforaOS desktop.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<!-- ##### SECTION See_Also ##### -->
|
||||||
|
<para>
|
||||||
|
DeforaOS libDesktop, DeforaOS libSystem
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<!-- ##### SECTION Stability_Level ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### SECTION Image ##### -->
|
||||||
|
|
||||||
|
|
208
doc/gtkdoc/tmpl/account.sgml
Normal file
208
doc/gtkdoc/tmpl/account.sgml
Normal file
|
@ -0,0 +1,208 @@
|
||||||
|
<!-- ##### SECTION Title ##### -->
|
||||||
|
Account
|
||||||
|
|
||||||
|
<!-- ##### SECTION Short_Description ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### SECTION Long_Description ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<!-- ##### SECTION See_Also ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<!-- ##### SECTION Stability_Level ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### SECTION Image ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### STRUCT Account ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### ENUM AccountConfigType ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@ACT_NONE:
|
||||||
|
@ACT_STRING:
|
||||||
|
@ACT_PASSWORD:
|
||||||
|
@ACT_FILE:
|
||||||
|
@ACT_UINT16:
|
||||||
|
@ACT_BOOLEAN:
|
||||||
|
@ACT_SEPARATOR:
|
||||||
|
|
||||||
|
<!-- ##### STRUCT AccountPlugin ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION authenticate ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@account:
|
||||||
|
@message:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION confirm ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@account:
|
||||||
|
@message:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION destroy ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@plugin:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION error ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@account:
|
||||||
|
@message:
|
||||||
|
@ret:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION folder_delete ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@folder:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION folder_new ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@account:
|
||||||
|
@folder:
|
||||||
|
@parent:
|
||||||
|
@type:
|
||||||
|
@name:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION get_config ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@plugin:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION get_source ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@plugin:
|
||||||
|
@folder:
|
||||||
|
@message:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION get_ssl_context ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@account:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION init ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@helper:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION message_delete ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@message:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION message_new ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@account:
|
||||||
|
@folder:
|
||||||
|
@message:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION message_set_body ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@message:
|
||||||
|
@buf:
|
||||||
|
@cnt:
|
||||||
|
@append:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION message_set_header ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@message:
|
||||||
|
@header:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION refresh ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@plugin:
|
||||||
|
@folder:
|
||||||
|
@message:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION status ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@account:
|
||||||
|
@format:
|
||||||
|
@...:
|
||||||
|
|
||||||
|
|
86
doc/gtkdoc/tmpl/folder.sgml
Normal file
86
doc/gtkdoc/tmpl/folder.sgml
Normal file
|
@ -0,0 +1,86 @@
|
||||||
|
<!-- ##### SECTION Title ##### -->
|
||||||
|
Folder
|
||||||
|
|
||||||
|
<!-- ##### SECTION Short_Description ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### SECTION Long_Description ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<!-- ##### SECTION See_Also ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<!-- ##### SECTION Stability_Level ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### SECTION Image ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### STRUCT AccountFolder ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### MACRO FT_COUNT ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### MACRO FT_LAST ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### STRUCT Folder ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### ENUM FolderType ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@FT_INBOX:
|
||||||
|
@FT_DRAFTS:
|
||||||
|
@FT_SENT:
|
||||||
|
@FT_TRASH:
|
||||||
|
@FT_FOLDER:
|
||||||
|
|
||||||
|
<!-- ##### FUNCTION folder_get_name ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@folder:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### FUNCTION folder_get_type ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@folder:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### FUNCTION folder_set_type ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@folder:
|
||||||
|
@type:
|
||||||
|
|
||||||
|
|
49
doc/gtkdoc/tmpl/helper.sgml
Normal file
49
doc/gtkdoc/tmpl/helper.sgml
Normal file
|
@ -0,0 +1,49 @@
|
||||||
|
<!-- ##### SECTION Title ##### -->
|
||||||
|
Helper
|
||||||
|
|
||||||
|
<!-- ##### SECTION Short_Description ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### SECTION Long_Description ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<!-- ##### SECTION See_Also ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<!-- ##### SECTION Stability_Level ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### SECTION Image ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### FUNCTION mailer_helper_get_email ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@header:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### FUNCTION mailer_helper_get_name ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@header:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### FUNCTION mailer_helper_is_email ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@email:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
87
doc/gtkdoc/tmpl/mailer.sgml
Normal file
87
doc/gtkdoc/tmpl/mailer.sgml
Normal file
|
@ -0,0 +1,87 @@
|
||||||
|
<!-- ##### SECTION Title ##### -->
|
||||||
|
Mailer
|
||||||
|
|
||||||
|
<!-- ##### SECTION Short_Description ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### SECTION Long_Description ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<!-- ##### SECTION See_Also ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<!-- ##### SECTION Stability_Level ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### SECTION Image ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### MACRO MFC_COUNT ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### MACRO MFC_LAST ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### MACRO MHC_COUNT ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### MACRO MHC_LAST ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### STRUCT Mailer ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### ENUM MailerFolderColumn ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@MFC_ACCOUNT:
|
||||||
|
@MFC_ENABLED:
|
||||||
|
@MFC_DELETE:
|
||||||
|
@MFC_FOLDER:
|
||||||
|
@MFC_ICON:
|
||||||
|
@MFC_NAME:
|
||||||
|
|
||||||
|
<!-- ##### ENUM MailerHeaderColumn ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@MHC_ACCOUNT:
|
||||||
|
@MHC_FOLDER:
|
||||||
|
@MHC_MESSAGE:
|
||||||
|
@MHC_ICON:
|
||||||
|
@MHC_SUBJECT:
|
||||||
|
@MHC_FROM:
|
||||||
|
@MHC_FROM_EMAIL:
|
||||||
|
@MHC_TO:
|
||||||
|
@MHC_TO_EMAIL:
|
||||||
|
@MHC_DATE:
|
||||||
|
@MHC_DATE_DISPLAY:
|
||||||
|
@MHC_READ:
|
||||||
|
@MHC_WEIGHT:
|
||||||
|
|
44
doc/gtkdoc/tmpl/message.sgml
Normal file
44
doc/gtkdoc/tmpl/message.sgml
Normal file
|
@ -0,0 +1,44 @@
|
||||||
|
<!-- ##### SECTION Title ##### -->
|
||||||
|
Message
|
||||||
|
|
||||||
|
<!-- ##### SECTION Short_Description ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### SECTION Long_Description ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<!-- ##### SECTION See_Also ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<!-- ##### SECTION Stability_Level ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### SECTION Image ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### STRUCT AccountMessage ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### STRUCT Message ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### FUNCTION message_get_header ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@message:
|
||||||
|
@header:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
86
doc/gtkdoc/tmpl/plugin.sgml
Normal file
86
doc/gtkdoc/tmpl/plugin.sgml
Normal file
|
@ -0,0 +1,86 @@
|
||||||
|
<!-- ##### SECTION Title ##### -->
|
||||||
|
MailerPlugin
|
||||||
|
|
||||||
|
<!-- ##### SECTION Short_Description ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### SECTION Long_Description ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<!-- ##### SECTION See_Also ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<!-- ##### SECTION Stability_Level ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### SECTION Image ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### STRUCT MailerPlugin ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION destroy ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@plugin:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION error ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@account:
|
||||||
|
@message:
|
||||||
|
@ret:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### FUNCTION folder_get_messages ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@folder:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION get_widget ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@plugin:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION init ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@helper:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### USER_FUNCTION refresh ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
@plugin:
|
||||||
|
@folder:
|
||||||
|
@message:
|
||||||
|
@Returns:
|
||||||
|
|
||||||
|
|
22
doc/gtkdoc/tmpl/transport.sgml
Normal file
22
doc/gtkdoc/tmpl/transport.sgml
Normal file
|
@ -0,0 +1,22 @@
|
||||||
|
<!-- ##### SECTION Title ##### -->
|
||||||
|
Transport
|
||||||
|
|
||||||
|
<!-- ##### SECTION Short_Description ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### SECTION Long_Description ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<!-- ##### SECTION See_Also ##### -->
|
||||||
|
<para>
|
||||||
|
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<!-- ##### SECTION Stability_Level ##### -->
|
||||||
|
|
||||||
|
|
||||||
|
<!-- ##### SECTION Image ##### -->
|
||||||
|
|
||||||
|
|
24
doc/project.conf
Normal file
24
doc/project.conf
Normal file
|
@ -0,0 +1,24 @@
|
||||||
|
subdirs=gtkdoc
|
||||||
|
targets=gtkdoc/Mailer.types,gtkdoc/tmpl.stamp,gtkdoc/sgml.stamp,gtkdoc/html.stamp
|
||||||
|
dist=Makefile,GRAMMAR,gtkdoc.sh
|
||||||
|
|
||||||
|
[gtkdoc/Mailer.types]
|
||||||
|
type=script
|
||||||
|
script=./gtkdoc.sh
|
||||||
|
depends=../config.sh
|
||||||
|
|
||||||
|
[gtkdoc/tmpl.stamp]
|
||||||
|
type=script
|
||||||
|
script=./gtkdoc.sh
|
||||||
|
depends=gtkdoc/Mailer.types
|
||||||
|
|
||||||
|
[gtkdoc/sgml.stamp]
|
||||||
|
type=script
|
||||||
|
script=./gtkdoc.sh
|
||||||
|
depends=gtkdoc/tmpl.stamp
|
||||||
|
|
||||||
|
[gtkdoc/html.stamp]
|
||||||
|
type=script
|
||||||
|
script=./gtkdoc.sh
|
||||||
|
depends=gtkdoc/Mailer-docs.xml,gtkdoc/sgml.stamp
|
||||||
|
install=
|
|
@ -2,5 +2,5 @@ package=Mailer
|
||||||
version=0.1.4
|
version=0.1.4
|
||||||
config=h,sh
|
config=h,sh
|
||||||
|
|
||||||
subdirs=data,include,po,src
|
subdirs=data,doc,include,po,src
|
||||||
dist=Makefile,COPYING,config.h,config.sh
|
dist=Makefile,COPYING,config.h,config.sh
|
||||||
|
|
Loading…
Reference in New Issue
Block a user