diff options
-rw-r--r-- | conf/m4/kde/AC_BASE_PATH_KDE.m4 | 10 | ||||
-rw-r--r-- | conf/m4/kde/AC_CREATE_KFSSTND.m4 | 2 | ||||
-rw-r--r-- | conf/m4/kde/KDE_MISSING_PROG_ERROR.m4 | 6 | ||||
-rw-r--r-- | conf/m4/kde/KDE_SUBST_PROGRAMS.m4 | 46 | ||||
-rw-r--r-- | configure.in | 2 | ||||
-rw-r--r-- | kde2/Makefile.am | 2 | ||||
-rw-r--r-- | kde2/doc/Makefile.am | 1 | ||||
-rw-r--r-- | kde2/doc/en/Makefile.am | 6 | ||||
-rw-r--r-- | kde2/doc/en/index.docbook.in | 220 |
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: +--> |