diff options
| author | Slávek Banko <slavek.banko@axis.cz> | 2013-07-02 18:32:11 +0200 |
|---|---|---|
| committer | Slávek Banko <slavek.banko@axis.cz> | 2013-07-02 18:32:11 +0200 |
| commit | 5ec5bc2080bbc41e025fb98e6571a2c281b775cb (patch) | |
| tree | a73cf2c57d306e6ce092996f70b29b8fbc0a006b /doc/en/kbiff | |
| download | kbiff-5ec5bc2080bbc41e025fb98e6571a2c281b775cb.tar.gz kbiff-5ec5bc2080bbc41e025fb98e6571a2c281b775cb.zip | |
Initial import
Diffstat (limited to 'doc/en/kbiff')
| -rw-r--r-- | doc/en/kbiff/Makefile.am | 2 | ||||
| -rw-r--r-- | doc/en/kbiff/Makefile.in | 600 | ||||
| -rw-r--r-- | doc/en/kbiff/index.docbook | 658 | ||||
| -rw-r--r-- | doc/en/kbiff/kbiff.png | bin | 0 -> 557 bytes |
4 files changed, 1260 insertions, 0 deletions
diff --git a/doc/en/kbiff/Makefile.am b/doc/en/kbiff/Makefile.am new file mode 100644 index 0000000..171f575 --- /dev/null +++ b/doc/en/kbiff/Makefile.am @@ -0,0 +1,2 @@ +KDE_LANG = en +KDE_DOCS = AUTO diff --git a/doc/en/kbiff/Makefile.in b/doc/en/kbiff/Makefile.in new file mode 100644 index 0000000..801774c --- /dev/null +++ b/doc/en/kbiff/Makefile.in @@ -0,0 +1,600 @@ +# Makefile.in generated by automake 1.10.1 from Makefile.am. +# KDE tags expanded automatically by am_edit - $Revision$ +# @configure_input@ + +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, +# 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ +VPATH = @srcdir@ +pkgdatadir = $(datadir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +build_triplet = @build@ +host_triplet = @host@ +target_triplet = @target@ +subdir = doc/en/kbiff +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/acinclude.m4 \ + $(top_srcdir)/configure.in +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(SHELL) $(top_srcdir)/admin/mkinstalldirs +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = +SOURCES = +DIST_SOURCES = +#>- DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +#>+ 1 +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) $(KDE_DIST) +ACLOCAL = @ACLOCAL@ +AMTAR = @AMTAR@ +AR = @AR@ +ARTSCCONFIG = @ARTSCCONFIG@ +AUTOCONF = @AUTOCONF@ +AUTODIRS = @AUTODIRS@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CC = @CC@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +CONF_FILES = @CONF_FILES@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CXX = @CXX@ +CXXCPP = @CXXCPP@ +CXXDEPMODE = @CXXDEPMODE@ +CXXFLAGS = @CXXFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DCOPIDL = @DCOPIDL@ +DCOPIDL2CPP = @DCOPIDL2CPP@ +DCOPIDLNG = @DCOPIDLNG@ +DCOP_DEPENDENCIES = @DCOP_DEPENDENCIES@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +ECHO = @ECHO@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +ENABLE_PERMISSIVE_FLAG = @ENABLE_PERMISSIVE_FLAG@ +EXEEXT = @EXEEXT@ +F77 = @F77@ +FFLAGS = @FFLAGS@ +FRAMEWORK_COREAUDIO = @FRAMEWORK_COREAUDIO@ +GMSGFMT = @GMSGFMT@ +GREP = @GREP@ +HAVE_GCC_VISIBILITY = @HAVE_GCC_VISIBILITY@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +KCFG_DEPENDENCIES = @KCFG_DEPENDENCIES@ +KCONFIG_COMPILER = @KCONFIG_COMPILER@ +KDECONFIG = @KDECONFIG@ +KDE_CHECK_PLUGIN = @KDE_CHECK_PLUGIN@ +KDE_EXTRA_RPATH = @KDE_EXTRA_RPATH@ +KDE_INCLUDES = @KDE_INCLUDES@ +KDE_LDFLAGS = @KDE_LDFLAGS@ +KDE_MT_LDFLAGS = @KDE_MT_LDFLAGS@ +KDE_MT_LIBS = @KDE_MT_LIBS@ +KDE_NO_UNDEFINED = @KDE_NO_UNDEFINED@ +KDE_PLUGIN = @KDE_PLUGIN@ +KDE_RPATH = @KDE_RPATH@ +KDE_USE_CLOSURE_FALSE = @KDE_USE_CLOSURE_FALSE@ +KDE_USE_CLOSURE_TRUE = @KDE_USE_CLOSURE_TRUE@ +KDE_USE_FINAL_FALSE = @KDE_USE_FINAL_FALSE@ +KDE_USE_FINAL_TRUE = @KDE_USE_FINAL_TRUE@ +KDE_USE_FPIE = @KDE_USE_FPIE@ +KDE_USE_NMCHECK_FALSE = @KDE_USE_NMCHECK_FALSE@ +KDE_USE_NMCHECK_TRUE = @KDE_USE_NMCHECK_TRUE@ +KDE_USE_PIE = @KDE_USE_PIE@ +KDE_XSL_STYLESHEET = @KDE_XSL_STYLESHEET@ +LDFLAGS = @LDFLAGS@ +LDFLAGS_AS_NEEDED = @LDFLAGS_AS_NEEDED@ +LDFLAGS_NEW_DTAGS = @LDFLAGS_NEW_DTAGS@ +LIBCOMPAT = @LIBCOMPAT@ +LIBCRYPT = @LIBCRYPT@ +LIBDL = @LIBDL@ +LIBJPEG = @LIBJPEG@ +LIBOBJS = @LIBOBJS@ +LIBPNG = @LIBPNG@ +LIBPTHREAD = @LIBPTHREAD@ +LIBRESOLV = @LIBRESOLV@ +LIBS = @LIBS@ +LIBSM = @LIBSM@ +LIBSOCKET = @LIBSOCKET@ +LIBTOOL = @LIBTOOL@ +LIBUCB = @LIBUCB@ +LIBUTIL = @LIBUTIL@ +LIBZ = @LIBZ@ +LIB_KAB = @LIB_KAB@ +LIB_KABC = @LIB_KABC@ +LIB_KDECORE = @LIB_KDECORE@ +LIB_KDED = @LIB_KDED@ +LIB_KDEPIM = @LIB_KDEPIM@ +LIB_KDEPRINT = @LIB_KDEPRINT@ +LIB_KDEUI = @LIB_KDEUI@ +LIB_KDNSSD = @LIB_KDNSSD@ +LIB_KFILE = @LIB_KFILE@ +LIB_KFM = @LIB_KFM@ +LIB_KHTML = @LIB_KHTML@ +LIB_KIMPROXY = @LIB_KIMPROXY@ +LIB_KIO = @LIB_KIO@ +LIB_KJS = @LIB_KJS@ +LIB_KNEWSTUFF = @LIB_KNEWSTUFF@ +LIB_KPARTS = @LIB_KPARTS@ +LIB_KSPELL = @LIB_KSPELL@ +LIB_KSYCOCA = @LIB_KSYCOCA@ +LIB_KUNITTEST = @LIB_KUNITTEST@ +LIB_KUTILS = @LIB_KUTILS@ +LIB_POLL = @LIB_POLL@ +LIB_QPE = @LIB_QPE@ +LIB_QT = @LIB_QT@ +LIB_SMB = @LIB_SMB@ +LIB_X11 = @LIB_X11@ +LIB_XEXT = @LIB_XEXT@ +LIB_XRENDER = @LIB_XRENDER@ +LN_S = @LN_S@ +LTLIBOBJS = @LTLIBOBJS@ +MAKEINFO = @MAKEINFO@ +MAKEKDEWIDGETS = @MAKEKDEWIDGETS@ +MCOPIDL = @MCOPIDL@ +MEINPROC = @MEINPROC@ +MKDIR_P = @MKDIR_P@ +MOC = @MOC@ +MSGFMT = @MSGFMT@ +NOOPT_CFLAGS = @NOOPT_CFLAGS@ +NOOPT_CXXFLAGS = @NOOPT_CXXFLAGS@ +OBJEXT = @OBJEXT@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ +PKG_CONFIG = @PKG_CONFIG@ +QTE_NORTTI = @QTE_NORTTI@ +QT_INCLUDES = @QT_INCLUDES@ +QT_LDFLAGS = @QT_LDFLAGS@ +RANLIB = @RANLIB@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +TOPSUBDIRS = @TOPSUBDIRS@ +UIC = @UIC@ +UIC_TR = @UIC_TR@ +USER_INCLUDES = @USER_INCLUDES@ +USER_LDFLAGS = @USER_LDFLAGS@ +USE_EXCEPTIONS = @USE_EXCEPTIONS@ +USE_RTTI = @USE_RTTI@ +USE_THREADS = @USE_THREADS@ +VERSION = @VERSION@ +WOVERLOADED_VIRTUAL = @WOVERLOADED_VIRTUAL@ +XGETTEXT = @XGETTEXT@ +XMKMF = @XMKMF@ +XMLLINT = @XMLLINT@ +X_EXTRA_LIBS = @X_EXTRA_LIBS@ +X_INCLUDES = @X_INCLUDES@ +X_LDFLAGS = @X_LDFLAGS@ +X_PRE_LIBS = @X_PRE_LIBS@ +X_RPATH = @X_RPATH@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +ac_ct_CC = @ac_ct_CC@ +ac_ct_CXX = @ac_ct_CXX@ +ac_ct_F77 = @ac_ct_F77@ +all_includes = @all_includes@ +all_libraries = @all_libraries@ +am__include = @am__include@ +am__leading_dot = @am__leading_dot@ +am__quote = @am__quote@ +am__tar = @am__tar@ +am__untar = @am__untar@ +bindir = @bindir@ +build = @build@ +build_alias = @build_alias@ +build_cpu = @build_cpu@ +build_os = @build_os@ +build_vendor = @build_vendor@ +builddir = @builddir@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +host = @host@ +host_alias = @host_alias@ +host_cpu = @host_cpu@ +host_os = @host_os@ +host_vendor = @host_vendor@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +kde_appsdir = @kde_appsdir@ +kde_bindir = @kde_bindir@ +kde_confdir = @kde_confdir@ +kde_datadir = @kde_datadir@ +kde_htmldir = @kde_htmldir@ +kde_icondir = @kde_icondir@ +kde_includes = @kde_includes@ +kde_kcfgdir = @kde_kcfgdir@ +kde_libraries = @kde_libraries@ +kde_libs_htmldir = @kde_libs_htmldir@ +kde_libs_prefix = @kde_libs_prefix@ +kde_locale = @kde_locale@ +kde_mimedir = @kde_mimedir@ +kde_moduledir = @kde_moduledir@ +kde_qtver = @kde_qtver@ +kde_servicesdir = @kde_servicesdir@ +kde_servicetypesdir = @kde_servicetypesdir@ +kde_sounddir = @kde_sounddir@ +kde_styledir = @kde_styledir@ +kde_templatesdir = @kde_templatesdir@ +kde_wallpaperdir = @kde_wallpaperdir@ +kde_widgetdir = @kde_widgetdir@ +kdeinitdir = @kdeinitdir@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +qt_includes = @qt_includes@ +qt_libraries = @qt_libraries@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ +sysconfdir = @sysconfdir@ +target = @target@ +target_alias = @target_alias@ +target_cpu = @target_cpu@ +target_os = @target_os@ +target_vendor = @target_vendor@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ +x_includes = @x_includes@ +x_libraries = @x_libraries@ +xdg_appsdir = @xdg_appsdir@ +xdg_directorydir = @xdg_directorydir@ +xdg_menudir = @xdg_menudir@ +KDE_LANG = en +KDE_DOCS = AUTO +#>- all: all-am +#>+ 1 +all: docs-am all-am + +.SUFFIXES: +$(srcdir)/Makefile.in: $(srcdir)/Makefile.am $(am__configure_deps) +#>- @for dep in $?; do \ +#>- case '$(am__configure_deps)' in \ +#>- *$$dep*) \ +#>- cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ +#>- && exit 0; \ +#>- exit 1;; \ +#>- esac; \ +#>- done; \ +#>- echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu doc/en/kbiff/Makefile'; \ +#>- cd $(top_srcdir) && \ +#>- $(AUTOMAKE) --gnu doc/en/kbiff/Makefile +#>+ 12 + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ + && exit 0; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu doc/en/kbiff/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu doc/en/kbiff/Makefile + cd $(top_srcdir) && perl admin/am_edit -padmin doc/en/kbiff/Makefile.in +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +mostlyclean-libtool: + -rm -f *.lo + +clean-libtool: + -rm -rf .libs _libs +tags: TAGS +TAGS: + +ctags: CTAGS +CTAGS: + + +#>- distdir: $(DISTFILES) +#>+ 1 +distdir: distdir-nls $(DISTFILES) + @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + list='$(DISTFILES)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ + fi; \ + cp -pR $$d/$$file $(distdir)$$dir || exit 1; \ + else \ + test -f $(distdir)/$$file \ + || cp -p $$d/$$file $(distdir)/$$file \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-am +all-am: Makefile +installdirs: +install: install-am +install-exec: install-exec-am +install-data: install-data-am +#>- uninstall: uninstall-am +#>+ 1 +uninstall: uninstall-docs uninstall-nls uninstall-am + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-am +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +#>- clean: clean-am +#>+ 1 +clean: kde-rpo-clean clean-am + +#>- clean-am: clean-generic clean-libtool mostlyclean-am +#>+ 1 +clean-am: clean-docs clean-bcheck clean-generic clean-libtool mostlyclean-am + +distclean: distclean-am + -rm -f Makefile +distclean-am: clean-am distclean-generic + +dvi: dvi-am + +dvi-am: + +html: html-am + +info: info-am + +info-am: + +#>- install-data-am: +#>+ 1 +install-data-am: install-docs install-nls + +install-dvi: install-dvi-am + +install-exec-am: + +install-html: install-html-am + +install-info: install-info-am + +install-man: + +install-pdf: install-pdf-am + +install-ps: install-ps-am + +installcheck-am: + +maintainer-clean: maintainer-clean-am + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-am + +mostlyclean-am: mostlyclean-generic mostlyclean-libtool + +pdf: pdf-am + +pdf-am: + +ps: ps-am + +ps-am: + +uninstall-am: + +.MAKE: install-am install-strip + +.PHONY: all all-am check check-am clean clean-generic clean-libtool \ + distclean distclean-generic distclean-libtool distdir dvi \ + dvi-am html html-am info info-am install install-am \ + install-data install-data-am install-dvi install-dvi-am \ + install-exec install-exec-am install-html install-html-am \ + install-info install-info-am install-man install-pdf \ + install-pdf-am install-ps install-ps-am install-strip \ + installcheck installcheck-am installdirs maintainer-clean \ + maintainer-clean-generic mostlyclean mostlyclean-generic \ + mostlyclean-libtool pdf pdf-am ps ps-am uninstall uninstall-am + +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: + + +#>+ 2 +KDE_DIST=Makefile.in index.docbook kbiff.png Makefile.am + +#>+ 24 +index.cache.bz2: $(srcdir)/index.docbook $(KDE_XSL_STYLESHEET) index.docbook kbiff.png + @if test -n "$(MEINPROC)"; then echo $(MEINPROC) --check --cache index.cache.bz2 $(srcdir)/index.docbook; $(MEINPROC) --check --cache index.cache.bz2 $(srcdir)/index.docbook; fi + +docs-am: index.cache.bz2 + +install-docs: docs-am install-nls + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kbiff + @if test -f index.cache.bz2; then \ + echo $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kbiff/; \ + $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kbiff/; \ + elif test -f $(srcdir)/index.cache.bz2; then \ + echo $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kbiff/; \ + $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kbiff/; \ + fi + -rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kbiff/common + $(LN_S) $(kde_libs_htmldir)/$(KDE_LANG)/common $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kbiff/common + +uninstall-docs: + -rm -rf $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kbiff + +clean-docs: + -rm -f index.cache.bz2 + + +#>+ 13 +install-nls: + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kbiff + @for base in index.docbook kbiff.png ; do \ + echo $(INSTALL_DATA) $$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kbiff/$$base ;\ + $(INSTALL_DATA) $(srcdir)/$$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kbiff/$$base ;\ + done + +uninstall-nls: + for base in index.docbook kbiff.png ; do \ + rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kbiff/$$base ;\ + done + + +#>+ 5 +distdir-nls: + for file in index.docbook kbiff.png ; do \ + cp $(srcdir)/$$file $(distdir); \ + done + +#>+ 15 +force-reedit: + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ + && exit 0; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu doc/en/kbiff/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu doc/en/kbiff/Makefile + cd $(top_srcdir) && perl admin/am_edit -padmin doc/en/kbiff/Makefile.in + + +#>+ 21 +clean-bcheck: + rm -f *.bchecktest.cc *.bchecktest.cc.class a.out + +bcheck: bcheck-am + +bcheck-am: + @for i in ; do \ + if test $(srcdir)/$$i -nt $$i.bchecktest.cc; then \ + echo "int main() {return 0;}" > $$i.bchecktest.cc ; \ + echo "#include \"$$i\"" >> $$i.bchecktest.cc ; \ + echo "$$i"; \ + if ! $(CXX) $(DEFS) -I. -I$(srcdir) -I$(top_builddir) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(KDE_CXXFLAGS) --dump-class-hierarchy -c $$i.bchecktest.cc; then \ + rm -f $$i.bchecktest.cc; exit 1; \ + fi ; \ + echo "" >> $$i.bchecktest.cc.class; \ + perl $(top_srcdir)/admin/bcheck.pl $$i.bchecktest.cc.class || { rm -f $$i.bchecktest.cc; exit 1; }; \ + rm -f a.out; \ + fi ; \ + done + + +#>+ 3 +final: + $(MAKE) all-am + +#>+ 3 +final-install: + $(MAKE) install-am + +#>+ 3 +no-final: + $(MAKE) all-am + +#>+ 3 +no-final-install: + $(MAKE) install-am + +#>+ 3 +kde-rpo-clean: + -rm -f *.rpo + +#>+ 3 +nmcheck: +nmcheck-am: nmcheck diff --git a/doc/en/kbiff/index.docbook b/doc/en/kbiff/index.docbook new file mode 100644 index 0000000..c8cf8d3 --- /dev/null +++ b/doc/en/kbiff/index.docbook @@ -0,0 +1,658 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd" [ + <!ENTITY kbiff "<application>kbiff</application>"> +]> + +<book id="kbiff" lang="en"> +<bookinfo> +<title>The KBiff Handbook</title> +<authorgroup> +<author> +<firstname>Kurt</firstname> +<surname>Granroth</surname> +<affiliation> +<address><email>granroth@kde.org</email></address> +</affiliation> +</author> +</authorgroup> +<date></date> +<releaseinfo></releaseinfo> +<abstract> +<para>KBiff is a KDE aware mail notification utility. It supports MBOX (Unix + style), Maildir (Qmail), MH, POP3(S), IMAP4(S), and NNTP mailboxes.</para> +</abstract> +<keywordset> +<keyword>KDE</keyword> +<keyword>KBiff</keyword> +<keyword>mailboxes</keyword> +<keyword>incoming mail</keyword> +</keywordset> +</bookinfo> + +<chapter id="introduction"> +<title>Introduction</title> + +<sect1 id="features"> +<title>Features</title> + +<para>KBiff is a mail notification utility for the KDE project. It has several +advantages over much of its competition: +<itemizedlist> +<listitem> +<para><emphasis>Pure GUI configuration</emphasis>. No more command line parameters to remember (well, +one optional one to make things easier for some people) or strange config files. +All settings for KBiff can be done from one setup dialog.</para> +</listitem> +<listitem> +<para><emphasis>Session Management</emphasis>. KBiff starts up with the same configuration you left +it with.</para> +</listitem> +<listitem> +<para><emphasis>Panel Docking</emphasis>. KBiff can be docked into the panel very easily. Handy when +you are monitoring several mailboxes and don't have room anywhere else.</para> +</listitem> +<listitem> +<para><emphasis>Animated GIFs</emphasis>. You can use animated GIFs as your icons.</para> +</listitem> +<listitem> +<para><emphasis>Sounds</emphasis>. KBiff has an option to play .wav files when new mail arrives.</para> +</listitem> +<listitem> +<para><emphasis>POP3(+SSL), IMAP4(+SSL), NNTP, Maildir, MBOX, MH</emphasis>. KBiff supports all major mailbox formats!</para> +</listitem> +<listitem> +<para><emphasis>Multiple Mailbox</emphasis>. KBiff can monitor several mailboxes with one instance.</para> +</listitem> +<listitem> +<para><emphasis>Secure Authentication</emphasis>. KBiff can authenticate using APOP or CRAM-MD5 if the POP3 or IMAP4 server supports it. +</para> +</listitem> +<listitem> +<para><emphasis>Others</emphasis>. KBiff has scads of other options.</para> +</listitem> +</itemizedlist> +</para> + +<para>Kurt Granroth</para> + +<para><ulink url="mailto:granroth@kde.org"><granroth@kde.org></ulink></para> +</sect1> +</chapter> + +<chapter id="installation"> +<title>Installation</title> + +<sect1 id="howtoobtainkbiff"> +<title>How to obtain KBiff</title> + +<para>The most current release version in both source and binary formats can +always be found at the KBiff homepage. This is at +<ulink url="http://kbiff.granroth.org">http://kbiff.granroth.org</ulink></para> +</sect1> + +<sect1 id="requirements"> +<title>Requirements</title> + +<para>In order to successfully compile KBiff, you need at least the 2.0 version +of KDE. All required libraries can be found starting at the +<ulink url="http://www.kde.org">KDE</ulink> website.</para> + +<para>A note on the minimum KDE version: while KBiff should compile +with KDE2, this hasn't been verified or tested in years. The +effective minimum version is KDE3.</para> +</sect1> + +<sect1 id="compilationandinstallation"> +<title>Compilation and Installation</title> + +<para>Compiling KBiff is very easy. The following should do it: +<programlisting>% ./configure +% make +% make install</programlisting> +</para> + +<para>That should do it! Should you run into any problems, please report them +to the <ulink url="mailto:granroth@kde.org">author</ulink></para> +</sect1> +</chapter> + +<chapter id="usingkbiff"> +<title>Using KBiff</title> + +<para>Almost every feature of KBiff can be configured from the Setup dialog. +What few command line parameters KBiff has are mostly for convenience -- some +options just make more sense on the command line.</para> + +<sect1 id="theprofile"> +<title>The "profile"</title> + +<para>KBiff revolves around something called a "profile" A profile is simply +a container for one or mailboxes that KBiff will monitor. For instance, there +will always be one default profile called "Inbox" (or something else if you +rename it). This profile will contain one mailbox, usually something like "/var/mail/username". +It could just as well hold several mailboxes, though. Each instance of KBiff +(that is, each visible icon) corresponds to one profile.</para> +</sect1> + +<sect1 id="commandlineparameters"> +<title>Command Line Parameters</title> + +<para>KBiff supports three command line parameters. They are: <emphasis>profile</emphasis>, <emphasis>debug</emphasis>, +and <emphasis>secure</emphasis>. +<programlisting>-profile <profile_name> Bypass the Setup dialog and start KBiff directly in the + given profile. e.g., 'kbiff -profile Inbox' +-debug Turns on verbose debugging. Use this only if you are + having problems with KBiff +-secure Disables the setup dialog. Useful when you want KBiff + displayed but don't want others to modify it.</programlisting> +</para> +</sect1> +</chapter> + +<chapter id="thesetupdialog"> +<title>The Setup Dialog</title> + +<para>The setup dialog handles all configuration items for KBiff. As a result, +there is no need for command line parameters in nearly all cases.</para> + +<sect1 id="profilename"> +<title>Profile Name</title> + +<para>The top part of the dialog consists of a drop down list and three buttons. +The drop down list contains the names of all the "profiles." A profile is a +set of configuration settings for one mailbox under one name. The three +buttons are New, Rename, and Delete. The buttons work on the profiles, +only. They do not touch the actual mailbox files. When KBiff is started for +the first time, there will be one profile automatically created. This is +the Inbox profile which monitors the system mailbox.</para> +</sect1> + +<sect1 id="preferencetabs"> +<title>Preference Tabs</title> + +<para>There are four preference tabs. These are full of options that apply to the +current profile. The current profile is the one that is currently displayed +in the drop down list. There are no global settings.</para> + +<sect2 id="generalpreferences"> +<title>General Preferences</title> + +<para>The general preferences for each profile are contained in this tab. There +are five fields here:</para> + +<sect3 id="poll"> +<title>Poll</title> + +<para>This setting controls how much time KBiff will wait until it checks the +mailbox again. The time is in seconds. The default is 60 seconds (one +minute).</para> + +<para>To choose a time other than the default, here, it is a good idea to analyze +the frequency in which your mail arrives. If, for instance, you have +<literal>fetchmail</literal> downloading new mail every 5 minutes, then it doesn't make sense +to set the time for less than that. On the other hand, if you are using the +POP3 or IMAP4 feature of KBiff, you should probably use a higher interval. Setting +it less than 60 might give you unexpected results if your network +connection isn't very fast.</para> +</sect3> + +<sect3 id="mailclient"> +<title>Mail client</title> + +<para>This field specifies what command will run when KBiff is left-clicked. +While this is typically a mail client, it does not have to be. It can be +any command that can be run with its own X window. In other words, putting +<literal>elm</literal> in this field will not work. Putting <literal>konsole -e elm</literal> would. +The default is <literal>kmail -check</literal></para> +</sect3> + +<sect3 id="dockinpanel"> +<title>Dock in panel</title> + +<para>This controls whether or not KBiff will start docked into the panel or not +when the user exits the setup dialog. Note that it is still possible to +switch between docked and undocked regardless of this option. This only +controls the initial state. This is checked by default.</para> +</sect3> + +<sect3 id="enablesessionmanagement"> +<title>Enable session management</title> + +<para>This controls whether or not KDE session management is enabled. This should +be turned off only in rare cases. The most common case where session +management is disabled is when a user is running KDE under the same account +on several different computers at the same time. In this case, it would +probably be desirable to turn off session management and use the <literal>-profile</literal> +command line option instead.</para> + +<para>In all other cases, session management should probably be left on.</para> +</sect3> + +<sect3 id="icons"> +<title>Icons</title> + +<para>KBiff uses three icons to represent the three states: No Mail, Old Mail, +and New Mail. The icons shown are the "large" icons. To select new ones, +click on the buttons and a icon loader dialog will pop up. Note that even +though KBiff supports animated GIFs, they will not appear animated here.</para> +</sect3> +</sect2> + +<sect2 id="newmailpreferences"> +<title>New Mail Preferences</title> + +<para>This tab groups together the options that control what happen when new mail +arrives.</para> + +<sect3 id="runcommand"> +<title>Run Command</title> + +<para>This is a shell command that will be executed when new mail arrives. A +typical example of this would be play newmail.au. This would cause the file +newmail.au to be played whenever new mail arrives. By default, this is +turned off.</para> +</sect3> + +<sect3 id="playsound"> +<title>Play Sound</title> + +<para>This specifies a sound to play when new mail arrives. As of this version, +it will only play .wav files. Simply specify the path to the file to have +it played. By default, this is turned off.</para> +</sect3> + +<sect3 id="systembeep"> +<title>System Beep</title> + +<para>Enabling this will cause KBiff to beep whenever new mail arrives. This is +probably the least intrusive, yet still active, method of alerting the user +that new mail as arrived. By default, this is on.</para> +</sect3> + +<sect3 id="notify"> +<title>Notify</title> + +<para>Enabling this will cause KBiff to popup a window when new mail arrives. The +"notify" message box will list both the mailbox in question and the number of +new mails. This option is not recommended on mailboxes that receive lots of +mail.</para> +</sect3> + +<sect3 id="floatingstatus"> +<title>Floating Status</title> + +<para>If this is enabled, KBiff will popup a small box listing all mailboxes +with their newmail count whenever you the mouse is over the icon (after +a one second delay). The effect is similar to that of a tooltip... only +better. This isn't technically a new mail feature... but it doesn't fit +easily anywhere else!</para> +</sect3> +</sect2> + +<sect2 id="mailboxpreferences"> +<title>Mailbox Preferences</title> + +<para>This groups together the options controlling the physical mailboxs themself.</para> + +<para>All options on this tab are PER mailbox. So if you have three mailboxes in +this profile, each mailbox will have its own settings on this tab. However, +all settings in the other tabs apply profile-wide. This means that if you +have the Notify option checking the the New Mail tab, then KBiff will notify +you that new mail has arrived in all of the mailboxes in this profile.</para> + +<sect3 id="mailboxlist"> +<title>Mailbox list</title> + +<para>The listbox on the left of the tab contains the list of mailboxes that the +current profile will monitor. In most cases, there will be only one (the +"Default" mailbox). However, you may have as many mailboxes per profile as +you wish.</para> + +<para>There are two buttons below the mailbox list. The button with the mailbox on +it will create a new mailbox. The button with the cross will delete a +mailbox. If you wish to rename a mailbox, you must delete the old one and +create a new one with identical properties.</para> +</sect3> + +<sect3 id="protocol"> +<title>Protocol</title> + +<para>This determines the protocol for the currently selected mailbox. There are 4 +(and a half) protocols - mbox (Unix style), maildir (Qmail), POP3, and IMAP4. +The 'file' protocol can be used to monitor any local file as it uses only +the last read and last modified times to determine the state.</para> +</sect3> + +<sect3 id="mailbox"> +<title>Mailbox</title> + +<para>This field will not be active with the POP3 protocol. In all other cases, put +the path to your mailbox here. In the case of mbox, this will be a file. With +maildir, this will be a directory. It is a folder with IMAP4 (almost +always called 'INBOX' or 'inbox' for your main mail folder).</para> +</sect3> + +<sect3 id="server"> +<title>Server</title> + +<para>This is active only for the IMAP4 and POP3 protocols.</para> +</sect3> + +<sect3 id="user"> +<title>User</title> + +<para>This is active only for the IMAP4 and POP3 protocols.</para> + +</sect3> + +<sect3 id="password"> +<title>Password</title> + +<para>This is active only for the IMAP4 and POP3 protocols.</para> + +</sect3> + +<sect3 id="storepassword"> +<title>Store Password</title> + +<para>This will save the password between sessions.</para> + +<para>KBiff does not encrypt the password when it is saved! It will scramble it a +little, but anybody with the source code (or a little patience) could +unscramble it in an instant. If you are on an insecure network, it is +strongly recommended that the store password option be turned off</para> +</sect3> + +<sect3 id="advanced"> +<title>Advanced</title> + +<para>This will popup a dialog containing advanced features.</para> + +<sect4 id="mailboxurl"> +<title>Mailbox URL</title> + +<para>KBiff handles mailboxes internally as a URL. If you know what you are doing, +you can directly modify the URL here. Modifying this is discouraged unless +you are familiar with the code,</para> +</sect4> + +<sect4 id="port"> +<title>Port</title> + +<para>Set this to whatever port your server is at. By default, it will be 110 for +POP3 and 143 for IMAP4</para> +</sect4> + +<sect4 id="preauth"> +<title>PREAUTH</title> + +<para>If you don't know what this means, you probably don't need to use it. +Basically, it will start checking for new mail in IMAP4 without logging in.</para> +</sect4> + +<sect4 id="keepalive"> +<title>Keep Alive</title> + +<para>When checked in POP3 or IMAP4 mode, this will keep the connection "alive". +That is, KBiff will login once and stay logged in. This is not recommended if +your POP3 or IMAP4 server uses locks. If locks are in place and KBiff does +not log out then your mail client will not be able to access your account.</para> +</sect4> +</sect3> +</sect2> + +<sect2 id="about"> +<title>About</title> + +<para>This tab has information about KBiff.</para> + +<sect3 id="aboutkbiff"> +<title>About KBiff</title> + +<para>This contains information about which version of KBiff is being used. It +also has contact information about the author.</para> + +<para>Note that the email address is a hyperlink. Clicking on it is supposed to +pop up your mail client in order to send mail to the author. Unfortunately, +there is no automated way of doing this in KBiff at the present time. There +is some code here, though. To send email using this hyperlink, KBiff looks +for the environment variable <literal>MAILER</literal>. If it finds it, it will use the +contents of this variable as the email program to use.</para> + +<para>For example, if <literal>MAILER</literal> is set like so: +<literal> % setenv MAILER "konsole -e mutt"</literal> +then KBiff will use <literal>konsole -e mutt</literal> as the default mail client, here.</para> +</sect3> +</sect2> +</sect1> +</chapter> + +<chapter id="thepopupmenu"> +<title>The Popup Menu</title> + +<para>The popup menu is activated whenever the right mouse button is clicked +in the KBiff icon area.</para> + +<sect1 id="undock"> +<title>(Un)Dock</title> + +<para>This docks or undocks KBiff from the panel. This option will only work +in KDE complient window managers like KWin. The default state is determined +by the setup dialog.</para> +</sect1> + +<sect1 id="setup"> +<title>Setup</title> + +<para>This will activate the setup dialog. See the Setup Dialog section for more details.</para> +</sect1> + +<sect1 id="help"> +<title>Help</title> + +<para>This activates the online help (this).</para> +</sect1> + +<sect1 id="checkmailnow"> +<title>Check Mail Now</title> + +<para>This forces KBiff to check for new mail right now, regardless of the poll +time. This will check all mailboxes in a profile.</para> +</sect1> + +<sect1 id="readmailnow"> +<title>Read Mail Now</title> + +<para>This will force KBiff to act like all mailboxes in the current profile +are "old." This makes most sense when you have new mail on a remote server +(pop3 or imap4) and don't feel like downloading it right then.</para> +</sect1> + +<sect1 id="stopstart"> +<title>Stop/Start</title> + +<para>This will either stop or start KBiff.</para> +</sect1> +</chapter> + +<chapter id="questionsanswersandtips"> +<title>Questions, Answers, and Tips</title> + +<sect1 id="arethereotherkde-awarebiffutilities"> +<title>Are there other KDE-aware "biff" utilities?</title> + +<para>Yes. There are at least three that I know of. Each "biff" has its own strengths. +<emphasis>KOrn</emphasis> was the original. It's main strength is the ability to monitor multiple +mailboxes with one instance and effectively show the number of messages in +each. If you have many mailboxes and don't care for the cutesy icons, then +KOrn is probably a better choice than KBiff. Another "biff" is <emphasis>KNewMail</emphasis>. +KNewMail attempts to emulate the Windows utility NewMail. It checks for POP3 +mail and displays the subject line for each message. I don't know if +this is still an viable project, though, since it doesn't look like +it's been updated since 2003. + +The final (and most common) mail monitor is the one that ships with +KMail. Its major advantages are all related to the fact that it's +integrated with KMail itself. KBiff is more flexible, though, and +works with mailers other than KMail.</para> +</sect1> + +<sect1 id="whatisthedifferencebetweenaprofileandamailbo"> +<title>What is the difference between a "profile" and a "mailbox" again?</title> + +<para>A "profile" is a group of one or more mailboxes that one instance of +KBiff will monitor. And example of a profile is "Inbox". A "mailbox" is +a physical entity that can be monitored by KBiff. An example of a mailbox is +"/var/mail/username".</para> +</sect1> + +<sect1 id="howdoiusemyownpixmaps"> +<title>How do I use my own pixmaps?</title> + +<para>Short answer: select them using the setup dialog. +Longer answer: KBiff +searches for its icons in the standard KDE icon path. Currently, this is +<programlisting>kdedir()/share/apps/kbiff/toolbar +kdedir()/share/toolbar +kdedir()/share/icons +kdedir()/share/apps/kbiff/pics +$HOME/.kde/share/apps/kbiff/toolbar +$HOME/.kde/share/toolbar +$HOME/.kde/share/icons +$HOME/.kde/share/apps/kbiff/pics</programlisting> +</para> + +<para>Where "kdedir()" is usally "/opt/kde" and $HOME is your home +directory. If you put your pixmaps in any of these directories (the last one +listed is recommended), then KBiff should have no problems finding and using +them.</para> + +<para>If you plan on docking KBiff, you should have a 22x22 (or smaller) version +of your pixmap. The name of the small pixmap should be the name of the larger +pixmap preceded by "mini-". So if you want to use the default "oldmail.xpm" +pixmap for old mail but want to use your own "mycoolpixmap.xpm" smaller pixmap +when it's docked, you should rename your pixmap to "mini-oldmail.xpm" If +you do not do this, KBiff will use the large version even in the panel.</para> + +<para>Note that KBiff determines its size by the old mail pixmap. So if your +pixmap for old mail is 100x100, but all the other ones are 32x32... well, KBiff +will look very strange every time new mail arrives.</para> +</sect1> + +<sect1 id="howdoiuseelmormuttorpinewithkbiff"> +<title>How do I use elm (or mutt or PINE) with KBiff?</title> + +<para>You tried putting "elm" into the Mail Client edit box, didn't you? Whoops! +'elm', 'mutt', and 'PINE' all need a terminal to run in and KBiff does not +supply one. The author used to use the following as his Mail Client: +<literal>konsole -caption Mail -e mutt &</literal></para> + +<para>If you use a graphical email client such as KMail or Thunderbird, then you +simply need to put the name of the client in the edit box. No terminal is necessary.</para> +</sect1> + +<sect1 id="whywontkbiffplaymynewmailaufile"> +<title>Why won't KBiff play my newmail.au file?</title> + +<para>KBiff uses the KAudio class to play sounds when new mail arrives. Currently, +this class only supports .wav files. If you wish to play an .au file when new +mail arrives, try getting the SOX package and put 'play newmail.au' (or just +'cat newmail.au > /dev/audio') in the Run Command option.</para> +</sect1> + +<sect1 id="doeskbiffworkwithoutsessionmanagement"> +<title>Does KBiff work without session management?</title> + +<para>Yes. Session management is on by default, but you can turn it off in the +setup dialog. You can still have KBiff start up when KDE starts up by putting +KBiff into your Autostart folder with the '-profile' option.</para> +</sect1> + +<sect1 id="clickingonyouremailaddressinaboutdoesnothing"> +<title>Clicking on your email address in About does nothing!</title> + +<para>It would be nice to pass the 'mailto:granroth@kde.org' URL to kfm to process +it.. unfortunately, this is not implemented yet. I did code in some support, +though. Just set an environment variable MAILER to whatever your mailer is +and the link should work. +<programlisting>e.g. +% setenv MAILER konsole -e mutt</programlisting> +</para> + +<para>Note that this has the pleasant side effect that 'mailto:' links in the +regular kfm will also use your mailer.</para> +</sect1> + +<sect1 id="wheniusekbifftomonitormymailboxallotherbiffu"> +<title>When I use KBiff to monitor my mailbox, all other 'biff' utilities stop + working. What's up?</title> + +<para>This is a result of the new message counting code in KBiff. In order for +KBiff to know how many new messages are in an mbox mailbox, it must open it +up to read it. When this happens, most other 'biff' utilities (including your +shell's built-in one) will assume that you read your mailbox and announce it +as old (or "read") mail.</para> + +<para>There are three ways around this: +<orderedlist><listitem> +<para>Don't use KBiff.</para> +</listitem> +<listitem> +<para>Use the 'file' protocol instead of the 'mbox' protocol (note that you'll +no longer know how many new mails have arrived)</para> +</listitem> +<listitem> +<para>Convert all of your 'mbox' mailboxes to 'maildir'</para> +</listitem> +</orderedlist> +</para> +</sect1> + +<sect1 id="howdoiusenetscapemailwithkbiff"> +<title>How do I use Netscape Mail with KBiff?</title> + +<para>You tried 'netscape -mail', didn't you? You then discovered that this caused +Netscape to complain about a lockfile if it was already running, right? Well, +here's a workaround from KBiff user Steven Boger +<ulink url="mailto:sboger@marcus-online.net">(sboger@marcus-online.net)</ulink> +Create a shell script like so: +<literal>#!/bin/sh</literal> +<programlisting>if [ -L "$HOME/.netscape/lock" ]; +then +netscape -remote 'xfeDoCommand(openInbox)' +else +netscape -mail & +fi</programlisting> +</para> +</sect1> + +<sect1 id="kbifftruncatestheinitialslashinimapmodeisthi"> +<title>KBiff truncates the initial slash in IMAP mode. Is this a bug?</title> + +<para>No, it's a feature! It is very very rare that one uses an absolute path +with IMAP. Nearly all mailbox can (and are) accessed either relative to +the user's home directory or use symbolic names like 'inbox.</para> + +<para>If you are trying to read <literal>/var/spool/mail/username</literal> try entering +<literal>inbox</literal> as the mailbox name.</para> +</sect1> + +<sect1 id="ihavethisgreatfeatureiwantimplementedwhatsho"> +<title>I have this great feature I want implemented. What should I do?</title> + +<para>Unfortunately, the answer is likely "write it yourself". KBiff +is maintained in only a minimal sense. Patches are applied and it's +updated enough to compile with the latest KDE, but I will be adding +very few features in the future and likely none that are just +suggestions. Nearly all patches are accepted, though. +</para> +</sect1> +</chapter> +</book> +<!-- +Local Variables: +mode: sgml +sgml-omittag: nil +sgml-shorttag: t +End: +--> diff --git a/doc/en/kbiff/kbiff.png b/doc/en/kbiff/kbiff.png Binary files differnew file mode 100644 index 0000000..dc47f09 --- /dev/null +++ b/doc/en/kbiff/kbiff.png |
