diff options
Diffstat (limited to 'tde-i18n-nl/docs/kdebase/kate')
| -rw-r--r-- | tde-i18n-nl/docs/kdebase/kate/Makefile.am | 4 | ||||
| -rw-r--r-- | tde-i18n-nl/docs/kdebase/kate/Makefile.in | 635 | ||||
| -rw-r--r-- | tde-i18n-nl/docs/kdebase/kate/advanced.docbook | 215 | ||||
| -rw-r--r-- | tde-i18n-nl/docs/kdebase/kate/configuring.docbook | 674 | ||||
| -rw-r--r-- | tde-i18n-nl/docs/kdebase/kate/fundamentals.docbook | 470 | ||||
| -rw-r--r-- | tde-i18n-nl/docs/kdebase/kate/highlighting.docbook | 479 | ||||
| -rw-r--r-- | tde-i18n-nl/docs/kdebase/kate/index.cache.bz2 | bin | 35640 -> 0 bytes | |||
| -rw-r--r-- | tde-i18n-nl/docs/kdebase/kate/index.docbook | 450 | ||||
| -rw-r--r-- | tde-i18n-nl/docs/kdebase/kate/kate.png | bin | 24241 -> 0 bytes | |||
| -rw-r--r-- | tde-i18n-nl/docs/kdebase/kate/man-kate.1.docbook | 294 | ||||
| -rw-r--r-- | tde-i18n-nl/docs/kdebase/kate/mdi.docbook | 212 | ||||
| -rw-r--r-- | tde-i18n-nl/docs/kdebase/kate/menus.docbook | 1092 | ||||
| -rw-r--r-- | tde-i18n-nl/docs/kdebase/kate/part.docbook | 488 | ||||
| -rw-r--r-- | tde-i18n-nl/docs/kdebase/kate/plugins.docbook | 18 | ||||
| -rw-r--r-- | tde-i18n-nl/docs/kdebase/kate/regular-expressions.docbook | 658 |
15 files changed, 0 insertions, 5689 deletions
diff --git a/tde-i18n-nl/docs/kdebase/kate/Makefile.am b/tde-i18n-nl/docs/kdebase/kate/Makefile.am deleted file mode 100644 index 9a89a7f3ebc..00000000000 --- a/tde-i18n-nl/docs/kdebase/kate/Makefile.am +++ /dev/null @@ -1,4 +0,0 @@ -KDE_LANG = nl -SUBDIRS = $(AUTODIRS) -KDE_DOCS = kate -KDE_MANS = AUTO diff --git a/tde-i18n-nl/docs/kdebase/kate/Makefile.in b/tde-i18n-nl/docs/kdebase/kate/Makefile.in deleted file mode 100644 index 73852377c7a..00000000000 --- a/tde-i18n-nl/docs/kdebase/kate/Makefile.in +++ /dev/null @@ -1,635 +0,0 @@ -# Makefile.in generated by automake 1.10.1 from Makefile.am. -# KDE tags expanded automatically by am_edit - $Revision: 483858 $ -# @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 = : -subdir = docs/tdebase/kate -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)/mkinstalldirs -CONFIG_HEADER = $(top_builddir)/config.h -CONFIG_CLEAN_FILES = -SOURCES = -DIST_SOURCES = -#>- RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \ -#>- html-recursive info-recursive install-data-recursive \ -#>- install-dvi-recursive install-exec-recursive \ -#>- install-html-recursive install-info-recursive \ -#>- install-pdf-recursive install-ps-recursive install-recursive \ -#>- installcheck-recursive installdirs-recursive pdf-recursive \ -#>- ps-recursive uninstall-recursive -#>+ 7 -RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \ - html-recursive info-recursive install-data-recursive \ - install-dvi-recursive install-exec-recursive \ - install-html-recursive install-info-recursive \ - install-pdf-recursive install-ps-recursive install-recursive \ - installcheck-recursive installdirs-recursive pdf-recursive \ - ps-recursive uninstall-recursive nmcheck-recursive bcheck-recursive -RECURSIVE_CLEAN_TARGETS = mostlyclean-recursive clean-recursive \ - distclean-recursive maintainer-clean-recursive -ETAGS = etags -CTAGS = ctags -DIST_SUBDIRS = $(SUBDIRS) -#>- DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) -#>+ 1 -DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) $(KDE_DIST) -ACLOCAL = @ACLOCAL@ -AMTAR = @AMTAR@ -ARTSCCONFIG = @ARTSCCONFIG@ -AUTOCONF = @AUTOCONF@ -AUTODIRS = @AUTODIRS@ -AUTOHEADER = @AUTOHEADER@ -AUTOMAKE = @AUTOMAKE@ -AWK = @AWK@ -CONF_FILES = @CONF_FILES@ -CYGPATH_W = @CYGPATH_W@ -DCOPIDL = @DCOPIDL@ -DCOPIDL2CPP = @DCOPIDL2CPP@ -DCOPIDLNG = @DCOPIDLNG@ -DCOP_DEPENDENCIES = @DCOP_DEPENDENCIES@ -DEFS = @DEFS@ -ECHO_C = @ECHO_C@ -ECHO_N = @ECHO_N@ -ECHO_T = @ECHO_T@ -GMSGFMT = @GMSGFMT@ -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_EXTRA_RPATH = @KDE_EXTRA_RPATH@ -KDE_RPATH = @KDE_RPATH@ -KDE_XSL_STYLESHEET = @KDE_XSL_STYLESHEET@ -LIBOBJS = @LIBOBJS@ -LIBS = @LIBS@ -LN_S = @LN_S@ -LTLIBOBJS = @LTLIBOBJS@ -MAKEINFO = @MAKEINFO@ -MAKEKDEWIDGETS = @MAKEKDEWIDGETS@ -MCOPIDL = @MCOPIDL@ -MEINPROC = @MEINPROC@ -MKDIR_P = @MKDIR_P@ -MSGFMT = @MSGFMT@ -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@ -SET_MAKE = @SET_MAKE@ -SHELL = @SHELL@ -STRIP = @STRIP@ -TOPSUBDIRS = @TOPSUBDIRS@ -VERSION = @VERSION@ -XGETTEXT = @XGETTEXT@ -XMLLINT = @XMLLINT@ -X_RPATH = @X_RPATH@ -abs_builddir = @abs_builddir@ -abs_srcdir = @abs_srcdir@ -abs_top_builddir = @abs_top_builddir@ -abs_top_srcdir = @abs_top_srcdir@ -am__leading_dot = @am__leading_dot@ -am__tar = @am__tar@ -am__untar = @am__untar@ -#>- bindir = @bindir@ -#>+ 2 -DEPDIR = .deps -bindir = @bindir@ -build_alias = @build_alias@ -builddir = @builddir@ -datadir = @datadir@ -datarootdir = @datarootdir@ -docdir = @docdir@ -dvidir = @dvidir@ -exec_prefix = @exec_prefix@ -host_alias = @host_alias@ -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_kcfgdir = @kde_kcfgdir@ -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_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@ -tdeinitdir = @tdeinitdir@ -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@ -sbindir = @sbindir@ -sharedstatedir = @sharedstatedir@ -srcdir = @srcdir@ -sysconfdir = @sysconfdir@ -target_alias = @target_alias@ -top_builddir = @top_builddir@ -top_srcdir = @top_srcdir@ -xdg_appsdir = @xdg_appsdir@ -xdg_directorydir = @xdg_directorydir@ -xdg_menudir = @xdg_menudir@ -KDE_LANG = nl -#>- SUBDIRS = $(AUTODIRS) -#>+ 1 -SUBDIRS =. -KDE_DOCS = kate -KDE_MANS = AUTO -#>- all: all-recursive -#>+ 1 -all: docs-am all-recursive - -.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 docs/tdebase/kate/Makefile'; \ -#>- cd $(top_srcdir) && \ -#>- $(AUTOMAKE) --gnu docs/tdebase/kate/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 docs/tdebase/kate/Makefile'; \ - cd $(top_srcdir) && \ - $(AUTOMAKE) --gnu docs/tdebase/kate/Makefile - cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/tdebase/kate/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 - -# This directory's subdirectories are mostly independent; you can cd -# into them and run `make' without going through this Makefile. -# To change the values of `make' variables: instead of editing Makefiles, -# (1) if the variable is set in `config.status', edit `config.status' -# (which will cause the Makefiles to be regenerated when you run `make'); -# (2) otherwise, pass the desired values on the `make' command line. -$(RECURSIVE_TARGETS): - @failcom='exit 1'; \ - for f in x $$MAKEFLAGS; do \ - case $$f in \ - *=* | --[!k]*);; \ - *k*) failcom='fail=yes';; \ - esac; \ - done; \ - dot_seen=no; \ - target=`echo $@ | sed s/-recursive//`; \ - list='$(SUBDIRS)'; for subdir in $$list; do \ - echo "Making $$target in $$subdir"; \ - if test "$$subdir" = "."; then \ - dot_seen=yes; \ - local_target="$$target-am"; \ - else \ - local_target="$$target"; \ - fi; \ - (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ - || eval $$failcom; \ - done; \ - if test "$$dot_seen" = "no"; then \ - $(MAKE) $(AM_MAKEFLAGS) "$$target-am" || exit 1; \ - fi; test -z "$$fail" - -$(RECURSIVE_CLEAN_TARGETS): - @failcom='exit 1'; \ - for f in x $$MAKEFLAGS; do \ - case $$f in \ - *=* | --[!k]*);; \ - *k*) failcom='fail=yes';; \ - esac; \ - done; \ - dot_seen=no; \ - case "$@" in \ - distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \ - *) list='$(SUBDIRS)' ;; \ - esac; \ - rev=''; for subdir in $$list; do \ - if test "$$subdir" = "."; then :; else \ - rev="$$subdir $$rev"; \ - fi; \ - done; \ - rev="$$rev ."; \ - target=`echo $@ | sed s/-recursive//`; \ - for subdir in $$rev; do \ - echo "Making $$target in $$subdir"; \ - if test "$$subdir" = "."; then \ - local_target="$$target-am"; \ - else \ - local_target="$$target"; \ - fi; \ - (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ - || eval $$failcom; \ - done && test -z "$$fail" -tags-recursive: - list='$(SUBDIRS)'; for subdir in $$list; do \ - test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \ - done -ctags-recursive: - list='$(SUBDIRS)'; for subdir in $$list; do \ - test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) ctags); \ - done - -ID: $(HEADERS) $(SOURCES) $(LISP) $(TAGS_FILES) - list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ - unique=`for i in $$list; do \ - if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ - done | \ - $(AWK) '{ files[$$0] = 1; nonemtpy = 1; } \ - END { if (nonempty) { for (i in files) print i; }; }'`; \ - mkid -fID $$unique -tags: TAGS - -TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ - $(TAGS_FILES) $(LISP) - tags=; \ - here=`pwd`; \ - if ($(ETAGS) --etags-include --version) >/dev/null 2>&1; then \ - include_option=--etags-include; \ - empty_fix=.; \ - else \ - include_option=--include; \ - empty_fix=; \ - fi; \ - list='$(SUBDIRS)'; for subdir in $$list; do \ - if test "$$subdir" = .; then :; else \ - test ! -f $$subdir/TAGS || \ - tags="$$tags $$include_option=$$here/$$subdir/TAGS"; \ - fi; \ - done; \ - list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ - unique=`for i in $$list; do \ - if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ - done | \ - $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ - END { if (nonempty) { for (i in files) print i; }; }'`; \ - if test -z "$(ETAGS_ARGS)$$tags$$unique"; then :; else \ - test -n "$$unique" || unique=$$empty_fix; \ - $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ - $$tags $$unique; \ - fi -ctags: CTAGS -CTAGS: ctags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ - $(TAGS_FILES) $(LISP) - tags=; \ - list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ - unique=`for i in $$list; do \ - if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ - done | \ - $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ - END { if (nonempty) { for (i in files) print i; }; }'`; \ - test -z "$(CTAGS_ARGS)$$tags$$unique" \ - || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \ - $$tags $$unique - -GTAGS: - here=`$(am__cd) $(top_builddir) && pwd` \ - && cd $(top_srcdir) \ - && gtags -i $(GTAGS_ARGS) $$here - -distclean-tags: - -rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags - -#>- 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 - list='$(DIST_SUBDIRS)'; for subdir in $$list; do \ - if test "$$subdir" = .; then :; else \ - test -d "$(distdir)/$$subdir" \ - || $(MKDIR_P) "$(distdir)/$$subdir" \ - || exit 1; \ - distdir=`$(am__cd) $(distdir) && pwd`; \ - top_distdir=`$(am__cd) $(top_distdir) && pwd`; \ - (cd $$subdir && \ - $(MAKE) $(AM_MAKEFLAGS) \ - top_distdir="$$top_distdir" \ - distdir="$$distdir/$$subdir" \ - am__remove_distdir=: \ - am__skip_length_check=: \ - distdir) \ - || exit 1; \ - fi; \ - done -check-am: all-am -check: check-recursive -all-am: Makefile -installdirs: installdirs-recursive -installdirs-am: -install: install-recursive -install-exec: install-exec-recursive -install-data: install-data-recursive -#>- uninstall: uninstall-recursive -#>+ 1 -uninstall: uninstall-docs uninstall-nls uninstall-recursive - -install-am: all-am - @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am - -installcheck: installcheck-recursive -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-recursive -#>+ 1 -clean: kde-rpo-clean clean-recursive - -#>- clean-am: clean-generic mostlyclean-am -#>+ 1 -clean-am: clean-docs clean-bcheck clean-generic mostlyclean-am - -distclean: distclean-recursive - -rm -f Makefile -distclean-am: clean-am distclean-generic distclean-tags - -dvi: dvi-recursive - -dvi-am: - -html: html-recursive - -info: info-recursive - -info-am: - -#>- install-data-am: -#>+ 1 -install-data-am: install-docs install-nls - -install-dvi: install-dvi-recursive - -install-exec-am: - -install-html: install-html-recursive - -install-info: install-info-recursive - -install-man: - -install-pdf: install-pdf-recursive - -install-ps: install-ps-recursive - -installcheck-am: - -maintainer-clean: maintainer-clean-recursive - -rm -f Makefile -maintainer-clean-am: distclean-am maintainer-clean-generic - -mostlyclean: mostlyclean-recursive - -mostlyclean-am: mostlyclean-generic - -pdf: pdf-recursive - -pdf-am: - -ps: ps-recursive - -ps-am: - -uninstall-am: - -.MAKE: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) install-am \ - install-strip - -.PHONY: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) CTAGS GTAGS \ - all all-am check check-am clean clean-generic ctags \ - ctags-recursive distclean distclean-generic distclean-tags \ - 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 \ - installdirs-am maintainer-clean maintainer-clean-generic \ - mostlyclean mostlyclean-generic pdf pdf-am ps ps-am tags \ - tags-recursive 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=fundamentals.docbook configuring.docbook Makefile.in man-kate.1.docbook plugins.docbook index.docbook part.docbook highlighting.docbook menus.docbook advanced.docbook regular-expressions.docbook Makefile.am kate.png mdi.docbook index.cache.bz2 - -#>+ 24 -index.cache.bz2: $(srcdir)/index.docbook $(KDE_XSL_STYLESHEET) regular-expressions.docbook man-kate.1.docbook part.docbook mdi.docbook index.docbook menus.docbook kate.png advanced.docbook fundamentals.docbook configuring.docbook plugins.docbook highlighting.docbook - @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)/kate - @if test -f index.cache.bz2; then \ - echo $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/; \ - $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/; \ - elif test -f $(srcdir)/index.cache.bz2; then \ - echo $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/; \ - $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/; \ - fi - -rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/common - $(LN_S) $(kde_libs_htmldir)/$(KDE_LANG)/common $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/common - -uninstall-docs: - -rm -rf $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate - -clean-docs: - -rm -f index.cache.bz2 - - -#>+ 13 -install-nls: - $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate - @for base in regular-expressions.docbook man-kate.1.docbook part.docbook mdi.docbook index.docbook menus.docbook kate.png advanced.docbook fundamentals.docbook configuring.docbook plugins.docbook highlighting.docbook ; do \ - echo $(INSTALL_DATA) $$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/$$base ;\ - $(INSTALL_DATA) $(srcdir)/$$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/$$base ;\ - done - -uninstall-nls: - for base in regular-expressions.docbook man-kate.1.docbook part.docbook mdi.docbook index.docbook menus.docbook kate.png advanced.docbook fundamentals.docbook configuring.docbook plugins.docbook highlighting.docbook ; do \ - rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/$$base ;\ - done - - -#>+ 5 -distdir-nls: - for file in regular-expressions.docbook man-kate.1.docbook part.docbook mdi.docbook index.docbook menus.docbook kate.png advanced.docbook fundamentals.docbook configuring.docbook plugins.docbook highlighting.docbook ; 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 docs/tdebase/kate/Makefile'; \ - cd $(top_srcdir) && \ - $(AUTOMAKE) --gnu docs/tdebase/kate/Makefile - cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/tdebase/kate/Makefile.in - - -#>+ 21 -clean-bcheck: - rm -f *.bchecktest.cc *.bchecktest.cc.class a.out - -bcheck: bcheck-recursive - -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/tde-i18n-nl/docs/kdebase/kate/advanced.docbook b/tde-i18n-nl/docs/kdebase/kate/advanced.docbook deleted file mode 100644 index 4a22df55e00..00000000000 --- a/tde-i18n-nl/docs/kdebase/kate/advanced.docbook +++ /dev/null @@ -1,215 +0,0 @@ -<chapter id="advanced-editing-tools"> -<title>Advanced Editing Tools</title> - -<sect1 id="comment"> - -<title>Comment/Uncomment</title> - -<para>The Comment and Uncomment commands, available from the -<guimenu>Tools</guimenu> menu allow you to add or remove comment -markers to the selection, or the current line if no text is selected, -it comments are supported by the format of the text you are -editing.</para> - -<para>The rules for how commenting is done are defined in the syntax -definitions, so if syntax highlighting is not used, -commenting/uncommenting is not possible.</para> - -<para>Some formats define single line comment markers, some multi line -markers and some both. If multi line markers are not available, -commenting out a selection that does not fully include its last line -is not possible.</para> - -<para>If a single line marker is available, commenting single lines is -preferred where applicable, as this helps to avoid problems with -nested comments.</para> - -<para>When removing comment markers, no uncommented text should be -selected. When removing multiline comment markers from a selection, -any whitespace outside the comment markers is ignored.</para> - -<para>To place comment markers, use the -<menuchoice><guimenu>Tools</guimenu><guimenuitem>Comment</guimenuitem></menuchoice> -menu item or the related keyboard shortcut sequence, default is -<keycombo action="simul">&Ctrl;<keycap>#</keycap></keycombo>.</para> - -<para>To remove comment markers, use the -<menuchoice><guimenu>Tools</guimenu><guimenuitem>Uncomment</guimenuitem></menuchoice> -menu item or the related keyboard shortcut, default is <keycombo -action="simul">&Ctrl;&Shift;<keycap>#</keycap></keycombo>.</para> - -</sect1> - -<sect1 id="edit-command"> - -<title>Editing Command</title> - -<para>This tool, available from the -<menuchoice><guimenu>Tools</guimenu><guimenuitem>Editing -Command</guimenuitem></menuchoice> menu item, provides access to a -small set of -<application>vi</application>/<application>vim</application>-like -commands for editing the text. It is a no nonsense tool for advanced -or experienced users, but do not let that hold you back from -experiencing its powers!</para> - -<para>Currently, the following commands are available:</para> - -<variablelist> -<varlistentry> -<term><command>time</command></term> - -<listitem> -<para>This command will output the current time as known by your -computer in the format <quote>HH:MM:SS</quote></para> - -<para>To use it, launch the Editing Command Dialog and type into the -input box the word <userinput>time</userinput></para> -</listitem> -</varlistentry> - -<varlistentry> -<term><command>char</command></term> -<listitem> -<para>This command allows you to insert literal characters by their -numerical identifier, in decimal, octal or hexadecimal form. -To use it launch the Editing Command dialog and type <userinput>char: -[number]</userinput> in the entry box, then hit -<guibutton>OK</guibutton>.</para> - -<example> -<title><command>char</command> examples</title> - -<para>Input: <userinput>char:234</userinput></para> -<para>Output: <computeroutput>ê</computeroutput></para> -<para>Input: <userinput>char:0x1234</userinput></para> -<para>Output: <computeroutput>ê</computeroutput></para> -<para>Input: <userinput>char:1232</userinput></para> -<para>Output: <computeroutput>ê</computeroutput></para> -</example> - -</listitem> - -</varlistentry> - -<varlistentry> - -<term><command>s///[ig]</command> <command>%s///[ig]</command></term> - -<listitem> -<para>This command does a sed-like search/replace operation on the -current line, or on the whole file (<command>%s///</command>).</para> - -<para>In short, the text is searched for text matching the -<emphasis>search pattern</emphasis>, the regular expression between -the first and the second slash, and when a match is found, the -matching part of the text is replaced with the expression between the -middle and last part of the string. Parentheses in the search pattern -create <emphasis>back references</emphasis>, that is the command -remembers which part of the match matched in the parentheses; these -strings can be reused in the replace pattern, referred to as -<userinput>\1</userinput> for the first set of parentheses, -<userinput>\2</userinput> for the second and so on.</para> - -<para>To search for a literal <literal>(</literal> or -<literal>)</literal>, you need to <emphasis>escape</emphasis> it using -a backslash character: <userinput>\(\)</userinput></para> - -<para>If you put an <userinput>i</userinput> at the end of the -expression, the matching will be case insensitive.</para> - -<example> - -<title>Replacing text in the current line</title> - -<para>Your friendly compiler just stopped, telling you that the class -<classname>myClass</classname> mentioned in line 3902 in your source file -is not defined.</para> - -<para>"Buckle!" you think, it is of course -<classname>MyClass</classname>. You go to line 3902, and instead of trying -to find the word in the text, you launch the Editing Command Dialog, -enter <userinput>s/myclass/MyClass/i</userinput>, hit the -<guibutton>OK</guibutton> button, save the file and compile – -successfully without the error.</para> - -</example> - -<example> -<title>Replacing text in the whole file</title> - -<para>Imagine that you have a file, in which you mention a <quote>Miss -Jensen</quote> several times, when someone comes in and tells you that -she just got married to <quote>Mr Jones</quote>. You want, of course, -to replace each and every occurrence of <quote>Miss Jensen</quote> -with <quote>Ms Jones</quote>.</para> - -<para>Launch the Editing Command dialog, and type into the entry box: -<userinput>%s/Miss Jensen/Ms Jones/</userinput> and hit return, you -are done.</para> - -</example> - -<example> -<title>A More Advanced Example</title> - -<para>This example makes use of <emphasis>back references</emphasis> -as well as a <emphasis>word class</emphasis> (if you do not know what -that is, please refer to the related documentation mentioned -below).</para> - -<para>Suppose you have the following line: - -<programlisting>void MyClass::DoStringOps( String &foo, String &bar String *p, int &a, int &b )</programlisting> -</para> -<para>Now you realize that this is not nice code, and decide that you -want to use the <constant>const</constant> keyword for all -<quote>address of</quote> arguments, those characterized by the & -operator in front of the argument name. You would also like to -simplify the white space, so that there is only 1 whitespace character -between each word.</para> - -<para>Launch the Editing Command Dialog, and enter: -<userinput>s/\s+(\w+)\s+(&)/ const \1 \2/g</userinput> and hit the -<guibutton>OK</guibutton> button. The <userinput>g</userinput> at the end of the expression makes -the regular expression recompile for each match to save the <emphasis>backreferences</emphasis>.</para> - -<para>Output: - -<computeroutput>void MyClass::DoStringOps( const String &foo, const String &bar String *p, const int &a, const int &b )</computeroutput></para> - -<para>Mission completed! Now, what happened? Well, we looked for some -white space (<literal>\s+</literal>) followed by one or more -alphabetic characters (<literal>\w+</literal>) followed by some more -whitespace (<literal>\s+</literal>) followed by an ampersand, and in -the process saved the alphabetic chunk and the ampersand for reuse in -the replace operation. Then we replaced the matching part of our line -with one whitespace followed by <quote>const</quote> followed by one -whitespace followed by our saved alphabetical chunk -(<literal>\1</literal>) followed by one whitespace followed by our -saved ampersand (<literal>\2</literal>)</para> - -<para>Now in some cases the alphabetical chunk was -<quote>String</quote>, in some <quote>int</quote>, so using the -character class <literal>\w</literal> and the <literal>+</literal> -quantifier proved a valuable asset.</para> - -</example> - -</listitem> -</varlistentry> - -</variablelist> - -<warning> -<para>This is extremely powerful, and though the actions can be undone -by calling the -<menuchoice><guimenuitem>Undo</guimenuitem></menuchoice> command -several times (as required) I recommend you practice a bit before -using this command for serious editing if you are not familiar with -<application>sed</application> or perl regular expressions.</para> -</warning> - -</sect1> - -</chapter> diff --git a/tde-i18n-nl/docs/kdebase/kate/configuring.docbook b/tde-i18n-nl/docs/kdebase/kate/configuring.docbook deleted file mode 100644 index 98deca22f1c..00000000000 --- a/tde-i18n-nl/docs/kdebase/kate/configuring.docbook +++ /dev/null @@ -1,674 +0,0 @@ -<chapter id="configuring-kate"> -<title>Configuring &kate;</title> - -<sect1> -<title>Overview</title> -<para> -<anchor id="settings"/> -<anchor id="configure"/> -<anchor id="find"/> -<anchor id="find-again"/> -<!-- <anchor id="print"/> --> -<anchor id="replace"/> -<!-- <anchor id="save"/> --> -<anchor id="undo"/> -<anchor id="redo"/> -&kate; offers several means of tweaking the application to behave as desired. -The most important ones are: -</para> -<variablelist> -<varlistentry> -<term>The Configuration Dialog</term> -<listitem><para>The main configuration tool, allowing you to configure the &kate; application, -the editor component and the usage of plugins.</para></listitem> -</varlistentry> -<varlistentry> -<term>The Settings Menu</term> -<listitem><para>Allows you to change often used settings, and to launch the configuration dialogs.</para></listitem> -</varlistentry> -<varlistentry> -<term>The View Menu</term> -<listitem><para>Allows you to split the current frame, as well as to display the icons and line numbers pane for the currently edited document.</para></listitem> -</varlistentry> -</variablelist> - -<para>The embedded Konsole is using the configuration defined in the Control Center, and may be -configured clicking the right mouse and choosing from the -<guimenuitem>Settings</guimenuitem> sub menu. -</para> - -</sect1> - -<sect1 id="configuring-kate-configdialog"> -<title>The Main Configuration Dialog</title> - -<mediaobject> -<imageobject> -<imagedata format="PNG" fileref="configdialog01.png"/> -</imageobject> -</mediaobject> - -<para>The &kate; configuration dialog displays a tree of topics on the -left, and a configuration page corresponding to the selected topic on -the right. The tree groups the pages of the dialog into logical -groups.</para> - -<sect2 id="config-dialog"> -<title>The &kate; group</title> -<para>This group contains pages to configure the main &kate; application</para> - -<sect3 id="config-dialog-general"> -<title>The General Page</title> -<para>Global options for &kate;</para> - -<variablelist> -<varlistentry> -<term>Application Mode</term> -<listitem> -<para>This group lets you choose between &kate; <acronym>MDI</acronym> and -&kate; <acronym>SDI</acronym> mode, selecting the appropriate button.</para> - <para>&kate; <acronym>MDI</acronym> -(Multiple Document Interface), which is the default mode, makes &kate; use a -single window for all open files. You can choose the document to edit from the -File List (docked into the &kate; window on the left by default) or by -selecting the document from the <guimenu>Document</guimenu> menu.</para> -<para>&kate; <acronym>SDI</acronym> (Single Document Interface) will make &kate; open each -document in a window of its own, and the File List/File Selector will have a -separate window.</para> - <para>If you change this setting, you will need to -restart &kate; for it to take effect.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>At Startup</term> -<listitem><para>These options determine how -and if &kate; will restore your editing session when launched anfer a -normal shutdown (if restored by the session manager, &kate; will -always attempt to restore your session as close as possible to what it -was when you last used &kate;).</para> - -<variablelist> -<varlistentry> -<term> -<anchor id="config-dialog-general-reopen-files"/> -<guibutton>Reopen Files</guibutton></term> -<listitem><para>If this option is enabled, files open when you last -closed &kate; will be reopened. Bookmarks will be restored, and the -cursor position, icon border and line numbers settings for the last -editor used with the document will be reestablished</para></listitem> -</varlistentry> -<varlistentry> -<term><guibutton>Restore View Configuration</guibutton></term> -<listitem><para>If this option is enabled, &kate; will attempt to restore your frames exactly as -you left them.</para></listitem> -</varlistentry> -</variablelist> - -</listitem> - -</varlistentry> - -<varlistentry> -<term><guibutton>Restrict to single instance</guibutton></term> -<listitem><para>Enabling this means you can only have one running -instance of &kate; running at any given time. If you attempt to start -another one, the current instance will take over and also open files -as requested. For example, if you use &kate; for displaying sources -for web pages in Konqueror, they will all be opened in an existing -instance of &kate; if this option is enabled.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guibutton>Show Contents While Resizing -Frames</guibutton></term> <listitem><para>If this option is enabled, -the windows will be fully repainted while dragging the frame -splitters. A nice way to use some extra <acronym>CPU</acronym> cycles -:). If unchecked, a so-called <quote>rubber band</quote> (indicating -the new size of the frame) will be used instead.</para></listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="config-dialog-general-sync-konsole"/> -<guibutton>Sync Konsole with Active Document</guibutton></term> -<listitem><para>This will cause the built-in &konsole; to -<command>cd</command> into the directory of the active document when -launched, and when a new document gets the focus. If not enabled, you -have to do all your navigation in the &konsole; on your own -</para></listitem> -</varlistentry> - -<varlistentry> -<term><guibutton>Number of Recent Files</guibutton></term> -<listitem><para>Unsurprisingly, this allows you to decide how long the -<guimenu>Open Recent</guimenu> files menu should grow.</para></listitem> -</varlistentry> - -</variablelist> -</sect3> - - -</sect2> - -<sect2 id="config-dialog-editor"> -<title>The Editor Group</title> -<para>This group contains all pages related to the editor component of -&kate;</para> - -<sect3 id="config-dialog-editor-colors"> -<title>The <guilabel>Colors</guilabel> Page</title> <para>This page allows you -to change the background and selection background colors of the editor. -Initially, &kate; will use the colors as set in the &kcontrolcenter; -<menuchoice><guimenu>Look'n'Feel</guimenu><guimenuitem>Colors</guimenuitem> -</menuchoice> -page.</para> - -<para>To change a color, press the associated button and select -the desired color in the color chooser.</para> - -<note><para>Choosing the background color may render Syntax -Highlighted text unreadable. You should use a light color for the -background, and a dark color for the selection background. -</para> -<para>Otherwise, you will probably need to change the <link linkend="config-dialog-editor-highlight-default-styles">Default Styles</link>.</para> -</note> -</sect3> - -<sect3 id="config-dialog-editor-fonts"> -<title>The Fonts Page</title> <!-- FIXME LINKS //--> - -<para>This page allows you to choose the default fonts for &kate;. The -settings will be used for the &kwrite; and for viewing text files in -&konqueror; as well.</para> - -<para>The page presents two tabs, one for the editor font and one for -the printing font. Select a tab and choose the desired font. The -default is to use the &kde; global setting for fixed font.</para> - -<tip><para>As it is not currently possible to use individual fonts for -documents, nor to change the font for printing from the print dialog, -be careful. A fixed-width font is strongly recommended. </para></tip> -</sect3> - -<sect3 id="config-dialog-editor-indent"> -<title>The Indent Page</title> -<para>This page allows you to change the behavior of indentation.</para> - -<variablelist> -<title>Indent Options</title> - -<varlistentry> -<term> -<anchor id="config-dialog-editor-indent-auto-indent" /> -<guibutton>Auto indent</guibutton> -</term> -<listitem> -<para>If checked, &kate; will automatically indent new lines equal to -the previous line. If the previous line is blank, the nearest above -line with contents is used.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="config-dialog-editor-indent-indent-with-spaces" /> -<guibutton>Indent with Spaces</guibutton> -</term> -<listitem> -<para>If checked, &kate; will indent with spaces rather than tabs.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="config-dialog-editor-indent-backspace-key-indents" /> -<guibutton>Backspace key indents</guibutton> -</term> -<listitem> -<para>If this is checked, &kate; will unindent equal to the nearest -above line with contents when you press the <keycap>Backspace</keycap> -key if the part of the line preceding the cursor contains only -whitespace.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="config-dialog-editor-indent-tab-key-indents" /> -<guibutton>Tab key indents</guibutton> -</term> -<listitem> -<para>If this is checked, &kate; will indent the current line equal to -the nearest above line with content when you press the -<keycap>Tab</keycap> key, if the part of the line preceding the cursor -contains only whitespace.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="config-dialog-editor-indent-keep-extra-spaces" /> -<guibutton>Keep extra spaces</guibutton> -</term> -<listitem> -<para>With this behavior checked, &kate; will leave whitespace behind -the cursor after indenting.</para> -</listitem> -</varlistentry> - -</variablelist> - -</sect3> - -<sect3 id="config-dialog-editor-select"> -<title>The Select Page</title> - -<para>This page provides options for fine tuning the select behavior -of &kate;</para> - -<variablelist> -<title>Select Options</title> - -<varlistentry> -<term> -<anchor id="config-dialog-editor-select-persistent-selections" /> -<guibutton>Persistent Selections</guibutton> -</term> -<listitem> -<para>When Persistent Selections is enabled, key input will not cause -the selection to be removed/diminished.</para> -<note><para>This option -partly conflicts with the Overwrite Selection option. If both are -enabled, pasting text or pressing any other keys than the arrow keys -will cause the selection to be overwritten.</para></note> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="config-dialog-editor-select-overwrite-selections" /> -<guibutton>Overwrite Selection</guibutton> -</term> -<listitem> -<para>If this is enabled, any text insertion, whether typed or pasted will cause the selected -text to be deleted and replaced with the inserted text.</para> -</listitem> -</varlistentry> - -<!-- NOTE this option has gone (anders) -<varlistentry> -<term> -<anchor id="config-dialog-editor-select-mouse-autocopy" /> -<guibutton>Mouse Autocopy</guibutton> -</term> -<listitem> -<para>If enabled, any text selected by moving the mouse with the left button pressed will -be copied to the clipboard, ready for pasting.</para> -</listitem> -</varlistentry> ---> -</variablelist> - -</sect3> - -<sect3 id="config-dialog-editor-edit"> -<title>The Edit Page</title> -<para>This page contains miscellaneous options for fine-tuning the behavior of the &kate; -editor component.</para> - -<variablelist> -<title>Editor Options</title> - -<varlistentry> -<term> -<anchor id="config-dialog-editor-edit-word-wrap" /> -<guibutton>Word Wrap</guibutton> -</term> -<listitem> -<para>Word Wrap as used here means dynamically format the text by breaking lines at an appropriate -place, rather than soft wrapping lines in the editor for easier reading.</para> -<para>If enabled, &kate; will insert a line break as defined by the <link linkend="document-end-of-line">End of Line</link> -setting for the document when the line extends the length set in -<link linkend="config-dialog-editor-edit-wrap-words-at">Wrap Words At</link> option described below.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="config-dialog-editor-edit-wrap-words-at" /> -<guibutton>Wrap Words At</guibutton> -</term> -<listitem> -<para>This option decides the max length of lines if the -<link linkend="config-dialog-editor-edit-word-wrap">Word Wrap</link> option is enabled.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="config-dialog-editor-edit-replace-tabs-with-spaces" /> -<guibutton>Replace Tabs with Spaces</guibutton> -</term> -<listitem> -<para>If enabled, &kate; will replace inserted <keycap>Tab</keycap> -characters with a number of single whitespace characters as defined in -<link linkend="config-dialog-editor-edit-tab-indent-width">Tab -Width</link>.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="config-dialog-editor-edit-remove-trailing-spaces" /> -<guibutton>Remove trailing spaces</guibutton> -</term> -<listitem> -<para>If enabled, &kate; will remove any whitespace at the rear end of -a line each time the cursor is moved off that line.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="config-dialog-editor-edit-tab-indent-width" /> -<guibutton>Tab/Indent Width</guibutton> -</term> -<listitem> -<para>Sets the tab width, which is also used to decide the amount of indentation when -<link linkend="config-dialog-editor-indent-auto-indent">Auto Indent</link> is enabled, or -indentation is otherwise called for.</para> -<para>Depending on the <link linkend="config-dialog-editor-indent">Indent</link> settings indentation may be caused -by pressing the <keycap>Tab</keycap> and <keycap>Backspace</keycap> keys, and activating the -<link linkend="edit-indent"><guimenu>Edit</guimenu> <guimenuitem>Indent</guimenuitem></link> -menu entry will call for indent as well.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="config-dialog-editor-edit-auto-brackets" /> -<guibutton>Auto Brackets</guibutton> -</term> -<listitem> -<para>If this is enabled, &kate; will automatically insert a right bracket immediately to the -right of the cursor when a left bracket is inserted from the keyboard. The supported bracket types -are <keycap>(</keycap>, <keycap>{</keycap>, <keycap>[</keycap>and <keycap><</keycap></para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="config-dialog-editor-edit-group-undos" /> -<guibutton>Group undos</guibutton> -</term> -<listitem> -<para>If enabled, &kate; will group any number of similar editing -actions (for example typing, backspacing, pasting) in one entry in the -undo history, so they can all be undone at once.</para> -</listitem> -</varlistentry> - - -<varlistentry> -<term> -<anchor id="config-dialog-editor-edit-show-tabs" /> -<guibutton>Show Tabs</guibutton> -</term> -<listitem> -<para>If enabled, &kate; will draw a small dot at the start of a -<keycap>Tab</keycap> character in the editor to indicate its -presence.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="config-dialog-editor-edit-smart-home" /> -<guibutton>Smart Home</guibutton> -</term> -<listitem> -<para>This will make &kate; move the cursor to the first -non-whitespace character of the current line rather than to the -absolute beginning, when the <keycap>Home</keycap> key (or other key -assigned to that function) is pressed.</para> -</listitem> -</varlistentry> - -<!-- NOTE This option has gone (anders) -<varlistentry> -<term> -<anchor id="config-dialog-editor-edit-page-up-down-moves-cursor" /> -<guibutton>Page Up/Down moves cursor</guibutton> -</term> -<listitem> -<para>If enabled, the cursor will be moved to the first/last visible -line when <keycap>Page Up</keycap>/<keycap>Page Down</keycap> (or -other key assigned to those functions) is pressed, rather than being -kept at its relative position.</para> -</listitem> -</varlistentry> ---> -<varlistentry> -<term> -<anchor id="config-dialog-editor-edit-wrap-cursor" /> -<guibutton>Wrap Cursor</guibutton> -</term> -<listitem> -<para>If enabled, moving the cursor past the end of a line will cause -it to continue to the next/previous line if any.</para> -<para>If not enabled, the cursor cannot be moved right of the -beginning of the line, but it may be moved past the end of line, and -when text is inserted &kate; will automatically insert whitespace up -to that position. This is sometimes very handy for programmers, for -example.</para> -</listitem> -</varlistentry> - -</variablelist> - -</sect3> - -<sect3 id="config-dialog-editor-keyboard"> -<title>The Keyboard Page</title> - -<para>Here you can configure the keyboard shortcuts for the internal -commands of the &kate; editor component. These includes commands for -moving around in the document and selecting text. For keys related to -copying and pasting text, see <!-- link linkend="" -->The Configure -Keys Dialog<!-- /link --></para> - -<para>You may change the keys for a command, or add an alternate -key.</para> - -<procedure> -<title>To change the key(s) for a command, follow this procedure:</title> -<step> -<para>Select the command for which you want to configure the keys.</para> -</step> -<step> -<para>Choose the <guibutton>None</guibutton> option in the pane below the list if you don't want a -key for this command.</para> -<para>Choose the <guibutton>Default</guibutton> option to use the default key(s) for the -command</para> -<para>Choose the <guibutton>Custom</guibutton> option to select a custom key for the command, -or set an alternate one.</para> -</step> -<step> -<para>If you choose the <guibutton>Custom</guibutton> option, the key -entering button at the right of the pane will be enabled. To set a -key, press it. The &kde; Define Shortcut Dialog will appear. In this -dialog:</para> -</step> -<step> -<procedure> -<step> -<para>Choose whether to set the default or alternate -key. <guilabel>Default</guilabel> does not mean that you change the -application default for this action, rather it sets the custom -standard key for it.</para> -</step> -<step> -<para>Press the desired key sequence, it will be visualized for you in -the dialog for your confirmation. </para> - -<para>If you are of an adventurous nature, try playing around with the -<guibutton>Multikey</guibutton> option. Using it will allow you to -have &Emacs;-like key sequences (one key enters a group, the next -performs the action), apart from the fact that instead of just doing -the job, &kde; will pop up a menu to choose from in an undefined and -most likely inappropriate place. You will now be in no doubt as to -whether pressing the next key in the sequence will work, or you have -to type the menu accelerator (both will work).</para> -</step> -</procedure> -</step> -</procedure> -</sect3> - -<sect3 id="config-dialog-editor-spelling"> -<title>The Spelling Page</title> -<para>This page allows you to configure how &kspell; behaves with &kate;</para> -</sect3> - -<sect3 id="config-dialog-editor-hl"> -<title>The Highlighting Page</title> - -<para>This page allows you to fine tune the color and syntax type selection of &kate;</para> -<para> -<mediaobject> -<imageobject><imagedata format="PNG" fileref="configdialog02.png" /></imageobject> -</mediaobject> -</para> -<para>For more in depth information on the syntax highlighting system, see ??</para> - -<para>The page consists of two tabs, one for setting the -<guibutton>Default styles</guibutton> and one for managing the -<guibutton>Highlight Modes</guibutton>. Both tabs display a list of -contexts in which the default colors and font are used to visualize -the look of each style. The context name is painted using the current -properties of the context.</para> - -<para>The list has four or five columns, each with the following -purpose:</para> - -<variablelist> - -<varlistentry> -<term>Context</term> -<listitem><para>Displays the context name, painted using the style -properties for the context.</para></listitem> -</varlistentry> - -<varlistentry> -<term>Bold</term> -<listitem><para>The state of this checkbox decides if the context should be -rendered using a boldface -font.</para></listitem> -</varlistentry> - -<varlistentry> -<term>Italic</term> -<listitem><para>The state of this checkbox decides if the context should be rendered using italic -font.</para></listitem> -</varlistentry> - -<varlistentry> -<term>Normal</term> -<listitem><para>This button displays the color for drawing the style in normal mode, when the text -is not selected that is. To change the color, click the button.</para></listitem> -</varlistentry> - -<varlistentry> -<term>Selected</term> -<listitem><para>This button displays the color for drawing the style when the text -is selected. To change the color, click the button.</para></listitem> -</varlistentry> - -<varlistentry> -<term>Using Default</term> -<listitem><para>This checkbox, only available in the -<guibutton>Highlight Modes</guibutton> tab shows if the style is using -its default values. It will automatically become unchecked if you -change any properties of the style. Check it to reset a style to using -defaults.</para></listitem> -</varlistentry> - -</variablelist> - -<sect4 id="config-dialog-editor-highlight-default-styles"> -<title>The Default Styles Tab</title> -<para>To change any of the default styles, set its properties as desired.</para> -</sect4> - -<sect4 id="config-dialog-editor-highlight-highlight-modes"> -<title>The Highlight Modes Tab</title> - -<para>Here you can change the most important properties of each -available highlight mode. First, use the -<guibutton>Highlight</guibutton> dropdown to choose a mode to work -on.</para> <para>Highlight modes are initially chosen based on the -&MIME; type and extension of the file. To change the list for the -current selection, edit the <guibutton>File Extensions</guibutton> and -<guibutton>Mime Types</guibutton> entries. Alternatively, press the -wizard button to the right of the <guibutton>Mime Types</guibutton> -entry. This will show a dialog displaying all available &MIME; types -to choose from. Using it will edit the &MIME; types as well as the -file extensions.</para> - -<mediaobject> -<imageobject><imagedata format="PNG" fileref="mimetypechooser.png" /></imageobject> -</mediaobject> -<para> -The &MIME; type chooser dialog displays a tree of available &MIME; types, with -a description and the patterns for the &MIME; type. To include a &MIME; type, -check the box beside it. -</para> - -<para>You can change the style properties of any context as described -above.</para> - -<para>At the bottom of the tab, below the highlight -properties, you see a button labeled -<guibutton>Download</guibutton>. Pressing it will attempt to connect -to the &kate; website and fetch a list of available syntax highlight -modes which you can update or add.</para> - -</sect4> - -</sect3> - -</sect2> - -<sect2 id="config-dialog-plugins"> -<title>The Plugins Group</title> - -<para>This group contains pages related to plugins. Apart from the -Manager configuration page, some plugins provide individual -configuration options. For information on these, see the documentation -for the individual plugins.</para> - -<sect3 id="config-dialog-plugins-manager"> -<title>The Plugin Manager Page</title> - -<para>This page provides the means of loading/unloading plugins, and -minimal information about individual plugins.</para> - -<para>To load an unloaded plugin, select it in the <guibutton>Available -Plugins</guibutton> pane and use the arrow buttons to move it to the -<guibutton>Loaded Plugins</guibutton> pane.</para> - -<para>To unload a loaded plugin, select it in the <guibutton>Loaded -Plugins</guibutton> pane and use the arrow buttons to move it to the -<guibutton>Available buttons</guibutton> pane.</para> - -<para>To view a minimal description and information about a plugin, -select it and the information will be available below the -lists.</para> -</sect3> - -</sect2> - -</sect1> - -</chapter> diff --git a/tde-i18n-nl/docs/kdebase/kate/fundamentals.docbook b/tde-i18n-nl/docs/kdebase/kate/fundamentals.docbook deleted file mode 100644 index 172acb02b3b..00000000000 --- a/tde-i18n-nl/docs/kdebase/kate/fundamentals.docbook +++ /dev/null @@ -1,470 +0,0 @@ -<chapter id="fundamentals"> -<title>The Fundamentals</title> - -<para> -If you have ever used a text editor, you will have no problem using -&kate;. In the next two sections, <link linkend="starting-kate">Starting -&kate; </link> and in <link linkend="working-with-kate">Working with -&kate;</link>, we'll show you everything you need to get up and running -quickly. -</para> - -<sect1 id="starting-kate"> -<title>Starting &kate;</title> - -<para> -You can start &kate; from the <guimenu>K menu</guimenu> or from the -command line. -</para> - -<sect2 id="starting-from-the-menu"> -<title>From the Menu</title> -<para> -Open the &kde; program menu by clicking on the -<guiicon>big K</guiicon> icon on the toolbar at the bottom left of your -screen. This will raise the <guimenu>program menu</guimenu>. Move your -cursor up the menu to the <guimenu>Editors</guimenu> menu item. A list -of available editors will appear. Choose -<guimenuitem>&kate;</guimenuitem>. -</para> - -<para> -Unless you configure &kate; not to, it will load the last files you -edited. See <link linkend="configure">Configuring &kate;</link> to learn -how to toggle this feature on and off. -</para> - -</sect2> - -<sect2 id="starting-from-the-command-line"> -<title>From the Command Line</title> - -<para> -You can start &kate; by typing its name on the command line. If you give -it a file name, as in the example below, it will open or create that -file. -</para> - -<informalexample> -<screen> -<prompt>%</prompt><userinput><command>kate</command> <option><replaceable>myfile.txt</replaceable></option></userinput> -</screen> -</informalexample> - -<para> -If you have an active connection, and permission, you can take advantage -of &kde;'s network transparency to open files on the internet. -</para> - -<informalexample> -<screen> -<prompt>%</prompt><userinput><command>kate</command> <option><replaceable>ftp://ftp.kde.org/pub/kde/README_FIRST</replaceable></option></userinput> -</screen> -</informalexample> - -<sect3 id="command-line-options"> -<title>Command Line Options</title> -<para>&kate; accepts following command line options:</para> - -<variablelist> -<varlistentry> -<term><userinput><command>kate</command> <option>--help</option></userinput></term> -<listitem> -<para> -This lists the most basic options available at the command line. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><userinput><command>kate</command> -<option>--help-qt</option></userinput></term> -<listitem> -<para> -This lists the options available for changing the way &kate; interacts -with &Qt;. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><userinput><command>kate</command> <option>--help-kde</option></userinput></term> -<listitem> -<para> -This lists the options available for changing the way &kate; interacts -with &kde;. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><userinput><command>kate</command> -<option>--help-all</option></userinput></term> -<listitem> -<para> -This lists all of the command line options. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><userinput><command>kate</command> -<option>--author</option></userinput></term> -<listitem> -<para> -Lists &kate;'s authors in the terminal window. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><userinput><command>kate</command> -<option>--version</option></userinput></term> -<listitem> -<para> -Lists version information for &Qt;, &kde;, and &kate;. Also available -through <userinput><command>kate</command> -<option>-V</option></userinput> -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><userinput><command>kate</command> -<option>--license</option></userinput></term> -<listitem> -<para> -Shows license information. -</para> -</listitem> -</varlistentry> -</variablelist> -</sect3> -</sect2> - -<sect2 id="drag-and-drop"> -<title>Drag and Drop</title> -<para> -&kate; uses the &kde; Drag and Drop protocol. Files may be dragged and -dropped onto &kate; from the Desktop, &konqueror; or some remote ftp -site opened in one of &konqueror;'s windows. -</para> -</sect2> -</sect1> - -<sect1 id="working-with-kate"> -<title>Working with &kate;</title> -<para> -<link linkend="quick-start">Quick Start</link> will show you how to -toggle four simple options that will let you configure some of &kate;'s -more powerful features right away. <link linkend="keystroke-commands"> -Keystroke Commands</link> lays out some of the default keystroke -shortcuts for those who can't or don't want to use a mouse. -</para> - -<sect2 id="quick-start"> -<title>Quick Start</title> - -<para> -This section will describe some of the items on the -<guimenu>Settings</guimenu> menu so that you can quickly configure -&kate; to work the way you want it. -</para> - -<para> When you start &kate; for the first time you'll see two windows -with white backgrounds. Above the two windows is a toolbar with the -usual labeled icons. And above that, a menu bar. -</para> - -<para> -The left-hand window is a dockable side bar. It combines the Filelist -and Fileselector windows. Switch between the two by clicking on the tabs -at the top of the window. </para> - -<para> -If you've started &kate; with a file, the right-hand window will show -the file you are editing and the Filelist on the side bar will show the -name of the file. Use the Fileselector window to open files. -</para> - -<para> -You can toggle the Filelist and Fileselector window on and off in -<guimenu>Settings</guimenu> menu. This menu offers you your first -glimpse into &kate;'s power and flexibility. In this section we'll look -at four items: -</para> - -<variablelist> -<varlistentry> -<term><menuchoice><guimenuitem>Show -Toolbar</guimenuitem></menuchoice></term> -<listitem> -<para> -Toggles the toolbar on and off. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<menuchoice> -<guimenuitem>Show Filelist</guimenuitem> -</menuchoice> -</term> -<listitem> -<para> -Toggles the Filelist on and off. If the Filelist/Fileselector window is -not open, &kate; launches the side bar as a separate, undocked, -window. To dock the window grab the two thin parallel lines above the -tabs by clicking on them with your &LMB; and holding the button -down. Drag the the window into &kate;'s editing window and release the -&LMB; when you have positioned the Filelist/Fileselector window as you -prefer. -</para> - -<tip> -<para> -If you have grabbed the two parallel lines successfully your mouse -pointer will turn into two crossed arrows as you drag. -</para> -</tip> - -</listitem> -</varlistentry> -<varlistentry> -<term><menuchoice><guimenuitem>Show -Fileselector</guimenuitem></menuchoice></term> -<listitem> -<para> -Toggles the Fileselector on and off. This menu item is the same as -<guimenuitem>Show Filelist</guimenuitem> with one difference. Toggling -it on launches the window with the Fileselector on top. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><menuchoice><guimenuitem>Show -Console</guimenuitem></menuchoice></term> -<listitem> -<para> -Toggles a console emulator on and off at the bottom of &kate;'s -window. In other words, it gives you a command line within the -application. -</para> -</listitem> -</varlistentry> -</variablelist> -</sect2> - -<sect2 id="keystroke-commands"> -<title>Keystroke Commands</title> - -<para> -Many of &kate;'s keystroke commands (shortcuts) are configurable by -way of the <link linkend="settings">Settings</link> menu. By default -&kate; honors the following key bindings. -</para> - -<informaltable> -<tgroup cols="2"> -<tbody> - -<row><entry><para><keycap>Insert</keycap></para></entry> -<entry><para> -Toggle between Insert and Overwrite mode. When in insert mode the editor -will add any typed characters to the text and push any previously typed -data to the right of the text cursor. Overwrite mode causes the entry of -each character to eliminate the character immediately to the right of -the text cursor.</para></entry> -</row> -<row> -<entry><para><keycombo><keycap>Left Arrow</keycap></keycombo></para></entry> -<entry><para>Move the cursor one character to the left </para></entry> -</row> -<row> -<entry><para><keycombo><keycap>Right Arrow</keycap></keycombo></para></entry> -<entry><para> Move the cursor one character to the right </para></entry> -</row> -<row> -<entry><para><keycombo action="simul"><keycap>Up Arrow</keycap></keycombo></para></entry> -<entry><para> Move the cursor up one line </para></entry> -</row> -<row> -<entry><para><keycombo action="simul"><keycap>Down Arrow</keycap></keycombo></para></entry> -<entry><para> Move the cursor down one line </para></entry> -</row> -<row> -<entry><para><keycombo action="simul"><keycap>Page Up</keycap></keycombo></para></entry> -<entry><para> Move the cursor up one page </para></entry> -</row> -<row> -<entry><para><keycombo action="simul"><keycap>Page Down</keycap></keycombo></para></entry> -<entry><para>Move the cursor down one page </para></entry> -</row> -<row> -<entry><para><keycombo action="simul"><keycap>Backspace</keycap></keycombo></para></entry> -<entry><para> Delete the character to the left of the cursor </para></entry> -</row> -<row> -<entry><para><keycombo action="simul"><keycap>Home</keycap></keycombo></para></entry> -<entry><para> Move the cursor to the beginning of the line </para></entry> -</row> -<row> -<entry><para><keycombo action="simul"><keycap>End</keycap></keycombo></para></entry> -<entry><para> Move the cursor to the end of the line </para></entry> -</row> -<row> -<entry><para><keycombo action="simul"><keycap>Delete</keycap></keycombo></para></entry> -<entry><para>Delete the character to the right of the cursor (or any selected -text)</para></entry> -</row> -<row> -<entry><para><keycombo action="simul">&Shift;<keycap>Left Arrow</keycap></keycombo></para></entry> -<entry><para> Mark text one character to the left </para></entry> -</row> -<row> -<entry><para><keycombo action="simul">&Shift;<keycap>Right Arrow</keycap></keycombo></para></entry> -<entry><para> Mark text one character to the right </para></entry> -</row> -<row> -<entry><para><keycombo action="simul"><keycap>F1</keycap></keycombo></para></entry> -<entry><para> Help</para></entry> -</row> -<row> -<entry><para><keycombo action="simul">&Shift;<keycap>F1</keycap></keycombo></para></entry> -<entry><para><link linkend="whats-this">What's this?</link></para></entry> -</row> -<row> -<entry><para><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></para></entry> -<entry><para><link linkend="find"> Find</link></para></entry> -</row> -<row> -<entry><para><keycombo action="simul"><keycap>F3</keycap></keycombo></para></entry> -<entry><para><link linkend="find-again"> Find again</link></para></entry> -</row> -<row> -<entry><para><keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo></para></entry> -<entry><para>Set a Bookmark</para></entry> -</row> -<row> -<entry><para><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></para></entry> -<entry><para> Copy the marked text to the clipboard. </para></entry> -</row> - -<row> -<entry><para><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></para></entry> -<entry><para> <link linkend="new">New</link> document</para></entry> -</row> -<row> -<entry><para><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></para></entry> -<entry><para><link linkend="print">Print</link> </para></entry> -</row> -<row> - -<entry><para><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></para></entry> -<entry><para>Quit - close active copy of editor </para></entry> -</row> -<row> -<entry><para><keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo></para></entry> -<entry><para><link linkend="replace"> Replace</link></para></entry> -</row> -<row> -<entry><para><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></para></entry> -<entry><para>Save your file.</para></entry> -</row> -<row> -<entry><para><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></para></entry> -<entry><para> Paste.</para></entry> -</row> - -<row> -<entry><para><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></para></entry> -<entry><para>Delete the marked text and copy it to the clipboard. </para></entry> -</row> -<row> -<entry><para><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></para></entry> -<entry><para><link linkend="undo">Undo</link></para></entry> -</row> -<row> -<entry><para><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></para></entry> -<entry><para><link linkend="redo">Redo</link></para></entry> -</row> -</tbody> -</tgroup> -</informaltable> -</sect2> - -</sect1> - -<sect1 id="fundamentals-getting-help"> - -<title>Getting Help</title> - -<sect2> - -<title>With &kate;</title> -<variablelist> - -<varlistentry> -<term>This manual</term> - -<listitem> -<para>Offers detailed documentation on all menu commands, -configuration options, tools, dialogs, plugins &etc; as well as -descriptions of of the &kate; window, the editor and various concepts -used in the application.</para> - -<para>Press <keycap>F1</keycap> or use the -<menuchoice><guimenu>Help</guimenu></menuchoice> -<guisubmenu>Contents</guisubmenu> menu topic to view this -manual.</para></listitem> - -</varlistentry> - -<varlistentry id="whats-this"> -<term>What's This Help</term> -<listitem> -<para>What's This help offers immediate help with single elements of -graphical windows, such as buttons or other window areas.</para> - -<para>We strive to provide What's This help for any elements for which -it makes sense. It is available throughout the configuration dialog, -and in many other dialogs as well.</para> - -<para>To employ What's This help, press -<keycombo>&Shift;<keycap>F1</keycap></keycombo> or use the -<menuchoice><guimenu>Help</guimenu><guimenuitem>What's -This</guimenuitem></menuchoice> menu item to enable What's This -mode. The cursor will turn into an arrow with a question mark, and you -can now click any element in the window to read the What's This help -for that element, if it is available.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>Help Buttons in Dialogs</term> -<listitem> -<para>Some dialogs have a <guibutton>Help</guibutton> Button. Pressing -it will start the &khelpcenter; and open the relevant -documentation.</para> -</listitem> -</varlistentry> -</variablelist> - -</sect2> - -<sect2> -<title>With Your Text Files</title> - -<para>&kate; does not (yet!) provide any means for reading document -related documentation. Depending on the file you are editing, you may -find the <link linkend="kate-mdi-tools-konsole">Built in -&konsole;</link> helpful for viewing related &UNIX; manual pages or -info documentation, or you can use &konqueror;.</para> - -</sect2> - -</sect1> - -</chapter> diff --git a/tde-i18n-nl/docs/kdebase/kate/highlighting.docbook b/tde-i18n-nl/docs/kdebase/kate/highlighting.docbook deleted file mode 100644 index d664f040e1b..00000000000 --- a/tde-i18n-nl/docs/kdebase/kate/highlighting.docbook +++ /dev/null @@ -1,479 +0,0 @@ -<appendix id="highlight"> -<title>Working with Syntax Higlighting</title> - -<sect1 id="highlight-overview"> - -<title>Overview</title> - -<para>Syntax Highlighting is what makes the editor automatically -display text in different styles/colors, depending on the function of -the string in relation to the purpose of the file. In program source -code for example, control statements may be rendered bold, while data -types and comments get different colors from the rest of the -text. This greatly enhances the readability of the text, and thus -helps the author to be more efficient and productive.</para> - -<mediaobject> -<imageobject><imagedata format="PNG" fileref="highlighted.png"/></imageobject> -<textobject><phrase>A perl function, rendered with syntax -highlighting.</phrase></textobject> -<caption><para>A perl function, rendered with syntax highlighting.</para> -</caption> -</mediaobject> - -<mediaobject> -<imageobject><imagedata format="PNG" fileref="unhighlighted.png"/></imageobject> -<textobject><phrase>The same perl function, without -highlighting.</phrase></textobject> -<caption><para>The same perl function, without highlighting.</para></caption> -</mediaobject> - -<para>Of the two examples, which is easiest to read?</para> - -<para>&kate; comes with a flexible, configurable and capable system -for doing syntax highlighting, and the standard distribution provides -definitions for a wide range of programming languages, markup and -scripting languages and other text file formats. In addition you can -provide your own definitions in simple &XML; files.</para> - -<para>&kate; will automatically detect the right syntax rules when you -open a file, based on the &MIME; Type of the file, determined by its -extension, or, if it has none, the contents. Should you experience a -bad choice, you can manually set the syntax to use from the -<menuchoice><guimenu>Documents</guimenu><guisubmenu>Highlight -Mode</guisubmenu></menuchoice> menu.</para> - -<para>The styles and colors used by each syntax highlight definition, -as well as which &MIME;types it should be used for, can be configured -using the <link linkend="config-dialog-editor-hl"> Highlight</link> -page of the <link linkend="config-dialog">Config Dialog</link>.</para> - -<note> -<para>Syntax highlighting is there to enhance the readability of -correct text, but you cannot trust it to validate your text. Marking -text for syntax is difficult depending on the format you are using, -and in some cases the authors of the syntax rules will be proud if 98% -of text gets correctly rendered, though most often you need a rare -style to see the incorrect 2%.</para> -</note> - -<tip> -<para>You can download updated or additional syntax highlight -definitions from the &kate; website by clicking the -<guibutton>Download</guibutton> button in the <link -linkend="config-dialog-editor-hl">Highlight Page</link> of the <link -linkend="config-dialog">Config Dialog</link>.</para> -</tip> - -</sect1> - -<sect1 id="katehighlight-system"> - -<title>The &kate; Syntax Highlight System</title> - -<para>This section will discuss the &kate; syntax highlighting -mechanism in more detail. It is for you if you want to know know about -it, or if you want to change or create syntax definitions.</para> - -<sect2 id="katehighlight-howitworks"> - -<title>How it Works</title> - -<para>Whenever you open a file, one of the first things the &kate; -editor does is detect which syntax definition to use for the -file. While reading the text of the file, and while you type away in -it, the syntax highlighting system will analyze the text using the -rules defined by the syntax definition and mark in it where different -contexts and styles begin and end.</para> - -<para>When you type in the document, the new text is analyzed and marked on the -fly, so that if you delete a character that is marked as the beginning or end -of a context, the style of surrounding text changes accordingly.</para> - -<para>The syntax definitions used by the &kate; syntax highlighting system are -&XML; files, containing -<itemizedlist> -<listitem><para>Rules for detecting the role of text, organized into context blocks</para></listitem> -<listitem><para>Keyword lists</para></listitem> -<listitem><para>Style Item definitions</para></listitem> -</itemizedlist> -</para> - -<para>When analyzing the text, the detection rules are evaluated in -the order in which they are defined, and if the beginning of the -current string matches a rule, the related context is used. The start -point in the text is moved to the final point at which that rule -matched and a new loop of the rules begins, starting in the context -set by the matched rule.</para> - -</sect2> - -<sect2 id="highlight-system-rules"> -<title>Rules</title> - -<para>The detection rules are the heart of the highlighting detection -system. A rule is a string, character or <link -linkend="regular-expressions">regular expression</link> against which -to match the text being analyzed. It contains information about which -style to use for the matching part of the text. It may switch the -working context of the system either to an explicitly mentioned -context or to the previous context used by the text.</para> - -<para>Rules are organized in context groups. A context group is used -for main text concepts within the format, for example quoted text -strings or comment blocks in program source code. This ensures that -the highlighting system does not need to loop through all rules when -it is not necessary, and that some character sequences in the text can -be treated differently depending on the current context. -</para> - -</sect2> - -<sect2 id="highlight-context-styles-keywords"> -<title>Context Styles and Keywords</title> - -<para>In some programming languages, integer numbers are treated -differently than floating point ones by the compiler (the program that -converts the source code to a binary executable), and there may be -characters having a special meaning within a quoted string. In such -cases, it makes sense to render them differently from the surroundings -so that they are easy to identify while reading the text. So even if -they do not represent special contexts, they may be seen as such by -the syntax highlighting system, so that they can be marked for -different rendering.</para> - -<para>A syntax definition may contain as many styles as required to -cover the concepts of the format it is used for.</para> - -<para>In many formats, there are lists of words that represent a -specific concept. For example in programming languages, the control -statements is one concept, data type names another, and built in -functions of the language a third. The &kate; Syntax Highlighting -System can use such lists to detect and mark words in the text to -emphasize concepts of the text formats.</para> - -</sect2> - -<sect2 id="kate-highlight-system-default-styles"> -<title>Default Styles</title> - -<para>If you open a C++ source file, a &Java; source file and an -<acronym>HTML</acronym> document in &kate;, you will see that even -though the formats are different, and thus different words are chosen -for special treatment, the colors used are the same. This is because -&kate; has a predefined list of Default Styles, that are employed by -the individual syntax definitions.</para> - -<para>This makes it easy to recognize similar concepts in different -text formats. For example comments are present in almost any -programming, scripting or markup language, and when they are rendered -using the same style in all languages, you do not have to stop and -think to identify them within the text.</para> - -<tip> -<para>All styles in a syntax definition use one of the default -styles. A few syntax definitions use more styles that there are -defaults, so if you use a format often, it may be worth launching the -configuration dialog to see if some concepts are using the same -style. For example there is only one default style for strings, but as -the perl programming language operates with two types of strings, you -can enhance the highlighting by configuring those to be slightly -different.</para> -</tip> - -</sect2> - -</sect1> - -<sect1 id="katehighlight-xml-format"> -<title>The Highlight Definition &XML; Format</title> - -<sect2> -<title>Overview</title> - -<para>This section is an overview of the Highlight Definition &XML; -format. It will describe the main components and their meaning and -usage, and go into detail with the detection rules.</para> - -<para>The formal definition, aka the <acronym>DTD</acronym> is stored -in the file <filename>language.dtd</filename> which should be -installed on your system in the directory -<filename>$<envar>KDEDIR</envar>/share/apps/kate/syntax</filename>.</para> - -<variablelist> -<title>Main components of &kate; Highlight Definitions</title> - -<varlistentry> -<term>The General Section</term> -<listitem> -<para>The General Section contains information on the comment format -of the described language, and defines whether keywords are case -sensitive.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>Highlighting</term> -<listitem> -<para>The Highlighting section contains all data required to analyze -and render the text. This includes:</para> - -<variablelist> -<varlistentry> -<term>ItemDatas</term> -<listitem><para>Contains ItemData elements, each defining a -style.</para></listitem> -</varlistentry> - -<varlistentry> -<term>Keyword lists</term> -<listitem> -<para>Each list has a name, and may contain any number of items.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>Contexts</term> -<listitem> -<para>Contains contexts, which again contain the syntax detection rules.</para> -</listitem> -</varlistentry> -</variablelist> - -</listitem> -</varlistentry> - -</variablelist> - -</sect2> - -</sect1> - -<sect1 id="kate-highlight-rules-detailled"> -<title>Highlight Detection Rules</title> - -<para>This section describes the syntax detection rules.</para> - -<para>Each rule can match zero or more characters at the beginning of -the string they are asked to test. If the rule matches, the matching -characters are assigned the style or <emphasis>attribute</emphasis> -defined by the rule, and a rule may ask that the current context is -switched.</para> - -<para>The <emphasis>attribute</emphasis> and -<emphasis>context</emphasis> attributes are common to all -rules.</para> - -<para>A rule looks like this:</para> - -<programlisting><RuleName attribute="(identifier)" context="(identifier|order)" [rule specific attributes] /></programlisting> - -<para>The <emphasis>attribute</emphasis> identifies the style to use -for matched characters by name or index, and the -<emphasis>context</emphasis> identifies the context to use from -here.</para> - -<para>The <emphasis>attribute</emphasis> can be identified either by -name, or by its zero-based index in the ItemDatas group.</para> - -<para>The <emphasis>context</emphasis> can be identified by:</para> - -<itemizedlist> -<listitem> -<para>An <emphasis>identifier</emphasis>, currently only its zero-based -index in the contexts group.</para> -</listitem> -<listitem> -<para>An <emphasis>order</emphasis> telling the engine to stay in the -current context (<userinput>#stay</userinput>), or to pop back to a -previous context used in the string -(<userinput>#pop</userinput>).</para> -<para>To go back more steps, the #pop keyword can be repeated: -<userinput>#pop#pop#pop</userinput></para> -</listitem> -</itemizedlist> - -<para>Some rules can have <emphasis>child rules</emphasis> which are -then evaluated if and only if the parent rule matched. The entire -matched string will be given the attribute defined by the parent -rule. A rule with child rules looks like this:</para> - -<programlisting> -<RuleName (attributes)> - <ChildRuleName (attributes) /> - ... -</RuleName> -</programlisting> - - -<para>Rule specific attributes varies and are described in the -following list.</para> - -<variablelist> -<title>The Rules in Detail</title> - -<varlistentry> -<term>DetectChar</term> -<listitem> -<para>Detect a single specific character. Commonly used for example to -find the ends of quoted strings.</para> -<programlisting><DetectChar char="(character)" (common attributes) /></programlisting> -<para>The <userinput>char</userinput> attribute defines the character -to match.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>Detect2Chars</term> -<listitem> -<para>Detect two specific characters in a defined order.</para> -<programlisting><Detect2Chars char="(character)" char1="(character)" (common attributes) /></programlisting> -<para>The <userinput>char</userinput> attribute defines the first character to match, -<userinput>char1</userinput> the second.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>AnyChar</term> -<listitem> -<para>Detect one character of a set of specified characters.</para> -<programlisting><AnyChar String="(string)" (common attributes) /></programlisting> -<para>The <userinput>String</userinput> attribute defines the set of -characters.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>StringDetect</term> -<listitem> -<para>Detect an exact string.</para> -<programlisting><StringDetect String="(string)" [insensitive="TRUE|FALSE;"] (common attributes) /></programlisting> -<para>The <userinput>String</userinput> attribute defines the string -to match. The <userinput>insensitive</userinput> attribute defaults to -<userinput>FALSE</userinput> and is fed to the string comparison -function. If the value is <userinput>TRUE</userinput> insensitive -comparing is used.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>RegExpr</term> -<listitem> -<para>Matches against a regular expression.</para> -<programlisting><RegExpr String="(string)" [insensitive="TRUE|FALSE;"] [minimal="TRUE|FALSE"] (common attributes) /></programlisting> -<para>The <userinput>String</userinput> attribute defines the regular -expression.</para> -<para><userinput>insensitive</userinput> defaults to -<userinput>FALSE</userinput> and is fed to the regular expression -engine.</para> -<para><userinput>minimal</userinput> defaults to -<userinput>FALSE</userinput> and is fed to the regular expression -engine.</para> -<para>Because the rules are always matched against the beginning of -the current string, a regular expression starting with a caret -(<literal>^</literal>) indicates that the rule should only be -matched against the start of a line.</para> -<para>See <link linkend="regular-expressions">Regular -Expressions</link> for more information on those.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>Keyword</term> -<listitem> -<para>Detect a keyword from a specified list.</para> -<programlisting><keyword String="(list name)" (common attributes) /></programlisting> -<para>The <userinput>String</userinput> attribute identifies the -keyword list by name. A list with that name must exist.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>Int</term> -<listitem> -<para>Detect an integer number.</para> -<para><programlisting><Int (common attributes) /></programlisting></para> -<para>This rule has no specific attributes. Child rules are typically -used to detect combinations of <userinput>L</userinput> and -<userinput>U</userinput> after the number, indicating the integer type -in program code.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>Float</term> -<listitem> -<para>Detect a floating point number.</para> -<para><programlisting><Float (common attributes) -/></programlisting></para> -<para>This rule has no specific attributes.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>HlCOct</term> -<listitem> -<para>Detect an octal point number representation.</para> -<para><programlisting><HlCOct (common attributes) /></programlisting></para> -<para>This rule has no specific attributes.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>HlCHex</term> -<listitem> -<para>Detect a hexadecimal number representation.</para> -<para><programlisting><Int (common attributes) /></programlisting></para> -<para>This rule has no specific attributes.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>HlCStringChar</term> -<listitem> -<para>Detect an escaped character.</para> -<para><programlisting><HlCStringChar (common attributes) -/></programlisting></para> -<para>This rule has no specific attributes.</para> - -<para>It matches letteral representations of invisible characters -commonly used in program code, for example <userinput>\n</userinput> -(newline) or <userinput>\t</userinput> (TAB).</para> - -<para>The following characters will match if they follow a backslash -(<literal>\</literal>): -<userinput>abefnrtv"'?</userinput>. Additionally, escaped -hexadecimal numbers like for example <userinput>\xff</userinput> and -escaped octal numbers, for example <userinput>\033</userinput> will -match.</para> - -</listitem> -</varlistentry> - -<varlistentry> -<term>RangeDetect</term> -<listitem> -<para>Detect a string with defined start and end characters.</para> -<programlisting><RangeDetect char="(character)" char1="(character)" (common attributes) /></programlisting> -<para><userinput>char</userinput> defines the character starting the range, -<userinput>char2</userinput> the character ending the range.</para> -<para>Usefull to detect for example small quoted strings and the like, but note that -since the hl engine works on one line at a time, this will not find strings spanning over a line break.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>LineContinue</term> -<listitem> -<para>Matches at end of line.</para> -<programlisting><LineContinue (common attributes) /></programlisting> -<para>This rule has no specific attributes.</para> -<para>This rule is usefull for switching context at end of line.</para> -</listitem> -</varlistentry> - -</variablelist> - -</sect1> - -</appendix> diff --git a/tde-i18n-nl/docs/kdebase/kate/index.cache.bz2 b/tde-i18n-nl/docs/kdebase/kate/index.cache.bz2 Binary files differdeleted file mode 100644 index bb4452024a9..00000000000 --- a/tde-i18n-nl/docs/kdebase/kate/index.cache.bz2 +++ /dev/null diff --git a/tde-i18n-nl/docs/kdebase/kate/index.docbook b/tde-i18n-nl/docs/kdebase/kate/index.docbook deleted file mode 100644 index 9b1b18eef90..00000000000 --- a/tde-i18n-nl/docs/kdebase/kate/index.docbook +++ /dev/null @@ -1,450 +0,0 @@ -<?xml version="1.0" ?> -<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" -"dtd/kdex.dtd" [ - <!ENTITY kappname "&kate;"> - <!ENTITY package "tdebase"> - <!ENTITY configuring-chapter SYSTEM "configuring.docbook"> - <!ENTITY highlighting-appendix SYSTEM "highlighting.docbook"> - <!ENTITY advanced-chapter SYSTEM "advanced.docbook"> - <!ENTITY fundamentals-chapter SYSTEM "fundamentals.docbook"> - <!ENTITY mdi-chapter SYSTEM "mdi.docbook"> - <!ENTITY menu-chapter SYSTEM "menus.docbook"> - <!ENTITY part-chapter SYSTEM "part.docbook"> - <!ENTITY plugins-chapter SYSTEM "plugins.docbook"> - <!ENTITY regexp-appendix SYSTEM "regular-expressions.docbook"> - <!ENTITY % addindex "IGNORE"> - <!ENTITY % Dutch "INCLUDE" -><!-- change language only here --> -]> - -<book lang="&language;"> -<title ->Het handboek van &kate;</title> - -<bookinfo> -<authorgroup> -<author ->&Anders.Lund; &Anders.Lund.mail;</author> -<author ->&Seth.Rothberg; &Seth.Rothberg.mail;</author> -<author ->&Dominik.Haumann; &Dominik.Haumann.mail;</author> -&Otto.Bruggeman;&Rinse.Devries;&Tom.Albers;&Natalie.Koning; -</authorgroup> - -<copyright> -<year ->2000</year> -<year ->2001</year> -<holder ->&Seth.Rothberg;</holder> -</copyright> -<copyright> -<year ->2002</year -><year ->2003</year -><year ->2005</year> -<holder ->&Anders.Lund;</holder> -</copyright> -<copyright> -<year ->2005</year> -<holder ->&Dominik.Haumann;</holder> -</copyright> - -<legalnotice ->&FDLNotice;</legalnotice> - -<date ->2005-12-29</date> -<releaseinfo ->2.5.0</releaseinfo> - -<abstract> -<para ->&kate; is een editor voor programmeurs voor &kde; 2.2 en hoger.</para> - -<para ->Deze handleiding beschrijft &kate; versie 2.5.0</para> -</abstract> - -<keywordset> -<keyword ->KDE</keyword> -<keyword ->tdebase</keyword> -<keyword ->Kate</keyword> -<keyword ->tekst</keyword> -<keyword ->editor</keyword> -<keyword ->programmeur</keyword> -<keyword ->programmeren</keyword> -<keyword ->projecten</keyword> -<keyword ->MDI</keyword> -<keyword ->Multi</keyword> -<keyword ->Document</keyword> -<keyword ->Interface</keyword> -<keyword ->terminal</keyword> -<keyword ->console</keyword> -</keywordset> - -</bookinfo> - -<chapter id="introduction"> -<title ->Inleiding</title> - -<para ->Welkom bij &kate;, een editor voor programmeurs voor &kde; versie 2.2 en hoger. Enkele van &kate;'s vele mogelijkheden zijn de in te stellensyntaxis-accentuering voor (programmeer)talen van C en C++ tot <acronym ->HTML</acronym -> en bash-scripts, de mogelijkheid om projecten te maken en te onderhouden, een interface voor meerdere documenten (<acronym ->MDI</acronym ->) en een ingebouwde terminal. </para> - -<para ->&kate; is echter meer dan een editor voor programmeurs. De mogelijkheid om meerdere bestanden tegelijkertijd te openen maakt Kate ideaal om de vele configuratiebestanden van &UNIX; aan te passen. Dit document werd geschreven in &kate;. </para> - -<para> -<mediaobject> -<imageobject -><imagedata format="PNG" fileref="kate.png"/></imageobject> -<caption -><para ->Het bewerken van deze handleiding...</para -></caption> -</mediaobject> -</para> - -</chapter> - -&fundamentals-chapter; - -&mdi-chapter; - -&part-chapter; - -&plugins-chapter; - -&advanced-chapter; - -&menu-chapter; - -&configuring-chapter; - -<chapter id="credits"> - -<title ->Dankbetuigingen en licentie</title> - -<para ->&kate;. Programma copyright 2000, 2001, 2002 - 2005 het &kate;-ontwikkelingsteam. </para> - -<variablelist> -<title ->Het &kate;-team:</title> -<varlistentry> -<term ->&Christoph.Cullmann; &Christoph.Cullmann.mail;</term> -<listitem -><para ->Projectbeheerder & kernontwikkelaar</para -></listitem> -</varlistentry> -<varlistentry> -<term ->&Anders.Lund; &Anders.Lund.mail;</term> -<listitem -><para ->Kernontwikkelaar, Perl syntaxis-accentuering, documentatie</para -></listitem> -</varlistentry> -<varlistentry> -<term ->&Joseph.Wenninger; &Joseph.Wenninger.mail;</term> -<listitem -><para ->Kernontwikkelaar, syntaxis-accentuering</para -></listitem> -</varlistentry> -<varlistentry> -<term ->Michael Bartl <email ->michael.bartl1@chello.at</email -></term> -<listitem -><para ->Kernontwikkelaar</para -></listitem> -</varlistentry> -<varlistentry> -<term ->Phlip <email ->phlip_cpp@my-deja.com</email -></term> -<listitem -><para ->De project-compiler</para -></listitem> -</varlistentry> -<varlistentry> -<term ->&Waldo.Bastian; &Waldo.Bastian.mail;</term> -<listitem -><para ->Het schitterende buffersysteem</para -></listitem> -</varlistentry> -<varlistentry> -<term ->Matt Newell <email ->newellm@proaxis.com</email -></term> -<listitem -><para ->Tests...</para -></listitem> -</varlistentry> -<varlistentry> -<term ->Michael McCallum <email ->gholam@xtra.co.nz</email -></term> -<listitem -><para ->Kernontwikkelaar</para -></listitem> -</varlistentry> -<varlistentry> -<term ->Jochen Wilhemly <email ->digisnap@cs.tu-berlin.de</email -></term> -<listitem -><para ->Auteur van KWrite</para -></listitem> -</varlistentry> -<varlistentry> -<term ->&Michael.Koch; &Michael.Koch.mail;</term> -<listitem -><para ->Omzetting van KWrite voor KParts</para -></listitem> -</varlistentry> -<varlistentry> -<term ->Christian Gebauer <email ->gebauer@bigfoot.com</email -></term> -<listitem -><para ->Niet opgegeven</para -></listitem> -</varlistentry> -<varlistentry> -<term ->&Simon.Hausmann; &Simon.Hausmann.mail;</term> -<listitem -><para ->Niet opgegeven</para -></listitem> -</varlistentry> -<varlistentry> -<term ->Glen Parker <email ->glenebob@nwlink.com</email -></term> -<listitem -><para ->Ongedaan-maken-geschiedenis van KWrite, integratie van KSpell</para -></listitem> -</varlistentry> -<varlistentry> -<term ->Scott Manson <email ->sdmanson@alltel.net</email -></term> -<listitem -><para ->XML-syntaxisaccentuering in KWrite</para -></listitem> -</varlistentry> -<varlistentry> -<term ->&John.Firebaugh; &John.Firebaugh.mail;</term> -<listitem -><para ->Verscheidene patches</para -></listitem> -</varlistentry> -<varlistentry> -<term ->&Dominik.Haumann; &Dominik.Haumann.mail;</term> -<listitem -><para ->Ontwikkelaar, syntaxis-accentuering</para -></listitem> -</varlistentry> -</variablelist> - -<variablelist> -<title ->Vele anderen hebben bijgedragen:</title> -<varlistentry> -<term ->Matteo Merli <email ->merlim@libero.it</email -></term> -<listitem -><para ->Syntaxis-accentuering voor RPM Spec-bestanden, Diff en meer</para -></listitem> -</varlistentry> -<varlistentry> -<term ->Rocky Scaletta <email ->rocky@purdue.edu</email -></term> -<listitem -><para ->Syntaxis-accentuering voor VHDL</para -></listitem> -</varlistentry> -<varlistentry> -<term ->Yury Lebedev </term> -<listitem -><para ->Syntaxis-accentuering voor SQL</para -></listitem> -</varlistentry> -<varlistentry> -<term ->Chris Ross</term> -<listitem -><para ->Syntaxis-accentuering voor Ferite</para -></listitem> -</varlistentry> -<varlistentry> -<term ->Nick Roux</term> -<listitem -><para ->Syntaxis-accentuering voor ILERPG</para -></listitem> -</varlistentry> -<varlistentry> -<term ->John Firebaugh</term> -<listitem -><para ->Syntaxis-accentuering voor Java en nog veel meer</para -></listitem> -</varlistentry> -<varlistentry> -<term ->Carsten Niehaus</term> -<listitem -><para ->Syntaxis-accentuering voor LaTeX</para -></listitem> -</varlistentry> -<varlistentry> -<term ->Per Wigren</term> -<listitem -><para ->Syntaxis-accentuering voor Make-bestanden, Python</para -></listitem> -</varlistentry> -<varlistentry> -<term ->Jan Fritz</term> -<listitem -><para ->Syntaxis-accentuering voor Python</para -></listitem> -</varlistentry> -<varlistentry> -<term ->&Daniel.Naber;</term> -<listitem -><para ->Kleine bugfixes, XML-plugin</para -></listitem> -</varlistentry> -</variablelist> - -<para ->Documentatie copyright 2000,2001 &Seth.Rothberg; &Seth.Rothberg.mail;</para> - -<para ->Documentatie copyright 2002, 2003, 2005 &Anders.Lund; &Anders.Lund.mail;</para> - -&meld.fouten;&vertaling.niels;&vertaling.tom;&vertaling.rinse;&nagelezen.rinse;&nagelezen.natalie; -&underFDL; &underGPL; </chapter> - -&highlighting-appendix; - -®exp-appendix; - -<appendix id="installation"> -<title ->Installatie</title> - -&install.intro.documentation; - -&install.compile.documentation; - -</appendix> - -&documentation.index; - -<!-- -Index Word List: -menu - context - syntax - markup - shortcuts - highlighting -embedded terminal - editing - search - replace - regexp -> Regular Expression -split window - selection - insert overwrite - selection - -configure/customize/preferences - insert/overwrite - non-printing characters -font - unicode - wordwrap/linewrap - project - bookmarks - docks - plugins -block selection / rectangles - view - indenting - editor - word processor -copy - paste - find - spelling - language (both kinds) - encoding - -pretty printing - formatting - line numbers - icon border - -folding - insert time - sed - -done -comment / uncomment -configure / settings / preferences - ---> - -</book> - -<!-- -Local Variables: -mode: sgml -sgml-namecase-general: t -sgml-namecase-entity: nil -sgml-general-insert-case: lower -sgml-minimize-attributes: nil -sgml-omittag: nil -End: ---> diff --git a/tde-i18n-nl/docs/kdebase/kate/kate.png b/tde-i18n-nl/docs/kdebase/kate/kate.png Binary files differdeleted file mode 100644 index 5c92d1bc0ce..00000000000 --- a/tde-i18n-nl/docs/kdebase/kate/kate.png +++ /dev/null diff --git a/tde-i18n-nl/docs/kdebase/kate/man-kate.1.docbook b/tde-i18n-nl/docs/kdebase/kate/man-kate.1.docbook deleted file mode 100644 index a98c7c5d6bc..00000000000 --- a/tde-i18n-nl/docs/kdebase/kate/man-kate.1.docbook +++ /dev/null @@ -1,294 +0,0 @@ -<?xml version="1.0" ?> -<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ -<!ENTITY % Dutch "INCLUDE"> -]> - -<refentry lang="&language;"> -<refentryinfo> -<title ->Gebruikershandboek van KDE</title> -<author ->&Lauri.Watts; &Lauri.Watts.mail;</author> -<date ->07 juni 2005</date -> <productname ->K Desktop Environment</productname -> </refentryinfo> - -<refmeta> -<refentrytitle -><command ->kate</command -></refentrytitle> -<manvolnum ->1</manvolnum> -</refmeta> - -<refnamediv> -<refname -><command ->kate</command -></refname> -<refpurpose ->Geavanceerde teksteditor voor &kde;</refpurpose> -</refnamediv> - -<refsynopsisdiv> -<cmdsynopsis -><command ->kate</command -> <group choice="opt" -><option ->-s, --start</option -> <replaceable -> naam</replaceable -> </group -> <group choice="opt" -><option ->-u, --use</option -></group -> <group choice="opt" -><option ->-p, --pid</option -><replaceable -> pid</replaceable -></group -> <group choice="opt" -><option ->-e, --encoding</option -> <replaceable -> naam</replaceable -></group -> <group choice="opt" -><option ->-l, --line</option -> <replaceable -> regel</replaceable -></group -> <group choice="opt" -><option ->-c, --column</option -> <replaceable -> kolom</replaceable -></group -> <group choice="opt" -><option ->-i, --stdin</option -></group -> <arg choice="opt" ->KDE-generieke opties</arg -> <arg choice="opt" ->Qt-generieke opties </arg -> </cmdsynopsis> -</refsynopsisdiv> - -<refsect1> -<title ->Beschrijving</title> -<para ->&kate; is de &kde; Advanced Text Editor. </para -> -<para ->&kate; levert ook het tekstinvoergedeelte voor veel andere toepassingen, waaronder &kwrite;.</para> -<para ->Enkele van &kate;'s vele functies zijn instelbare syntaxis-accentuering voor talen variërend van C en C++ tot <acronym ->HTML</acronym -> en bash-scripts; de mogelijkheid om projecten aan te maken en te beheren, multi-document-interface (<acronym ->MDI</acronym ->) en een ingesloten terminal. </para> - -<para ->&kate; is echter meer dan een editor voor programmeurs. De mogelijkheid om meerdere bestanden tegelijkertijd te openen maakt Kate ideaal om de vele configuratiebestanden van &UNIX; aan te passen. Dit document werd geschreven in &kate;. </para> - - -</refsect1> - -<refsect1> -<title ->Opties</title> - -<variablelist> -<varlistentry> -<term -><option ->-s</option ->, <option ->--start</option -> <replaceable ->naam</replaceable -></term> - -<listitem -><para ->Start &kate; met een opgegeven sessie.</para -></listitem> -</varlistentry> -<varlistentry> -<term -><option ->-u, --use</option -></term> -<listitem -><para ->Gebruikt een al draaiend &kate;-exemplaar.</para -></listitem> -</varlistentry> -<varlistentry> -<term -><option ->-p, --pid</option -> <replaceable -> pid</replaceable -></term> -<listitem -><para ->Probeer alleen het kate-exemplaar met dit <replaceable ->pid</replaceable -> te hergebruiken.</para -></listitem> -</varlistentry> -<varlistentry> -<term -><option ->-e, --encoding</option -> <replaceable -> naam</replaceable -></term> -<listitem -><para ->Codering zetten voor het te openen bestand</para -><para ->U kunt dit gebruiken om bijv. een bestand te openen in utf8-codering. Het commando <command ->iconv -l</command -> levert een lijst met beschikbare tekensetcoderingen.</para -></listitem> -</varlistentry> -<varlistentry> -<term -><option ->-l, --line</option -> <replaceable -> regel</replaceable -></term> -<listitem -><para ->Ga naar deze regel</para -></listitem> -</varlistentry> -<varlistentry> -<term -><option ->-c, --column</option -> <replaceable -> kolom</replaceable -></term> -<listitem -><para ->Ga naar deze kolom</para -></listitem> -</varlistentry> -<varlistentry> -<term -><option ->-i, --stdin</option -></term> -<listitem -><para ->Lees de inhoud van <filename ->stdin</filename -></para -></listitem> -</varlistentry> -</variablelist> - -</refsect1> - -<refsect1> -<title ->Zie ook</title> - -<para ->kwrite(1)</para> - -<para ->Meer gedetailleerde documentatie is beschikbaar in <ulink url="help:/kate" ->help:/kate</ulink ->. Voer dit <acronym ->URL</acronym ->-adres in in &konqueror; of start <userinput -><command ->khelpcenter</command -> <parameter ->help:/kate</parameter -></userinput ->).</para> - -<para ->Er is ook meer informatie beschikbaar op de <ulink url="http://kate.kde.org/" ->website van &kate;</ulink ->.</para> -</refsect1> - -<refsect1> -<title ->Voorbeelden</title> - -<para ->Om een bestand genaamd <filename ->source.cpp</filename -> te openen op kolom 15, regel 25 in een bestaand &kate;-venster kunt u dit commando gebruiken:</para> -<screen -><userinput -><command ->kate</command -> <option ->-c 15</option -> <option ->-l -25</option -> <option ->-u</option -> <filename ->source.cpp</filename -></userinput -> </screen> - -<para ->Als u met internet verbonden bent, dan kunt u gebruik maken van &kde;'s netwerktransparantie om een bestand vanaf een ftp-site te openen. Als u geen schrijftoegang hebt tot de server op afstand, dan zal het bestand worden geopend als alleen-lezen en zult u worden gevraagd om een lokale bestandsnaam om uw wijzigingen in op te slaan. Als u schrijftoegang hebt, dan zullen de wijzigingen geheel transparant worden opgeslagen op de ftp-server.</para> -<screen -><userinput -><command ->kate</command -> <option -><replaceable ->ftp://ftp.kde.org/pub/kde/README_FIRST</replaceable -></option -></userinput -></screen> - -<!-- FIXME: Some more useful examples would be cool, how about this snagged --> -<!-- from a mail of anders (slightly edited /line/l to remove the double --> -<!-- dashes: -> /some/file/path/file.name:lineno - -> it would rock if Kate could understand that and not only open up file.name, - -> but jump to lineno after the file is opened. - -How bad is it to have to convert that into --l lineno /some/file/path/file.name - -sed s,([^:]*):(\d+),-l \2 \1, - -will do that, for example.--> - -</refsect1> - -<refsect1> -<title ->Auteurs</title> -<para ->De onderhouder van &kate; is &Christoph.Cullmann; &Christoph.Cullmann.mail;. Een uitgebreide lijst van auteurs en anderen die hebben bijgedragen is te vinden in de gebruikersgids die hierboven werd genoemd.</para> -</refsect1> - -</refentry> diff --git a/tde-i18n-nl/docs/kdebase/kate/mdi.docbook b/tde-i18n-nl/docs/kdebase/kate/mdi.docbook deleted file mode 100644 index 35d9e817197..00000000000 --- a/tde-i18n-nl/docs/kdebase/kate/mdi.docbook +++ /dev/null @@ -1,212 +0,0 @@ -<chapter id="kate-mdi"> - -<title>Working With the &kate; <acronym>MDI</acronym></title> - -<sect1 id="kate-mdi-overview"> -<title>Overview</title> - -<para>Window, View, Document, Frame, Editor... What are they all in -the terminology of &kate;, and how do you get the most out of it? This -chapter will explain all of that, and even more.</para> - -<sect2 id="kate-mdi-overview-mainwindow"> - -<title>The Main Window</title> - -<para>The &kate; Main Window is a standard &kde; application window, -with the addition of dockable subwindows, or tool windows. It has a -Menubar with all the common menus, and some more, and a toolbar -providing access to commonly used commands.</para> - -<para>The most important part of the window is the Editing Area, by -default displaying a single text editor component, in which you can -work with your documents.</para> - -<para>The docking capabilities of the window is used for the tool -windows:</para> - -<itemizedlist> -<listitem><para><link linkend="kate-mdi-tools-file-list">The File List</link></para></listitem> -<listitem><para><link linkend="kate-mdi-tools-file-selector">The File Selector</link></para></listitem> -<listitem><para><link linkend="kate-mdi-tools-konsole">The Built in Terminal Emulator</link></para></listitem> -</itemizedlist> - -<para>And possibly other tool windows, for example provided by -plugins.</para> - -<para>The Tool Windows can be placed anywhere you want them inside or -outside the main window by dragging the handle bar in the top of them -with the &LMB; pressed, and stacked in shared tab windows if -desired.</para> - -<para>When dragging a docked window, a black rectangle will be -displayed to indicate where the window will be placed if you release -the mouse button, unless you move the mouse cursor outside the main -window, in which case the dragged window will become a free floating -top level window.</para> - -</sect2> - - -</sect1> - -<sect1 id="kate-mdi-editor"> - -<title>The Editor area</title> - -<para>&kate; is capable of having more than one document open at the -same time, and also of splitting the editing area into any number of -frames, similar to how for example &konqueror; or the popular -<application>emacs</application> text editor works. This way you can -view several documents at the same time, or more instances of the same -document, handy for example if your document contains definitions in -the top that you want to see often for reference. Or you could view a -program source header in one frame, while editing the implementation -file in another.</para> - -<para>When a document is available in more than one editor, changes -made in one editor will immediately be reflected in the others as -well. This includes changing the text as well as selecting -text. Search operations or cursor movement is only reflected in the -current editor.</para> - -<para>It is currently not possible to have more instances of the same -document open in the sense that one instance will be edited while the -other will not.</para> - -<para>When splitting an editor into two frames, it is divided into two -equally sized frames, both displaying the current document of that -editor. The new frame will be at the bottom (in the case of a -horizontal split) or at the right (for a vertical split). The new -frame gets the focus, which is visualized by a small green led in the -focused frame.</para> - -</sect1> - -<sect1 id="kate-mdi-tools-file-list"> -<title>The File List</title> - -<para>The file list displays a list of all documents currently open in -&kate;. Modified files will have a small <guiicon>floppy -disk</guiicon> icon on their left to indicate that state.</para> - -<para>If two or more files with the same name (located in different -directories) are open, the names of the second will be prepended -<quote><2></quote> and so on. The tool-tip for the file will -display its full name including the path, allowing you to choose the -desired one.</para> <para>To display a document in the currently -active frame, click the document name in the list.</para> - -<para>The default location in the &kate; window is to the left of the -editing area, in a dockable tab window shared with the <link -linkend="kate-mdi-tools-file-selector">File Selector</link>.</para> -</sect1> - -<sect1 id="kate-mdi-tools-file-selector"> -<title>The File Selector</title> - -<para>The File Selector is a directory viewer, allowing you to open -files from a displayed directory in the current frame.</para> - -<para>From top down, the file selector consist of the following -elements:</para> - -<variablelist> -<varlistentry> -<term>A Toolbar</term> -<listitem> -<para>This contains standard navigations tool buttons:</para> -<variablelist> -<varlistentry> -<term><guibutton>Home</guibutton></term> -<listitem><para>Pressing it will cause the directory view to <command>cd</command> to your home directory.</para></listitem> -</varlistentry> -<varlistentry> -<term><guibutton>Up</guibutton></term> -<listitem><para>This will cause the directory view to <command>cd</command> to the immediate parent of the currently displayed -directory if possible.</para></listitem> -</varlistentry> -<varlistentry> -<term><guibutton>Back</guibutton></term> -<listitem><para>Causes the directory view to <command>cd</command> to the previously displayed directory in the history. -This button is disabled, if there is no previous item.</para></listitem> -</varlistentry> -<varlistentry> -<term><guibutton>Forward</guibutton></term> -<listitem><para>Causes the directory view to <command>cd</command> to the next directory in the history. -This button is disabled, if there is no next directory.</para></listitem> -</varlistentry> -<varlistentry> -<term><guibutton>Sync</guibutton></term> -<listitem><para>This button will cause the directory view to -<command>cd</command> to the directory of the currently active -document if possible. This button is disabled, if the active document -is a new, unsaved file, or the directory in which it resides can not -be decided.</para></listitem> -</varlistentry> -</variablelist> - -</listitem> -</varlistentry> - -<varlistentry> -<term>A &URL; entry</term> -<listitem> -<para>Here you can type the path of a directory to browse. The URL -entry is maintaining a list of previously typed paths, to choose one -use the arrow button on the right of the entry.</para> -<tip><para>The &URL; entry has directory auto-completion, the completion -method can be set using the &RMB; menu of the text -entry.</para></tip> -</listitem> -</varlistentry> - -<varlistentry> -<term>A Directory View</term> -<listitem><para>This is a standard &kde; directory view.</para></listitem> -</varlistentry> - -<varlistentry> -<term>A Filter Entry</term> -<listitem> -<para>The Filter entry allows you to enter a filter for the files -displayed in the directory view. The filter is using standard globs, -patterns must be separated by whitespace. Example: <userinput>*.cpp -*.h *.moc</userinput></para> -<para>To display all files, enter a single asterisk -<userinput>*</userinput>.</para> -<para>The filter entry saves the last 10 filters entered between -sessions, to use one, press the arrow button on the right of the entry -and select the desired filter string.</para> -</listitem> -</varlistentry> - -</variablelist> - -</sect1> - - -<sect1 id="kate-mdi-tools-konsole"> -<title>The Built in Terminal Emulator</title> - -<para>The built in Terminal Emulator is a copy of the &kde; &konsole; -terminal application, for your convenience. It is available from the -<menuchoice><guimenu>Settings</guimenu><guimenuitem>Show Terminal -Emulator</guimenuitem></menuchoice> menu item or the<keycombo -action="simul"><keycap>F7</keycap></keycombo>, and will get the focus -whenever displayed. Additionally, if the <link -linkend="config-dialog-general-sync-konsole">Sync &konsole; with -active document</link> option is enabled, it will -<command>cd</command> into the directory of the current document if -possible when it is displayed, or when the current document -changes.</para> - -<para>The default location in the &kate; window is at the bottom, -below the editing area.</para> - -<para>You can configure the &konsole; using it's &RMB; menu, for more -information, see the &konsole; manual.</para> - -</sect1> - -</chapter> diff --git a/tde-i18n-nl/docs/kdebase/kate/menus.docbook b/tde-i18n-nl/docs/kdebase/kate/menus.docbook deleted file mode 100644 index 569c834fe48..00000000000 --- a/tde-i18n-nl/docs/kdebase/kate/menus.docbook +++ /dev/null @@ -1,1092 +0,0 @@ -<chapter id="menu-entries"> -<title>Menu Entries</title> - -<sect1 id="file-menu"> -<title>The <guimenu>File</guimenu> Menu</title> - -<variablelist> -<varlistentry> -<term> -<anchor id="new"/> -<menuchoice> -<shortcut> -<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo> -</shortcut> -<guimenu>File</guimenu> -<guimenuitem>New</guimenuitem> -</menuchoice> -</term> -<listitem> -<para> -This command <action>starts a new document</action> in the editing -window. In the <guibutton>Filelist</guibutton> on the left the new file -is named <emphasis>Untitled</emphasis>. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="open"/> -<menuchoice> -<shortcut> -<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo> -</shortcut> -<guimenu>File</guimenu> -<guimenuitem>Open</guimenuitem> -</menuchoice> -</term> -<listitem> -<para> -This command does not <action>open a file</action>. It -launches &kde;'s open file dialog box which waits for you -to select the files you want to open. -</para> - -<para> -<!-- TODO: sorry, isn't this *way* to detailed??? (dnaber) --> -The open file dialog box works like a simple version of &konqueror;. Use -your &LMB; to click on a file name to select it. Double-click on a file -name to open that file. Once you've selected a file name, you can also -press the <guibutton>OK</guibutton> button to open the -file. -</para> -<tip> -<para> -Select multiple files by holding down the &Ctrl; or the -&Shift; key along with the &LMB;. -<keycombo action="simul"> -&Ctrl;<mousebutton>Left</mousebutton> -</keycombo> -click selects one file at a time. -<keycombo action="simul"> -&Shift;<mousebutton>Left</mousebutton> -</keycombo> -click selects a contiguous set of files. -</para> -</tip> - -<para> -Clicking on a directory name in the file selection window -opens that directory and displays its contents. -Clicking on a file name shows a thumbnail view of the file in the -preview window to the right of the file system window. -</para> - -<para> -Use the buttons and combo box on the toolbar above the file selection -window to move through the file system or to adjust the properties of -the open file dialog box. -</para> - -<para> -Below the file selection window is the Location -combo box. Type the name of the file you want to edit -here. If you click the arrow on the right of the drop down -box, you can choose from recently used files. Open several -files at once by quoting each file name. -</para> - -<para> -Below the Location combo box is the Filter combo box. Enter file masks -here to filter the kinds of files shown in the selection window. For -example, typing the filter <literal role="extension">*.txt</literal> and -pressing <keycap>Enter</keycap> will limit the display to files with a -<literal role="extension">.txt</literal> extension. The Filter combo -contains a list of your most recently used filters. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="open-recent"/> -<menuchoice> -<guimenu>File</guimenu> -<guimenuitem>Open Recent</guimenuitem> -</menuchoice> -</term> -<listitem> -<para> -This command allows you to <action>open a file</action> from a submenu -that contains a list of recently edited files. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="save"/> -<menuchoice> -<shortcut> -<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo> -</shortcut> -<guimenu>File</guimenu> -<guimenuitem>Save</guimenuitem> -</menuchoice> -</term> -<listitem> -<para> -This command <action>saves your file</action>. Use it often. If the file is -<emphasis>Untitled</emphasis> then -<guimenuitem>Save</guimenuitem> becomes -<guimenuitem>Save As</guimenuitem>. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="save-as"/> -<menuchoice> -<guimenu>File</guimenu> -<guimenuitem>Save As</guimenuitem> -</menuchoice> -</term> -<listitem> -<para> -<action>Name and rename files</action> with this command. -It launches the save file dialog box. This dialog works just as -the open file dialog box does. You can use it to navigate through -your file system, preview existing files, or filter your file -view with file masks. -</para> - -<para> -Type the name you want to give the file you are saving in the -Location combo box and press the -<guibutton>OK</guibutton> button. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="save-all"/> -<menuchoice> -<shortcut> -<keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo> -</shortcut> -<guimenu>File</guimenu> -<guimenuitem>Save All</guimenuitem> -</menuchoice> -</term> -<listitem> -<para> -This command <action>saves all open files</action>. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="reload"/> -<menuchoice> -<shortcut> -<keycombo action="simul"><keycap>F5</keycap></keycombo> -</shortcut> -<guimenu>File</guimenu> -<guimenuitem>Reload</guimenuitem> -</menuchoice> -</term> -<listitem> -<para> -<action>Reloads the active file from disk</action>. This command is -useful if another program or process has changed the file while you have -it open in &kate; -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="open-with"/> -<menuchoice> -<guimenu>File</guimenu> -<guimenuitem>Open with</guimenuitem> -</menuchoice> -</term> -<listitem> -<para> -This command launches the open with dialog box that allows you to -<action>select another application to open the active -file</action>. Your file will still be open in &kate;. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="print"/> -<menuchoice> -<shortcut> -<keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo> -</shortcut> -<guimenu>File</guimenu> -<guimenuitem>Print</guimenuitem> -</menuchoice> -</term> -<listitem> -<para> -<action>Print the active file</action>. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="close"/> -<menuchoice> -<shortcut> -<keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo> -</shortcut> -<guimenu>File</guimenu> -<guimenuitem>Close</guimenuitem> -</menuchoice> -</term> -<listitem> -<para> -<action>Close the active file</action> with this command. If you -have made unsaved changes, you will be prompted to save -the file before &kate; closes it. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="close-all"/> -<menuchoice> -<guimenu>File</guimenu> -<guimenuitem>Close All</guimenuitem> -</menuchoice> -</term> -<listitem> -<para> -This command <action>closes all the files you have open</action> -in &kate;. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="new-window"/> -<menuchoice> -<guimenu>File</guimenu> -<guimenuitem>New Window</guimenuitem> -</menuchoice> -</term> -<listitem> -<para> -<action>Opens another instance of &kate;</action>. -The new instance will be identical to your previous instance. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="quit"/> -<menuchoice> -<shortcut> -<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> -</shortcut> -<guimenu>File</guimenu> -<guimenuitem>Quit</guimenuitem> -</menuchoice> -</term> -<listitem> -<para> -This command <action>closes &kate;</action> and any files you were -editing. If you have made unsaved changes to any of the files you were -editing, you will be prompted to save them. -</para> -</listitem> -</varlistentry> -</variablelist> -</sect1> - -<sect1 id="edit-menu"> -<title>The <guimenu>Edit</guimenu> Menu</title> -<para>The <guimenu>Edit</guimenu> menu contains a host of commands, -all to work with the currently active document.</para> - -<variablelist> -<title>Menu Entries</title> -<varlistentry> -<term> -<anchor id="edit-undo"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Undo</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Undo the last editing command (typing, copying, cutting etc.)</para> -<note><para>If grouped undo is enabled, this may undo several editing commands of the same type, like typing in characters.</para></note> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="edit-redo"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Redo</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Redo the last undo step.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="edit-cut"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Cut</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Removes selected text if any, and places a copy of the removed text in the clipboard.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="edit-copy"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Copy</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Copies selected text, if any, to the clipboard.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="edit-paste" /> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Paste</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Copies the first item in the clipboard into the editor at cursor position.</para> -<note><para>If Overwrite Selection is enabled, the pasted text will overwrite the selection, if any.</para></note> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="edit-select-all"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Select All</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Selects all text in the editor.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="edit-deselect"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Deselect</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Deselects the selected text in the editor if any.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="edit-toggle-block-selection"/> -<menuchoice> -<shortcut><keycombo action="simul"><keycap>F4</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Toggle Block Selection</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Toggles Selection Mode. When the Selection Mode is <quote>BLOCK</quote>, you can make vertical selections, -ie select column 5 to 10 in lines 9 to 15.</para> -<para>The status bar shows the current state of the Selection Mode, either <quote>NORM</quote> or <quote>BLK</quote>.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="edit-find"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Find</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Launch the Find Dialog to allow you to search for text in the edited document.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="edit-find-next"/> -<menuchoice> -<shortcut><keycombo action="simul"><keycap>F3</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Find Next</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Go to the nearest downwards match of the last text or regular expression searched for, starting from cursor position</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="edit-find-previous"/> -<menuchoice> -<shortcut><keycombo action="simul">&Shift;<keycap>F3</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Find Previous</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Go to the nearest upwards match of the last text or regular expression searched for, starting from cursor position</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="edit-replace"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Replace</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Launch the Replace Dialog to replace one or more instances of a defined text with something else.</para> -</listitem> -</varlistentry> - - -<varlistentry> -<term> -<anchor id="edit-indent"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Indent</guimenuitem> -</menuchoice> -</term> -<listitem><!-- FIXME LINK --> -<para>Adds one indent step to the current line, or all lines covered by a possible selection.</para> -<para>The indentation depends on the settings in the Indent Page of the Configuration Dialog.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="edit-unindent"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>I</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Unindent</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Removes one indent step from the current line, or all lines covered by a possible selection.</para> -<para>The indentation depends on the settings in the Indent Page of the Configuration Dialog.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="edit-comment"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>#</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Comment</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Enclose or prepend the current line, or any selected text, with (a) comment marker(s), according to the rules defined by the -syntax rules for the document. Does nothing if no comment rules are defined.</para> -<para>This is interesting mostly when working with source code, for example with C/C++, perl, python &etc;, -as well as with markup text like <acronym>HTML</acronym>, &XML;, <acronym>CSS</acronym> and so on.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="edit-uncomment"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>#</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem></guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Remove comment marker(s) from the current line, or a possible selection, according to the -syntax rules for the document. -</para> -<para>See also <link linkend="edit-comment"><guimenu>Edit</guimenu><guimenuitem>Comment</guimenuitem></link></para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="edit-go-to-line"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Go to line...</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Launches the Go To Line Dialog, allowing you to enter the number of a line to find in -the document</para> -</listitem> -</varlistentry> - -</variablelist> - -</sect1> - -<sect1 id="document-menu"> -<title>The <guimenu>Document</guimenu>Menu</title> -<para>The <guimenu>Document</guimenu> menu has two purposes:</para> -<itemizedlist> -<listitem><para>Allowing you to change the document-specific settings for the -currently active document.</para></listitem> -<listitem><para>Choosing which of the open documents to work on</para></listitem> -</itemizedlist> -<para>A menu entry for each open document will be available below the entries documented here. -Clicking one of these will bring the requested document to focus. If you have multiple -frames, an editor for that document will be displayed in the currently active frame.</para> -<variablelist> -<title>Menu items</title> - -<varlistentry> -<term> -<anchor id="document-back"/> -<menuchoice> -<shortcut><keycombo action="simul">&Alt;<keycap>Left</keycap></keycombo></shortcut> -<guimenu>Document</guimenu> -<guimenuitem>Back</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>This will bring the previous document in the stack in focus. If you have -multiple frames, an editor for the document will be displayed in the currently -active frame.</para> <para>The order is the order in which documents were -opened, rather than a logical history. This behavior may change in future -versions of &kate;.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="document-forward"/> -<menuchoice> -<shortcut><keycombo action="simul">&Alt;<keycap>Right</keycap></keycombo></shortcut> -<guimenu>Document</guimenu> -<guimenuitem>Forward</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>This will bring the previous document in the stack in focus. If you have -multiple frames, an editor for the document will be displayed in the currently -active frame.</para> -<para>The order is the order in which the documents were opened, -rather than a logical history. This behavior may change in future versions of -&kate;.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="document-highlight-mode"/> -<menuchoice> -<guimenu>Document</guimenu> -<guisubmenu>Highlight Mode</guisubmenu> -</menuchoice> -</term> -<listitem> -<para>The <guimenu>Highlight Mode</guimenu> menu allows you to manually -decide which syntax rules to use for highlighting and -<link linkend="edit-comment"><guimenuitem>comment</guimenuitem></link>'ing -the active document. The menu groups the available syntax rule sets into logical groups.</para> -<!-- FIXME link to syntax rules chapter, when written :) --> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="document-end-of-line"/> -<menuchoice> -<guimenu>Document</guimenu> -<guisubmenu>End of Line</guisubmenu> -</menuchoice> -</term> -<listitem> -<para>This menu allows you to manually set the End of Line mode for -the active document. Changing the mode will replace all line -separators in the document with the character sequence for the new -mode.</para> - -<para>The available modes are:</para> - -<variablelist> -<varlistentry> -<term><guimenuitem>Unix</guimenuitem></term> -<listitem> -<para>On &UNIX; systems, end of line is a single newline -character.</para></listitem> -</varlistentry> -<varlistentry> -<term><guimenuitem>DOS</guimenuitem></term> -<listitem><para>On <acronym>DOS</acronym> (and &Windows;) systems, end -of line is represented by a carriage return followed by a -newline.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guimenuitem>Mac</guimenuitem></term> -<listitem><para>On &Mac; systems, end of line is represented by a by a -carriage return.</para></listitem> -</varlistentry> -</variablelist> -</listitem> -</varlistentry> -</variablelist> -</sect1> - -<sect1 id="view-menu"> -<title>The <guimenu>View</guimenu> menu</title> - -<para>The <guimenu>View</guimenu> menu allows you to manage settings -specific to the active editor, and to manage frames.</para> - -<variablelist> -<title>Menu Items</title> - -<varlistentry> -<term> -<anchor id="view-split-vertical"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>L</keycap></keycombo></shortcut> -<guimenu>View</guimenu> -<guimenuitem>Split Vertical</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>This will split the frame (which may be the main editing area) in two equally sized frames, -the new one to the left of the current one. The new frame gets the focus, and will display the -same document as the old one.</para> -<para>See also <link linkend="kate-mdi">Working with the &kate; MDI</link></para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="view-split-horizontal"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>T</keycap></keycombo></shortcut> -<guimenu>View</guimenu> -<guimenuitem>Split Horizontal</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Splits the current frame (which may be the main editing area) in two equally sized frames, -the new one at the bottom half. The new frame gets the focus, and displays the same document as -the old one.</para> -<para>See also <link linkend="kate-mdi">Working with the &kate; MDI</link></para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="view-close-current"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>R</keycap></keycombo></shortcut> -<guimenu>View</guimenu> -<guimenuitem>Close Current</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Closes the active frame. This is disabled, if there is only one frame -(the main editing area).</para> <para>No documents get closed by closing a -frame – they will still be available in the <link -linkend="document-menu"><guimenu>Documents</guimenu> Menu</link> as well as in -the File List.</para> <para>See also <link linkend="kate-mdi">Working with the -&kate; MDI</link></para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="view-show-icon-border"/> -<menuchoice> -<shortcut><keycombo action="simul"><keycap>F6</keycap></keycombo></shortcut> -<guimenu>View</guimenu> -<guimenuitem>Show Icon Border</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>This is a toggle item. Setting it on checked will make the -<!--<link linkend="katepart-iconborder">Icon Border</link> visible in the left//--> -side of the active editor, and vice versa.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="view-show-line-numbers"/> -<menuchoice> -<shortcut><keycombo action="simul"><keycap>F11</keycap></keycombo></shortcut> -<guimenu>View</guimenu> -<guimenuitem>Show Line Numbers</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>This is a toggle Item. Setting it on checked will make a pane displaying -the line numbers of the document visible in the left border of the active editor, -and vice versa.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="view-go"/> -<menuchoice> -<guimenu>View</guimenu> -<guisubmenu>Go</guisubmenu> -</menuchoice> -</term> -<listitem> - -<variablelist> - -<varlistentry> -<term> -<anchor id="view-go-next-view"/> -<menuchoice> -<shortcut><keycombo action="simul"><keycap>F8</keycap></keycombo></shortcut> -<guimenuitem>Next View</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Move focus to the next frame; the order is following order of creation rather than -that of visual logic. This behavior may change in a future version of &kate;</para> -<para>See also <link linkend="kate-mdi">Working with the &kate; MDI</link></para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="view-go-previous-view"/> -<menuchoice> -<shortcut><keycombo action="simul">&Shift;<keycap>F8</keycap></keycombo></shortcut> -<guimenuitem>Previous View</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Move focus to the previous frame; the order is following order of creation rather than -that of visual logic. This behavior may change in a future version of &kate;</para> -<para>See also <link linkend="kate-mdi">Working with the &kate; MDI</link></para> -</listitem> -</varlistentry> - -</variablelist> - -</listitem> - -</varlistentry> - - - -</variablelist> - -</sect1> - -<sect1 id="bookmarks-menu"> -<title>The <guimenu>Bookmarks</guimenu> Menu</title> - -<para>The <guimenu>Bookmarks</guimenu> menu allows you to work with -the bookmarks in the currently active document.</para> - -<para>Below the entries described here, one entry for each bookmark in -the active document will be available. The text will be the first few -words of the marked line. Choose an item to move the cursor to the -start of that line. The editor will scroll as necessary to make that -line visible.</para> - -<variablelist> - -<title>Menu Items</title> - -<varlistentry> -<term> -<anchor id="bookmarks-toggle-bookmark"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo></shortcut> -<guimenu>Bookmarks</guimenu> -<guimenuitem>Toggle Bookmark</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Sets or removes a bookmark in the current line of the active document. (If it's there, it is removed, otherwise one is set.)</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="bookmarks-clear-bookmarks"/> -<menuchoice> -<guimenu>Bookmarks</guimenu> -<guimenuitem>Clear Bookmarks</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Clears (removes) all bookmarks of the active document.</para> -</listitem> -</varlistentry> - - -</variablelist> - -</sect1> - -<sect1 id="tools-menu"> - -<title>The <guimenu>Tools</guimenu> Menu</title> - -<para>The <guimenu>Tools</guimenu> menu contains commands of two categories: -<itemizedlist> -<listitem><para>Tools doing advanced editing of the current document, -for example <link -linkend="tools-menu-editing-command"><guimenuitem>Editing -Command</guimenuitem></link>.</para> -</listitem> -<listitem><para>Tools adding functionality to the application, for example the -<link linkend="tools-menu-find-in-files"><guimenuitem>Find in -Files</guimenuitem></link> tool.</para> -</listitem> -</itemizedlist> -</para> - -<variablelist> - -<varlistentry> -<term> -<anchor id="tools-menu-editing-command"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Editing Command...</guimenuitem> -</menuchoice> -</term> -<listitem><!-- FIXME LINK, DOCUMENT THAT TODO: add a minimal desc here--> -<para>Launch the Editing Command Dialog</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="tools-menu-find-in-files"/> -<menuchoice> -<shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo></shortcut> -<guimenu>Edit</guimenu> -<guimenuitem>Find in Files...</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Launch the Find In Files Dialog to search for a specified text in files on disk.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="tools-menu-apply-word-wrap"/> -<menuchoice> -<guimenu>Edit</guimenu> -<guimenuitem>Apply Word Wrap</guimenuitem> -</menuchoice> -</term> -<listitem><!-- FIXME LINKS TEST MORE? //--> -<para>Apply word wrap to ? according to the settings in the ? </para> -</listitem> -</varlistentry> - - -<varlistentry> -<term> -<anchor id="tools-menu-spelling"/> -<menuchoice> -<!-- <shortcut><keycombo action="simul"><keycap></keycap><keycap></keycap></keycombo></shortcut> --> -<guimenu>Edit</guimenu> -<guimenuitem>Spelling...</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Spell check the current document using the &kde; spell checker</para> -</listitem> -</varlistentry> - - -</variablelist> - - -</sect1> - -<sect1 id="settings-menu"> - -<title>The <guimenu>Settings</guimenu> Menu</title> - -<para>The <guimenu>Settings</guimenu> menu allows you to change the properties -of the main window, such as showing/hiding toolbars and boxes, and provides -access to the configuration dialogs.</para> - -<variablelist> - -<varlistentry> -<term> -<anchor id="settings-show-toolbar"/> -<menuchoice> -<guimenu>Settings</guimenu> -<guimenuitem>Show Toolbar</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Toggles the display of the main toolbar.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="settings-show-filelist"/> -<menuchoice> -<guimenu>Settings</guimenu> -<guimenuitem>Show Filelist</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Toggle the display of the &kate; Filelist</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="settings-show-fileselector"/> -<menuchoice> -<guimenu>Settings</guimenu> -<guimenuitem>Show Fileselector</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Toggle the display of the &kate; File Selector</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="settings-show-konsole"/> -<menuchoice> -<shortcut><keycombo action="simul"><keycap>F7</keycap></keycombo></shortcut> -<guimenu>Settings</guimenu> -<guimenuitem>Show Konsole</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Toggles the display of the built in terminal emulator.</para> -<para>When activated the first time, the terminal will be created.</para> -<para>When the terminal emulator is displayed, it will get the focus, so that you can start -typing in commands immediately. If the <link linkend="config-dialog-general-sync-konsole">Sync Konsole with Active -Document</link> option is enabled in the <link linkend="config-dialog-general">General Page</link> of the -<link linkend="config-dialog">Main configuration dialog</link> -the shell session will be <command>cd</command>'d to the directory of the active document, if it -is a local file.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="settings-configure-shortcuts"/> -<menuchoice> -<guimenu>Settings</guimenu> -<guimenuitem>Configure Shortcuts</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Display the the familiar &kde; Keyboard Shortcut Configuration Dialog.</para> -</listitem> -</varlistentry> - - -<varlistentry> -<term> -<anchor id="settings-configure-toolbars"/> -<menuchoice> -<guimenu>Settings</guimenu> -<guimenuitem>Configure Toolbars</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Display the the familiar &kde; Toolbar Configuration Dialog.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term> -<anchor id="settings-configure-kate"/> -<menuchoice> -<guimenu>Settings</guimenu> -<guimenuitem>Configure &kate;</guimenuitem> -</menuchoice> -</term> -<listitem> -<para>Launch the <link linkend="config-dialog">Main Configuration Dialog</link></para> -</listitem> -</varlistentry> - - -</variablelist> - -</sect1> - -<sect1 id="help-menu"> - -<title>The <guimenu>Help</guimenu> Menu</title> - -<para><!--Surprisingly enough, //-->The <guimenu>Help</guimenu> menu provides -access to the online help available for &kate;; as well as to the usual about -dialogs.</para> - -<para>As well as the standard &kde; <guimenu>Help</guimenu> menu items -described below, if you have installed the tdeaddons package with -additional &kate; plugins, you will have a menu entry to show the -Plugins User Manuals.</para> - -&help.menu.documentation; - -</sect1> - -</chapter> diff --git a/tde-i18n-nl/docs/kdebase/kate/part.docbook b/tde-i18n-nl/docs/kdebase/kate/part.docbook deleted file mode 100644 index f25038a4ef3..00000000000 --- a/tde-i18n-nl/docs/kdebase/kate/part.docbook +++ /dev/null @@ -1,488 +0,0 @@ -<chapter id="kate-part"> - -<title>Working with the &kate; editor</title> - -<sect1 id="kate-part-overview"> - -<title>Overview</title> - -<para>The &kate; editor is the editing area of the &kate; window. This -editor is also used by &kwrite;, and it can be used in &konqueror; for -displaying text files from your local computer, or from the -network.</para> - -<para>The editor is composed of the following components:</para> - -<variablelist> - -<varlistentry> -<term>The editing area</term> -<listitem><para>This is where the text of your document is located.</para></listitem> -</varlistentry> - -<varlistentry> -<term>The Scroll bars</term> -<listitem> -<para>The scroll bars indicate the position of the visible part of -the document text, and can be used to move around the -document. Dragging the scrollbars will not cause the insertion cursor -to be moved.</para> -<para>The scroll bars are displayed and hidden as required.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>The Icon Border</term> -<listitem> -<para>The icon border is a small pane on the left side of the editor, -displaying a small icon next to marked lines.</para> -<para>You can set or remove a <link -linkend="kate-part-bookmarks">bookmark</link> in a visible line by -clicking the &LMB; in the icon border next to that line.</para> -<para>The display of the icon border can be toggled using the -<menuchoice><guimenu>View</guimenu> <guimenuitem>Show Icon -Border</guimenuitem></menuchoice> menu item.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>The Line Numbers Pane</term> -<listitem> -<para>The Line numbers pane shows the line numbers of all visible -lines in the document.</para> -<para>The display of the Line Numbers Pane can be toggled using the -<menuchoice><guimenu>View</guimenu> <guimenuitem>Show Line -Numbers</guimenuitem></menuchoice> menu item.</para> -</listitem> -</varlistentry> - -</variablelist> - -<itemizedlist> -<title>Also in this Chapter:</title> -<listitem><para><link linkend="kate-part-navigation">Navigating in the -Text</link> </para></listitem> -<listitem><para><link linkend="kate-part-selection">Working with the -Selection</link></para></listitem> -<listitem><para><link linkend="kate-part-copy-and-paste">Copying and -Pasting Text</link></para></listitem> -<listitem><para><link linkend="kate-part-find-replace">Finding and -Replacing Text</link></para></listitem> -<listitem><para><link linkend="kate-part-bookmarks">Using -Bookmarks</link></para></listitem> -<listitem><para><link linkend="kate-part-auto-wrap">Automatically -Wrapping Text</link></para></listitem> -</itemizedlist> - -</sect1> - -<sect1 id="kate-part-navigation"> -<title>Navigating in the Text</title> - -<para>This section is not yet documented.</para> - -</sect1> - -<sect1 id="kate-part-selection"> -<title>Working with the Selection</title> - -<para>There are two basic ways of selecting text in &kate;: using the -mouse, and using the keyboard.</para> - -<para>To select using the mouse, hold down the &LMB; while dragging -the mouse cursor from where the selection should start, to the desired -end point. The text gets selected as you drag.</para> - -<para>Double-clicking a word will select that word.</para> - -<para>Triple-clicking in a line will select the entire line.</para> - -<para>If &Shift; is held down while clicking, text will be -selected:</para> - -<itemizedlist> -<listitem><para>If nothing is already selected, from the text cursor -position to the mouse cursor position.</para></listitem> -<listitem><para>If there is a selection, from and including that -selection to the mouse cursor position</para></listitem> -</itemizedlist> - -<note> -<para>When selecting text by dragging the mouse, the -selected text is copied to the clipboard, and can be pasted by -clicking the middle mouse button in the editor, or in any other -application to which you want to paste the text. -</para> -</note> - -<para>To select using the keyboard, hold down the &Shift; key while -using the navigation keys (The Arrow keys, <keycap>Page Up</keycap>, -<keycap>Page Down</keycap>, <keycap>Home</keycap> and -<keycap>End</keycap>, possibly in combination with &Ctrl; to extend -the move of the text cursor).</para> - -<para>See also the section <link -linkend="kate-part-navigation">Navigating in the Text</link> in this -Chapter.</para> - -<para>To <action>Copy</action> the current selection, use the -<menuchoice><guimenu>Edit</guimenu> -<guimenuitem>Copy</guimenuitem></menuchoice> menu item or the keyboard -shortcut (defaults to <keycombo -action="simul">&Ctrl;<keycap>C</keycap></keycombo>).</para> - -<para>To <action>Deselect</action> the current selection, use the -<menuchoice><guimenu>Edit</guimenu> -<guimenuitem>Deselect</guimenuitem></menuchoice> menu item, or the -keyboard shortcut (default is <keycombo -action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo>), or click -with the &LMB; in the editor.</para> - -<sect2 id="kate-part-selection-block"> -<title>Using Block Selection</title> - -<para>When Block Selection is enabled, you can make <quote>vertical -selections</quote> in the text, meaning selecting limited columns from -multiple lines. This is handy for working with tab separated lines for -example.</para> - -<para>Block Selection can be toggled using the -<menuchoice><guimenu>Edit</guimenu> <guimenuitem>Toggle Block -Selection</guimenuitem></menuchoice> menu item. The default keyboard -shortcut is <keycap>F4</keycap></para> - -</sect2> - -<sect2 id="kate-part-seleciton-overwrite"> - -<title>Using Overwrite Selection</title> - -<para>If Overwrite Selection is enabled, typing or pasting text into -the selection will cause the selected text to be replaced. If not -enabled, new text will be added at the position of the text -cursor.</para> - -<para>Overwrite Selection is enabled by default.</para> - -<para>To change the setting for this option, use the <link -linkend="config-dialog-editor-select">Select Page</link> of the <link -linkend="config-dialog">Configuration Dialog</link>.</para> - -</sect2> - -<sect2 id="kate-part-selection-persistent"> - -<title>Using Persistent Selection</title> - -<para>When Persistent selection is enabled, typing characters or -moving the cursor will not cause the Selection to become -deselected. This means that you can move the cursor away from the -selection and type text.</para> - -<para>Persistent Selection is disabled by default.</para> - -<para>Persistent Selection can be enabled in the <link -linkend="config-dialog-editor-select">Select Page</link> of the <link -linkend="config-dialog">Configuration Dialog</link>.</para> - -<warning> -<para>If Persistent Selection and Overwrite Selection are both -enabled, typing or pasting text when the text cursor is inside the -selection will cause it to be replaced and deselected.</para> -</warning> - -</sect2> - -</sect1> - -<sect1 id="kate-part-copy-and-paste"> - -<title>Copying and Pasting Text</title> - -<para>To copy text, select it and use the -<menuchoice><guimenu>Edit</guimenu> -<guimenuitem>Copy</guimenuitem></menuchoice> menu item. Additionally, -selecting text with the mouse will cause selected text to be copied to -the clipboard.</para> - -<para>To paste the text currently in the clipboard, use the -<menuchoice> -<guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem></menuchoice> -menu item.</para> - -<para>Additionally, text selected with the mouse may be pasted by -clicking the <mousebutton>middle</mousebutton> mouse button at the -desired position.</para> - -<tip> -<para>If you are using the &kde; desktop, you can retrieve earlier -copied text from any application using the &klipper; icon in the -&kicker; icon tray.</para> -</tip> - -</sect1> - -<sect1 id="kate-part-find-replace"> -<title>Finding and Replacing Text</title> - -<sect2 id="find-replace-dialog"> -<title>The <guilabel>Find Text</guilabel> and <guilabel>Replace -Text</guilabel> Dialogs</title> - - -<para>The Find and Replace Text dialogs in &kate; are very much the -same, except the Replace Text dialog offers the means of entering a -replacement string along with a few extra options.</para> - -<para>The dialogs offer the following common options:</para> - -<variablelist> - -<varlistentry> -<term><guilabel>Text to Find</guilabel></term> -<listitem><para>This is where to enter the search string. The interpretation of the string -depends on some of the options described below.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Regular Expression</guilabel></term> -<listitem> -<para>If checked, the search string is interpreted as a regular -expression. A button for using a graphical tool to create or edit the -expression will be enabled.</para> -<para>See <link linkend="regular-expressions">Regular -Expressions</link> for more on these.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Case Insensitive</guilabel></term> -<listitem> -<para>If enabled, the search will be case insensitive.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Whole Words Only</guilabel></term> -<listitem> -<para>If checked, the search will only match if there is a word -boundary at both ends of the string matching, meaning not an -alphanumeric character - either some other visible character or a line -end.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>From Beginning</guilabel></term> -<listitem> -<para>If checked, the search will start at the beginning of the first -line in the document, otherwise it will start at cursor position.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Find Backwards</guilabel></term> -<listitem> -<para>If checked, the search will look for the first match above the -starting point, either cursor position or the beginning of the -document, if the <guilabel>From Beginning</guilabel> option is -enabled.</para> -</listitem> -</varlistentry> - -</variablelist> - -<para>The <guilabel>Replace Text</guilabel> Dialog offers some -additional options:</para> - -<variablelist> - -<varlistentry> -<term><guilabel>Replace With</guilabel></term> -<listitem><para>This is where to enter the replacement -string.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Selected Text</guilabel></term> -<listitem> -<para>This option is disabled if no text is selected, or if the -<guilabel>Prompt on Replace</guilabel> -option is enabled. If checked, all matches of the search string within -the selected text will be replaced with the replace string.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Prompt on Replace</guilabel></term> -<listitem><para>If checked, a small dialog will prompt you for what to -do for each time a match is found. It offers the following options: -<variablelist> - -<varlistentry> -<term><guibutton>Yes</guibutton></term> -<listitem><para>Activate this to replace the current match (which is -selected in the editor).</para></listitem> -</varlistentry> - -<varlistentry> -<term><guibutton>No</guibutton></term> -<listitem><para>Activate to skip the current match, and try to find another one.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guibutton>All</guibutton></term> -<listitem><para>Activate to cancel prompting, and just replace all -matches.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guibutton>Close</guibutton></term> -<listitem><para>Activate this skip the current match and end the -searching.</para></listitem> -</varlistentry> - -</variablelist> - -</para></listitem> -</varlistentry> - -</variablelist> - -<note> -<para>There is currently no way to use minimal matching when searching -for a regular expression. This will be added in a future version of -&kate;</para> -</note> - -</sect2> - -<sect2 id="finding-text"> -<title>Finding Text</title> - -<para>To find text, launch the <guilabel>Find Text</guilabel> Dialog -with <keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo>or -from the <menuchoice><guimenu>Edit</guimenu> -<guimenuitem>Find...</guimenuitem></menuchoice> menu item,enter a -search string, set the <link -linkend="find-replace-dialog">options</link> as desired and hit -<guibutton>Ok</guibutton>. If no matches is found between the starting -point for the search (either the text cursor position or the beginning -of the document) you will be prompted for permission to continue from -the start (or end, if you are searching backwards) of the -document.</para> - -<para>If a match is found it is selected and the <guilabel>Find -Text</guilabel> Dialog is hidden, but stay tuned, finding further -matches is very easy:</para> - -<para>To find the next match in the search direction, use the -<menuchoice><guimenu>Edit</guimenu> <guimenuitem>Find -Next</guimenuitem></menuchoice> command or press -<keycap>F3</keycap>.</para> - -<para>To find the next match in the opposite direction, use the -<menuchoice><guimenu>Edit</guimenu> <guimenuitem>Find -Previous</guimenuitem></menuchoice> command or press <keycombo -action="simul">&Shift;<keycap>F3</keycap></keycombo>.</para> - -<para>If no match is found before reaching the document border, you -will be prompted for permission to cross that.</para> - -</sect2> - -<sect2> -<title>Replacing Text</title> - -<para>To replace text, launch the <guilabel>Replace text</guilabel> -Dialog using the <menuchoice><guimenu>Edit</guimenu> -<guimenuitem>Replace</guimenuitem></menuchoice> command, or the -<keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo> shortcut, -enter a search string and optionally a replace string (if the replace -string is empty, each match will be replaced with ""), set -the <link linkend="find-replace-dialog">options</link> as desired and -hit the <guibutton>Ok</guibutton> button.</para> - -<tip> -<para>If you are using a regular expression to find the text to replace, you can -employ backrefences to reuse text captured in parenthesized subpatterns of the expression.</para> -<para>See <xref linkend="regular-expressions"/><!-- xref to reg-exp appendix --> for more -on those.</para> -</tip> - -</sect2> - -</sect1> - -<sect1 id="kate-part-bookmarks"> -<title>Using Bookmarks</title> - -<para>The bookmarks feature allows you to mark certain lines, to be -able to easily find them again.</para> - -<para>You can set or remove a bookmark in a line in two ways:</para> - -<itemizedlist> -<listitem> -<para>Moving the insertion cursor to that line, and activate the -<menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Toggle -Bookmark</guimenuitem></menuchoice> (<keycombo -action="simul">&Ctrl;<keycap>B</keycap></keycombo>) command.</para> -</listitem> -<listitem> -<para>Clicking in the Icon Border next to that line.</para> -</listitem> -</itemizedlist> - - -<para>Bookmarks are available in the <guimenu>Bookmarks</guimenu> -menu. The individual bookmarks are available as menu items, labeled -with the line number of the line with the bookmark, and the first few -characters of the text in the line. To move the insertion cursor to -the beginning of a bookmarked line, open the menu and select the -bookmark.</para> - -<tip> -<para>If the <link linkend="config-dialog-general-reopen-files">Reopen -Files</link> option in the <link linkend="config-dialog">Config -Dialog</link> is enabled (or if &kate; was started by the session -manager), your bookmarks will be restored when the document is -reopened.</para> -</tip> - -</sect1> - -<sect1 id="kate-part-auto-wrap"> - -<title>Automatically Wrapping text</title> - -<para>This feature allows you to have the text formatted in a very simple way: the text will be wrapped, -so that no lines exceed a maximum number of characters per line, unless there is a longer string of -non-whitespace characters.</para> - -<para>To enable/disable it, check/uncheck the <guibutton>Word Wrap</guibutton> checkbox in the -<link linkend="config-dialog-editor-edit">edit page</link> of the <link linkend="config-dialog">configuration dialog</link>.</para> - -<para>To set the maximum line width (maximum characters per line), use the -<link linkend="config-dialog-editor-edit-wrap-words-at"><guibutton>Wrap Words At</guibutton></link> -option in the <link linkend="config-dialog-editor-edit">edit page</link> of the <link linkend="config-dialog">configuration -dialog</link>.</para> - -<para>If enabled, -it has the following effects: - -<itemizedlist> -<listitem><para>While typing, the editor will automatically insert a hard line break after -the last whitespace character at a position before the maximum line width is reached.</para></listitem> -<listitem><para>While loading a document, the editor will wrap the text in a similar way, so that -no lines are longer than the maximum line width, if they contain any whitespace allowing that.</para></listitem> -</itemizedlist> - -</para> - -<note><para>There is currently no way to set word wrap for document types, or even to enable or disable -the feature on document level. This will be fixed in a future version of &kate;</para></note> - -</sect1> - -</chapter> diff --git a/tde-i18n-nl/docs/kdebase/kate/plugins.docbook b/tde-i18n-nl/docs/kdebase/kate/plugins.docbook deleted file mode 100644 index a37d24d259b..00000000000 --- a/tde-i18n-nl/docs/kdebase/kate/plugins.docbook +++ /dev/null @@ -1,18 +0,0 @@ -<chapter id="plugins"> -<chapterinfo> -<authorgroup> -<author -><personname -><firstname -></firstname -></personname -></author> -&Otto.Bruggeman; -</authorgroup> -</chapterinfo> -<title ->Werken met plugins</title> -<para ->Dit hoofdstuk beschrijft het gebruik van plugins</para> - -</chapter> diff --git a/tde-i18n-nl/docs/kdebase/kate/regular-expressions.docbook b/tde-i18n-nl/docs/kdebase/kate/regular-expressions.docbook deleted file mode 100644 index 860f2e36c8f..00000000000 --- a/tde-i18n-nl/docs/kdebase/kate/regular-expressions.docbook +++ /dev/null @@ -1,658 +0,0 @@ -<appendix id="regular-expressions"> - -<title>Regular Expressions</title> - -<synopsis> This Appendix contains a brief but hopefully sufficient and -covering introduction to the world of <emphasis>regular -expressions</emphasis>. It documents regular expressions in the form -available within &kate;, which is not compatible with the regular -expressions of perl, nor with those of for example -<command>grep</command>.</synopsis> - -<sect1> - -<title>Introduction</title> - -<para><emphasis>Regular Expressions</emphasis> provides us with a way -to describe some possible contents of a text string in a way -understood by a small piece of software, so that it can investigate if -a text matches, and also in the case of advanced applications with the -means of saving pieces or the matching text.</para> - -<para>An example: Say you want to search a text for paragraphs that -starts with either of the names <quote>Henrik</quote> or -<quote>Pernille</quote> followed by some form of the verb -<quote>say</quote>.</para> - -<para>With a normal search, you would start out searching for the -first name, <quote>Henrik</quote> maybe followed by <quote>sa</quote> -like this: <userinput>Henrik sa</userinput>, and while looking for -matches, you would have to discard those not being the beginning of a -paragraph, as well as those in which the word starting with the -letters <quote>sa</quote> was not either <quote>says</quote>, -<quote>said</quote> or so. And then of cause repeat all of that with -the next name...</para> - -<para>With Regular Expressions, that task could be accomplished with a -single search, and with a larger degree of preciseness.</para> - -<para>To achieve this, Regular Expressions defines rules for -expressing in details a generalization of a string to match. Our -example, which we might literally express like this: <quote>A line -starting with either <quote>Henrik</quote> or <quote>Pernille</quote> -(possibly following up to 4 blanks or tab characters) followed by a -whitespace followed by <quote>sa</quote> and then either -<quote>ys</quote> or <quote>id</quote></quote> could be expressed with -the following regular expression:</para> <para><userinput>^[ -\t]{0,4}(Henrik|Pernille) sa(ys|id)</userinput></para> - -<para>The above example demonstrates all four major concepts of modern -Regular Expressions, namely:</para> - -<itemizedlist> -<listitem><para>Patterns</para></listitem> -<listitem><para>Assertions</para></listitem> -<listitem><para>Quantifiers</para></listitem> -<listitem><para>Back references</para></listitem> -</itemizedlist> - -<para>The caret (<literal>^</literal>) starting the expression is an -assertion, being true only if the following matching string is at the -start of a line.</para> - -<para>The stings <literal>[ \t]</literal> and -<literal>(Henrik|Pernille) sa(ys|id)</literal> are patterns. The first -one is a <emphasis>character class</emphasis> that matches either a -blank or a (horizontal) tab character; the other pattern contains -first a subpattern matching either <literal>Henrik</literal> -<emphasis>or</emphasis> <literal>Pernille</literal>, then a piece -matching the exact string <literal> sa</literal> and finally a -subpattern matching either <literal>ys</literal> -<emphasis>or</emphasis> <literal>id</literal></para> - -<para>The string <literal>{0,4}</literal> is a quantifier saying -<quote>anywhere from 0 up to 4 of the previous</quote>.</para> - -<para>Because regular expression software supporting the concept of -<emphasis>back references</emphasis> saves the entire matching part of -the string as well as sub-patterns enclosed in parentheses, given some -means of access to those references, we could get our hands on either -the whole match (when searching a text document in an editor with a -regular expression, that is often marked as selected) or either the -name found, or the last part of the verb.</para> - -<para>All together, the expression will match where we wanted it to, -and only there.</para> - -<para>The following sections will describe in details how to construct -and use patterns, character classes, assertions, quantifiers and -back references, and the final section will give a few useful -examples.</para> - -</sect1> - -<sect1 id="regex-patterns"> - -<title>Patterns</title> - -<para>Patterns consists of literal strings and character -classes. Patterns may contain sub-patterns, which are patterns enclosed -in parentheses.</para> - -<sect2> -<title>Escaping characters</title> - -<para>In patterns as well as in character classes, some characters -have a special meaning. To literally match any of those characters, -they must be marked or <emphasis>escaped</emphasis> to let the regular -expression software know that it should interpret such characters in -their literal meaning.</para> - -<para>This is done by prepending the character with a backslash -(<literal>\</literal>).</para> - - -<para>The regular expression software will silently ignore escaping a -character that does not have any special meaning in the context, so -escaping for example a <quote>j</quote> (<userinput>\j</userinput>) is -safe. If you are in doubt whether a character could have a special -meaning, you can therefore escape it safely.</para> - -<para>Escaping of cause includes the backslash character it self, to -literally match a such, you would write -<userinput>\\</userinput>.</para> - -</sect2> - -<sect2> -<title>Character Classes and abbreviations</title> - -<para>A <emphasis>character class</emphasis> is an expression that -matches one of a defined set of characters. In Regular Expressions, -character classes are defined by putting the legal characters for the -class in square brackets, <literal>[]</literal>, or by using one of -the abbreviated classes described below.</para> - -<para>Simple character classes just contains one or more literal -characters, for example <userinput>[abc]</userinput> (matching either -of the letters <quote>a</quote>, <quote>b</quote> or <quote>c</quote>) -or <userinput>[0123456789]</userinput> (matching any digit).</para> - -<para>Because letters and digits have a logical order, you can -abbreviate those by specifying ranges of them: -<userinput>[a-c]</userinput> is equal to <userinput>[abc]</userinput> -and <userinput>[0-9]</userinput> is equal to -<userinput>[0123456789]</userinput>. Combining these constructs, for -example <userinput>[a-fynot1-38]</userinput> is completely legal (the -last one would match, of cause, either of -<quote>a</quote>,<quote>b</quote>,<quote>c</quote>,<quote>d</quote>, -<quote>e</quote>,<quote>f</quote>,<quote>y</quote>,<quote>n</quote>,<quote>o</quote>,<quote>t</quote>, -<quote>1</quote>,<quote>2</quote>,<quote>3</quote> or -<quote>8</quote>).</para> - -<para>As capital letters are different characters from their -non-capital equivalents, to create a caseless character class matching -<quote>a</quote> or <quote>b</quote>, in any case, you need to write it -<userinput>[aAbB]</userinput>.</para> - -<para>It is of cause possible to create a <quote>negative</quote> -class matching as <quote>anything but</quote> To do so put a caret -(<literal>^</literal>) at the beginning of the class: </para> - -<para><userinput>[^abc]</userinput> will match any character -<emphasis>but</emphasis> <quote>a</quote>, <quote>b</quote> or -<quote>c</quote>.</para> - -<para>In addition to literal characters, some abbreviations are -defined, making life still a bit easier: - -<variablelist> - -<varlistentry> -<term><userinput>\a</userinput></term> -<listitem><para> This matches the <acronym>ASCII</acronym> bell character (BEL, 0x07).</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>\f</userinput></term> -<listitem><para> This matches the <acronym>ASCII</acronym> form feed character (FF, 0x0C).</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>\n</userinput></term> -<listitem><para> This matches the <acronym>ASCII</acronym> line feed character (LF, 0x0A, Unix newline).</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>\r</userinput></term> -<listitem><para> This matches the <acronym>ASCII</acronym> carriage return character (CR, 0x0D).</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>\t</userinput></term> -<listitem><para> This matches the <acronym>ASCII</acronym> horizontal tab character (HT, 0x09).</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>\v</userinput></term> -<listitem><para> This matches the <acronym>ASCII</acronym> vertical tab character (VT, 0x0B).</para></listitem> -</varlistentry> -<varlistentry> -<term><userinput>\xhhhh</userinput></term> - -<listitem><para> This matches the Unicode character corresponding to -the hexadecimal number hhhh (between 0x0000 and 0xFFFF). \0ooo (i.e., -\zero ooo) matches the <acronym>ASCII</acronym>/Latin-1 character -corresponding to the octal number ooo (between 0 and -0377).</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>.</userinput> (dot)</term> -<listitem><para> This matches any character (including newline).</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>\d</userinput></term> -<listitem><para> This matches a digit. Equal to <literal>[0-9]</literal></para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>\D</userinput></term> -<listitem><para> This matches a non-digit. Equal to <literal>[^0-9]</literal> or <literal>[^\d]</literal></para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>\s</userinput></term> -<listitem><para> This matches a whitespace character. Practically equal to <literal>[ \t\n\r]</literal></para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>\S</userinput></term> -<listitem><para> This matches a non-whitespace. Practically equal to <literal>[^ \t\r\n]</literal>, and equal to <literal>[^\s]</literal></para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>\w</userinput></term> -<listitem><para>Matches any <quote>word character</quote> - in this case any letter or digit. Note that -underscore (<literal>_</literal>) is not matched, as is the case with perl regular expressions. -Equal to <literal>[a-zA-Z0-9]</literal></para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>\W</userinput></term> -<listitem><para>Matches any non-word character - anything but letters or numbers. -Equal to <literal>[^a-zA-Z0-9]</literal> or <literal>[^\w]</literal></para></listitem> -</varlistentry> - - -</variablelist> - -</para> - -<para>The abbreviated classes can be put inside a custom class, for -example to match a word character, a blank or a dot, you could write -<userinput>[\w \.]</userinput></para> - -<note> <para>The POSIX notation of classes, <userinput>[:<class -name>:]</userinput> is currently not supported.</para> </note> - -<sect3> -<title>Characters with special meanings inside character classes</title> - -<para>The following characters has a special meaning inside the -<quote>[]</quote> character class construct, and must be escaped to be -literally included in a class:</para> - -<variablelist> -<varlistentry> -<term><userinput>]</userinput></term> -<listitem><para>Ends the character class. Must be escaped unless it is the very first character in the -class (may follow an unescaped caret)</para></listitem> -</varlistentry> -<varlistentry> -<term><userinput>^</userinput> (caret)</term> -<listitem><para>Denotes a negative class, if it is the first character. Must be escaped to match literally if it is the first character in the class.</para></listitem> -</varlistentry> -<varlistentry> -<term><userinput>-</userinput> (dash)</term> -<listitem><para>Denotes a logical range. Must always be escaped within a character class.</para></listitem> -</varlistentry> -<varlistentry> -<term><userinput>\</userinput> (backslash)</term> -<listitem><para>The escape character. Must always be escaped.</para></listitem> -</varlistentry> - -</variablelist> - -</sect3> - -</sect2> - -<sect2> - -<title>Alternatives: matching <quote>one of</quote></title> - -<para>If you want to match one of a set of alternative patterns, you -can separate those with <literal>|</literal> (vertical bar character).</para> - -<para>For example to find either <quote>John</quote> or <quote>Harry</quote> you would use an expression <userinput>John|Harry</userinput>.</para> - -</sect2> - -<sect2> - -<title>Sub Patterns</title> - -<para><emphasis>Sub patterns</emphasis> are patterns enclosed in -parentheses, and they have several uses in the world of regular -expressions.</para> - -<sect3> - -<title>Specifying alternatives</title> - -<para>You may use a sub pattern to group a set of alternatives within -a larger pattern. The alternatives are separated by the character -<quote>|</quote> (vertical bar).</para> - -<para>For example to match either of the words <quote>int</quote>, -<quote>float</quote> or <quote>double</quote>, you could use the -pattern <userinput>int|float|double</userinput>. If you only want to -find one if it is followed by some whitespace and then some letters, -put the alternatives inside a subpattern: -<userinput>(int|float|double)\s+\w+</userinput>.</para> - -</sect3> - -<sect3> - -<title>Capturing matching text (back references)</title> - -<para>If you want to use a back reference, use a sub pattern to have -the desired part of the pattern remembered.</para> - -<para>For example, it you want to find two occurrences of the same -word separated by a comma and possibly some whitespace, you could -write <userinput>(\w+),\s*\1</userinput>. The sub pattern -<literal>\w+</literal> would find a chunk of word characters, and the -entire expression would match if those were followed by a comma, 0 or -more whitespace and then an equal chunk of word characters. (The -string <literal>\1</literal> references <emphasis>the first sub pattern -enclosed in parentheses</emphasis>)</para> - -<para>See also <link linkend="backreferences">Back references</link>.</para> - -</sect3> - -<sect3 id="lookahead-assertions"> -<title>Lookahead Assertions</title> - -<para>A lookahead assertion is a sub pattern, starting with either -<literal>?=</literal> or <literal>?!</literal>.</para> - -<para>For example to match the literal string <quote>Bill</quote> but -only if not followed by <quote> Gates</quote>, you could use this -expression: <userinput>Bill(?! Gates)</userinput>. (This would find -<quote>Bill Clinton</quote> as well as <quote>Billy the kid</quote>, -but silently ignore the other matches.)</para> - -<para>Sub patterns used for assertions are not captured.</para> - -<para>See also <link linkend="assertions">Assertions</link></para> - -</sect3> - -</sect2> - -<sect2 id="special-characters-in-patterns"> -<title>Characters with a special meaning inside patterns</title> - -<para>The following characters have meaning inside a pattern, and -must be escaped if you want to literally match them: - -<variablelist> - -<varlistentry> -<term><userinput>\</userinput> (backslash)</term> -<listitem><para>The escape character.</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>^</userinput> (caret)</term> -<listitem><para>Asserts the beginning of the string.</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>$</userinput></term> -<listitem><para>Asserts the end of string.</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>()</userinput> (left and right parentheses)</term> -<listitem><para>Denotes sub patterns.</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>{}</userinput> (left and right curly braces)</term> -<listitem><para>Denotes numeric quantifiers.</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>[]</userinput> (left and right square brackets)</term> -<listitem><para>Denotes character classes.</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>|</userinput> (vertical bar)</term> -<listitem><para>logical OR. Separates alternatives.</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>+</userinput> (plus sign)</term> -<listitem><para>Quantifier, 1 or more.</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>*</userinput> (asterisk)</term> -<listitem><para>Quantifier, 0 or more.</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>?</userinput> (question mark)</term> -<listitem><para>An optional character. Can be interpreted as a quantifier, 0 or 1.</para></listitem> -</varlistentry> - -</variablelist> - -</para> - -</sect2> - -</sect1> - -<sect1 id="quantifiers"> -<title>Quantifiers</title> - -<para><emphasis>Quantifiers</emphasis> allows a regular expression to -match a specified number or range of numbers of either a character, -character class or sub pattern.</para> - -<para>Quantifiers are enclosed in curly brackets (<literal>{</literal> -and <literal>}</literal>) and have the general form -<literal>{[minimum-occurrences][,[maximum-occurrences]]}</literal> -</para> - -<para>The usage is best explained by example: - -<variablelist> - -<varlistentry> -<term><userinput>{1}</userinput></term> -<listitem><para>Exactly 1 occurrence</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>{0,1}</userinput></term> -<listitem><para>Zero or 1 occurrences</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>{,1}</userinput></term> -<listitem><para>The same, with less work;)</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>{5,10}</userinput></term> -<listitem><para>At least 5 but maximum 10 occurrences.</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>{5,}</userinput></term> -<listitem><para>At least 5 occurrences, no maximum.</para></listitem> -</varlistentry> - -</variablelist> - -</para> - -<para>Additionally, there are some abbreviations: - -<variablelist> - -<varlistentry> -<term><userinput>*</userinput> (asterisk)</term> -<listitem><para>similar to <literal>{0,}</literal>, find any number of occurrences.</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>+</userinput> (plus sign)</term> -<listitem><para>similar to <literal>{1,}</literal>, at least 1 occurrence.</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>?</userinput> (question mark)</term> -<listitem><para>similar to <literal>{0,1}</literal>, zero or 1 occurrence.</para></listitem> -</varlistentry> - -</variablelist> - -</para> - -<sect2> - -<title>Greed</title> - -<para>When using quantifiers with no maximum, regular expressions -defaults to match as much of the searched string as possible, commonly -known as <emphasis>greedy</emphasis> behavior.</para> - -<para>Modern regular expression software provides the means of -<quote>turning off greediness</quote>, though in a graphical -environment it is up to the interface to provide you with access to -this feature. For example a search dialog providing a regular -expression search could have a check box labeled <quote>Minimal -matching</quote> as well as it ought to indicate if greediness is the -default behavior.</para> - -</sect2> - -<sect2> -<title>In context examples</title> - -<para>Here are a few examples of using quantifiers</para> - -<variablelist> - -<varlistentry> -<term><userinput>^\d{4,5}\s</userinput></term> -<listitem><para>Matches the digits in <quote>1234 go</quote> and <quote>12345 now</quote>, but neither in <quote>567 eleven</quote> -nor in <quote>223459 somewhere</quote></para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>\s+</userinput></term> -<listitem><para>Matches one or more whitespace characters</para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>(bla){1,}</userinput></term> -<listitem><para>Matches all of <quote>blablabla</quote> and the <quote>bla</quote> in <quote>blackbird</quote> or <quote>tabla</quote></para></listitem> -</varlistentry> - -<varlistentry> -<term><userinput>/?></userinput></term> -<listitem><para>Matches <quote>/></quote> in <quote><closeditem/></quote> as well as -<quote>></quote> in <quote><openitem></quote>.</para></listitem> -</varlistentry> - -</variablelist> - -</sect2> - -</sect1> - -<sect1 id="assertions"> -<title>Assertions</title> - -<para><emphasis>Assertions</emphasis> allows a regular expression to -match only under certain controlled conditions.</para> - -<para>An assertion does not need a character to match, it rather -investigates the surroundings of a possible match before acknowledging -it. For example the <emphasis>word boundary</emphasis> assertion does -not try to find a non word character opposite a word one at its -position, instead it makes sure that there is not a word -character. This means that the assertion can match where there is no -character, i.e. at the ends of a searched string.</para> - -<para>Some assertions actually does have a pattern to match, but the -part of the string matching that will not be a part of the result of -the match of the full expression.</para> - -<para>Regular Expressions as documented here supports the following -assertions: - -<variablelist> - -<varlistentry> -<term><userinput>^</userinput> (caret: beginning of -string)</term> -<listitem><para>Matches the beginning of the searched -string.</para> <para>The expression <userinput>^Peter</userinput> will -match at <quote>Peter</quote> in the string <quote>Peter, hey!</quote> -but not in <quote>Hey, Peter!</quote> </para> </listitem> -</varlistentry> - -<varlistentry> -<term><userinput>$</userinput> (end of string)</term> -<listitem><para>Matches the end of the searched string.</para> - -<para>The expression <userinput>you\?$</userinput> will match at the -last you in the string <quote>You didn't do that, did you?</quote> but -nowhere in <quote>You didn't do that, right?</quote></para> - -</listitem> -</varlistentry> - -<varlistentry> -<term><userinput>\b</userinput> (word boundary)</term> -<listitem><para>Matches if there is a word character at one side and not a word character at the -other.</para> -<para>This is useful to find word ends, for example both ends to find -a whole word. The expression <userinput>\bin\b</userinput> will match -at the separate <quote>in</quote> in the string <quote>He came in -through the window</quote>, but not at the <quote>in</quote> in -<quote>window</quote>.</para></listitem> - -</varlistentry> - -<varlistentry> -<term><userinput>\B</userinput> (non word boundary)</term> -<listitem><para>Matches wherever <quote>\b</quote> does not.</para> -<para>That means that it will match for example within words: The expression -<userinput>\Bin\B</userinput> will match at in <quote>window</quote> but not in <quote>integer</quote> or <quote>I'm in love</quote>.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><userinput>(?=PATTERN)</userinput> (Positive lookahead)</term> -<listitem><para>A lookahead assertion looks at the part of the string following a possible match. -The positive lookahead will prevent the string from matching if the text following the possible match -does not match the <emphasis>PATTERN</emphasis> of the assertion, but the text matched by that will -not be included in the result.</para> -<para>The expression <userinput>handy(?=\w)</userinput> will match at <quote>handy</quote> in -<quote>handyman</quote> but not in <quote>That came in handy!</quote></para> -</listitem> -</varlistentry> - -<varlistentry> -<term><userinput>(?!PATTERN)</userinput> (Negative lookahead)</term> - -<listitem><para>The negative lookahead prevents a possible match to be -acknowledged if the following part of the searched string does match -its <emphasis>PATTERN</emphasis>.</para> -<para>The expression <userinput>const \w+\b(?!\s*&)</userinput> -will match at <quote>const char</quote> in the string <quote>const -char* foo</quote> while it can not match <quote>const QString</quote> -in <quote>const QString& bar</quote> because the -<quote>&</quote> matches the negative lookahead assertion -pattern.</para> -</listitem> -</varlistentry> - -</variablelist> - -</para> - -</sect1> - -<sect1 id="backreferences"> - -<title>Back References</title> - -<para></para> - -</sect1> - -</appendix> |
