Started kpsion doc

9 files changed, 284 insertions, 11 deletions

diff --git a/conf/m4/kde/AC_BASE_PATH_KDE.m4 b/conf/m4/kde/AC_BASE_PATH_KDE.m4
index 0430f83..3878d1c 100644
--- a/conf/m4/kde/AC_BASE_PATH_KDE.m4
+++ b/conf/m4/kde/AC_BASE_PATH_KDE.m4
@@ -128,14 +128,4 @@ AC_SUBST(all_libraries)
 
 AC_SUBST(AUTODIRS)
 
-if test -z "$DCOPIDL"; then
-  DCOPIDL='$(kde_bindir)/dcopidl'
-fi
-if test -z "$DCOPIDL2CPP"; then
-  DCOPIDL2CPP='$(kde_bindir)/dcopidl2cpp'
-fi
-DCOP_DEPENDENCIES='$(DCOPIDL)'
-AC_SUBST(DCOPIDL)
-AC_SUBST(DCOPIDL2CPP)
-AC_SUBST(DCOP_DEPENDENCIES)
 ])
diff --git a/conf/m4/kde/AC_CREATE_KFSSTND.m4 b/conf/m4/kde/AC_CREATE_KFSSTND.m4
index a771332..c4fa251 100644
--- a/conf/m4/kde/AC_CREATE_KFSSTND.m4
+++ b/conf/m4/kde/AC_CREATE_KFSSTND.m4
@@ -91,4 +91,6 @@ fi
 
 bindir=$kde_bindir
 
+KDE_SUBST_PROGRAMS
+
 ])
