From 6104b2bc9b58a43e42e1606f8602d2c104c2841a Mon Sep 17 00:00:00 2001 From: Fritz Elfert Date: Sun, 25 Mar 2001 03:42:13 +0000 Subject: Started kpsion doc --- conf/m4/kde/AC_BASE_PATH_KDE.m4 | 10 -- conf/m4/kde/AC_CREATE_KFSSTND.m4 | 2 + conf/m4/kde/KDE_MISSING_PROG_ERROR.m4 | 6 + conf/m4/kde/KDE_SUBST_PROGRAMS.m4 | 46 +++++++ configure.in | 2 + kde2/Makefile.am | 2 +- kde2/doc/Makefile.am | 1 + kde2/doc/en/Makefile.am | 6 + kde2/doc/en/index.docbook.in | 220 ++++++++++++++++++++++++++++++++++ 9 files changed, 284 insertions(+), 11 deletions(-) create mode 100644 conf/m4/kde/KDE_MISSING_PROG_ERROR.m4 create mode 100644 conf/m4/kde/KDE_SUBST_PROGRAMS.m4 create mode 100644 kde2/doc/Makefile.am create mode 100644 kde2/doc/en/Makefile.am create mode 100644 kde2/doc/en/index.docbook.in 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 @@ +KPsion" + -- delete this, if kpsion is in global KDE entities --> + + + + + + + %ents; +]> + + + + +The &kpsion; handbook + + + +Fritz +Elfert + +
felfert@to.com
+ + + + + + + + +2001 +Fritz Elfert + + +&FDLNotice; + +__DATE__ +__VERSION__ + + + +&kpsion; is an application for +handling backup, restore and formatting of Psion PDAs. + + + +KDE +plptools +KPsion +Psion +PDA +backup +restore +format + + + + + +Introduction + +Welcome to &kpsion;! &kpsion; is an application +handling backup, restore and formatting of Psion PDAs +for the K Desktop Environment. It uses the daemon ncpd +and the libraries from the plptools package. + + +This program is meant to be started from the command line or from +.desktop files. + + + + + +Installation + + +Downloading + +&kpsion; is part of the plptools package. The plptools package is +available at http://plptools.sourceforge.net/. + + + + +Compiling + +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 when running plptools configure. + +The build process usual works like this: + + +$ ./configure +$ make +$ make + + +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. + + + + + +Using &kpsion; + +Usage of &kpsion; is easy. The syntax is one of the following: + + + kpsion + + + + kpsion + --autobackup + + + + kpsion + --backup DRIVE + + + + kpsion + --restore DRIVE + + + + kpsion + --format DRIVE + + +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. + + + + + +This specifies to run a scheduled backup of the connected +Psion. If no psion is connected, nothing happens. + + + + + + +This option starts backup of the specified DRIVE. +DRIVE is a single drive letter. + + + + + + +This option starts restore of the specified DRIVE. +DRIVE is a single drive letter. + + + + + + +This option starts format of the specified DRIVE. +DRIVE is a single drive letter. + + + + + + + + +Configuration + +TBD + + + +Internals + +TBD + + + +Author + +Copyright 2001 Fritz Elfert + +&kpsion; is written by Fritz Elfert. + +The author can be reached through email at +felfert@to.com. Please report any bugs you find to me so +that I can fix them. If you have a suggestion, feel free to contact me. + +&underFDL; +&underGPL; + + + + -- cgit v1.2.3