diff --git a/conf/m4/kde/KDE_MISSING_PROG_ERROR.m4 b/conf/m4/kde/KDE_MISSING_PROG_ERROR.m4
new file mode 100644
index 0000000..e8b1d53
--- /dev/null
+++ b/conf/m4/kde/KDE_MISSING_PROG_ERROR.m4
@@ -0,0 +1,6 @@
+AC_DEFUN(KDE_MISSING_PROG_ERROR,
+[
+    AC_MSG_ERROR([The important program $1 was not found!
+Please check whether you installed KDE correctly.
+])
+])
diff --git a/conf/m4/kde/KDE_SUBST_PROGRAMS.m4 b/conf/m4/kde/KDE_SUBST_PROGRAMS.m4
new file mode 100644
index 0000000..e32facc
--- /dev/null
+++ b/conf/m4/kde/KDE_SUBST_PROGRAMS.m4
@@ -0,0 +1,46 @@
+AC_DEFUN(KDE_SUBST_PROGRAMS,
+[AC_REQUIRE([AC_CREATE_KFSSTND])dnl
+
+        kde_default_bindirs="/usr/bin /usr/local/bin /opt/local/bin /usr/X11R6/bin /opt/kde/bin /opt/kde2/bin /usr/kde/bin /usr/local/kde/bin"
+        if test -n "$KDEDIRS"; then
+           kde_save_IFS=$IFS
+           IFS=:
+           for dir in $KDEDIRS; do
+                kde_default_bindirs="$dir/bin $kde_default_bindirs "
+           done
+           IFS=$kde_save_IFS
+        fi
+        kde_default_bindirs="$exec_prefix/bin $prefix/bin $kde_default_bindirs"
+        KDE_FIND_PATH(dcopidl, DCOPIDL, [$kde_default_bindirs], [KDE_MISSING_PROG_ERROR(dcopidl)])
+        KDE_FIND_PATH(dcopidl2cpp, DCOPIDL2CPP, [$kde_default_bindirs], [KDE_MISSING_PROG_ERROR(dcopidl2cpp)])
+        KDE_FIND_PATH(mcopidl, MCOPIDL, [$kde_default_bindirs], [KDE_MISSING_PROG_ERROR(mcopidl)])
+        KDE_FIND_PATH(kdb2html, KDB2HTML, [$kde_default_bindirs], [KDE_MISSING_PROG_ERROR(kdb2html)])
+        KDE_FIND_PATH(artsc-config, ARTSCCONFIG, [$kde_default_bindirs], [KDE_MISSING_PROG_ERROR(artsc-config)])
+        KDE_FIND_PATH(kde-config, KDECONFIG, [$kde_default_bindirs], [KDE_MISSING_PROG_ERROR(kde-config)])
+
+        DCOP_DEPENDENCIES='$(DCOPIDL)'
+        AC_SUBST(DCOPIDL)
+        AC_SUBST(DCOPIDL2CPP)
+        AC_SUBST(DCOP_DEPENDENCIES)
+        AC_SUBST(MCOPIDL)
+        AC_SUBST(KDB2HTML)
+        AC_SUBST(ARTSCCONFIG)
+        AC_SUBST(KDECONFIG)
+
+        if test -x "$KDECONFIG"; then # it can be "compiled"
+          kde_libs_prefix=`$KDECONFIG --prefix`
+          if test -z "$kde_libs_prefix" || test ! -x "$kde_libs_prefix"; then
+               AC_MSG_ERROR([$KDECONFIG --prefix outputed the non existant prefix '$kde_libs_prefix' for kdelibs.
+                          This means it has been moved since you installed it.
+                          This won't work. Please recompile kdelibs for the new prefix.
+                          ])
+           fi
+           kde_libs_htmldir=`$KDECONFIG --install html --expandvars`
+        else
+           kde_libs_prefix='$(prefix)'
+           kde_libs_htmldir='$(kde_htmldir)'
+        fi
+        AC_SUBST(kde_libs_prefix)
+        AC_SUBST(kde_libs_htmldir)
+])dnl
+
diff --git a/configure.in b/configure.in
index becfdf5..fe67737 100644
--- a/configure.in
+++ b/configure.in
@@ -278,6 +278,8 @@ AC_OUTPUT(
 	kde2/po/de/Makefile
 	kde2/mime/Makefile
 	kde2/mime/icons/Makefile
+	kde2/doc/Makefile
+	kde2/doc/en/Makefile
 	plpbackup/Makefile
 	doc/Makefile
 	doc/api/Makefile
diff --git a/kde2/Makefile.am b/kde2/Makefile.am
index 5d24666..72ccb9d 100644
--- a/kde2/Makefile.am
+++ b/kde2/Makefile.am
@@ -1,7 +1,7 @@
 # $Id$
 #
 
-SUBDIRS = kioslave plugins mime kpsion po
+SUBDIRS = kioslave plugins mime kpsion po doc
 
 POFILES =
 #
diff --git a/kde2/doc/Makefile.am b/kde2/doc/Makefile.am
new file mode 100644
index 0000000..81fee21
--- /dev/null
+++ b/kde2/doc/Makefile.am
@@ -0,0 +1 @@
+SUBDIRS = en
diff --git a/kde2/doc/en/Makefile.am b/kde2/doc/en/Makefile.am
new file mode 100644
index 0000000..77093f1
--- /dev/null
+++ b/kde2/doc/en/Makefile.am
@@ -0,0 +1,6 @@
+
+KDE_LANG = en
+KDE_DOCS = kpsion
+
+index.docbook: index.docbook.in
+	cp index.docbook.in index.docbook
diff --git a/kde2/doc/en/index.docbook.in b/kde2/doc/en/index.docbook.in
new file mode 100644
index 0000000..6b4d4ce
--- /dev/null
+++ b/kde2/doc/en/index.docbook.in
@@ -0,0 +1,220 @@
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
+  <!ENTITY kpsion  "<application>KPsion</application>"
+    -- delete this, if kpsion is in global KDE entities -->
+  <!ENTITY kappname "&kpsion;" -- this only *seems* redundant -->
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE">
+  <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Documentation V1.0//EN">
+  <!-- DO NOT DELETE! $Revision$ -->
+  <!-- DO NOT DELETE! $Date$ -->
+  %ents;
+]>
+
+<book lang="&language;">
+<bookinfo>
+
+<title>The &kpsion; handbook</title>
+
+<authorgroup>
+<author>
+<firstname>Fritz</firstname>
+<surname>Elfert</surname>
+<affiliation>
+<address><email>felfert@to.com</email></address>
+</affiliation>
+</author>
+
+<!--
+<othercredit role="reviewer">
+<firstname>Whoever</firstname>
+<surname>Lastname</surname>
+<affiliation>
+<address><email>mail@somewhere.org</email></address>
+</affiliation>
+<contrib>Reviewer</contrib>
+</othercredit>
+-->
+
+</authorgroup>
+
+<copyright>
+<year>2001</year>
+<holder>Fritz Elfert</holder>
+</copyright>
+
+<legalnotice>&FDLNotice;</legalnotice>
+
+<date>__DATE__</date>
+<releaseinfo>__VERSION__</releaseinfo>
+
+
+<abstract><para>
+&kpsion; is an application for
+handling backup, restore and formatting of Psion PDAs.
+</para></abstract>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>plptools</keyword>
+<keyword>KPsion</keyword>
+<keyword>Psion</keyword>
+<keyword>PDA</keyword>
+<keyword>backup</keyword>
+<keyword>restore</keyword>
+<keyword>format</keyword>
+</keywordset>
+
+</bookinfo>
+
+<chapter id="Introduction">
+<title>Introduction</title>
+
+<para>Welcome to &kpsion;! &kpsion; is an application
+handling backup, restore and formatting of Psion PDAs
+for the K Desktop Environment. It uses the daemon <command>ncpd</command>
+and the libraries from the plptools package.
+</para>
+
+<para>This program is meant to be started from the command line or from
+<filename>.desktop</filename> files.
+</para>
+
+</chapter>
+
+<chapter id="installation">
+<title>Installation</title>
+
+<sect1 id="downloading">
+<title>Downloading</title>
+
+<para>&kpsion; is part of the plptools package. The plptools package is
+available at <ulink url="http://plptools.sourceforge.net/">http://plptools.sourceforge.net/</ulink>.</para>
+
+</sect1>
+
+<sect1 id="compiling">
+<title>Compiling</title>
+
+<para>The plptools package is not focussed on KDE application. Therefore, to
+enable the build of KDE related stuff (&kpsion; is part of that) you have to
+use the option <option>--enable-kde</option> when running plptools configure.</para>
+
+<para>The build process usual works like this:</para>
+
+<screen>
+<prompt>$</prompt> <command>./configure <option>--enable-kde</option></command>
+<prompt>$</prompt> <command>make</command>
+<prompt>$</prompt> <command>make <option>install</option></command>
+</screen>
+
+<para>You will have to execute the last step as root. The installation process
+needs to be able to write to the system wide KDE directories.</para>
+
+</sect1>
+</chapter>
+
+<chapter id="using-kpsion">
+<title>Using &kpsion;</title>
+
+<para>Usage of &kpsion; is easy. The syntax is one of the following:</para>
+
+    <cmdsynopsis>
+      <command>kpsion</command>
+    </cmdsynopsis>
+
+    <cmdsynopsis>
+      <command>kpsion</command>
+      <arg>--autobackup</arg>
+    </cmdsynopsis>
+
+    <cmdsynopsis>
+      <command>kpsion</command>
+      <arg>--backup <replaceable>DRIVE</replaceable></arg>
+    </cmdsynopsis>
+
+    <cmdsynopsis>
+      <command>kpsion</command>
+      <arg>--restore <replaceable>DRIVE</replaceable></arg>
+    </cmdsynopsis>
+
+    <cmdsynopsis>
+      <command>kpsion</command>
+      <arg>--format <replaceable>DRIVE</replaceable></arg>
+    </cmdsynopsis>
+
+<para>If started without any options, &kpsion; starts up in interactive
+mode. If started with any of the above options, &kpsion; performs the
+given task non interactively.</para>
+
+<variablelist>
+<varlistentry>
+<term><option>--autobackup</option></term>
+<listitem><para>
+This specifies to run a scheduled backup of the connected
+Psion. If no psion is connected, nothing happens.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><option>--backup <replaceable>DRIVE</replaceable></option></term>
+<listitem><para>
+This option starts backup of the specified <replaceable>DRIVE</replaceable>.
+<replaceable>DRIVE</replaceable> is a single drive letter.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><option>--restore <replaceable>DRIVE</replaceable></option></term>
+<listitem><para>
+This option starts restore of the specified <replaceable>DRIVE</replaceable>.
+<replaceable>DRIVE</replaceable> is a single drive letter.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><option>--format <replaceable>DRIVE</replaceable></option></term>
+<listitem><para>
+This option starts format of the specified <replaceable>DRIVE</replaceable>.
+<replaceable>DRIVE</replaceable> is a single drive letter.
+</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</chapter>
+
+<chapter id="Configuration">
+<title>Configuration</title>
+
+<para>TBD</para>
+</chapter>
+
+<chapter id="Internals">
+<title>Internals</title>
+
+<para>TBD</para>
+</chapter>
+
+<chapter id="Author">
+<title>Author</title>
+
+<para>Copyright 2001 Fritz Elfert</para>
+
+<para>&kpsion; is written by Fritz Elfert.</para>
+
+<para>The author can be reached through email at
+<email>felfert@to.com</email>.  Please report any bugs you find to me so
+that I can fix them. If you have a suggestion, feel free to contact me.</para>
+
+&underFDL;
+&underGPL;
+
+</chapter>
+</book>
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+End:
+-->