From 4aed2c8219774f5d797760606b8489a92ddc5163 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdebase@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/konqueror/man-kbookmarkmerger.1.docbook | 112 ++++++++++++++++++++++++++++ 1 file changed, 112 insertions(+) create mode 100644 doc/konqueror/man-kbookmarkmerger.1.docbook (limited to 'doc/konqueror/man-kbookmarkmerger.1.docbook') diff --git a/doc/konqueror/man-kbookmarkmerger.1.docbook b/doc/konqueror/man-kbookmarkmerger.1.docbook new file mode 100644 index 000000000..dab890556 --- /dev/null +++ b/doc/konqueror/man-kbookmarkmerger.1.docbook @@ -0,0 +1,112 @@ + + + +kbookmarkmerger"> +]> + + + + KDE User's Manual + + &Frerich.Raabe; + &Frerich.Raabe.mail; + + February 1st, 2005 + K Desktop Environment + + + + &kbookmarkmerger; + 1 + + + + &kbookmarkmerger; + A program for merging a given set of bookmarks into the + user's list of bookmarks. + + + + + &kbookmarkmerger; + Qt Options + KDE Options + directory + + + + +Description +&kbookmarkmerger; is a program for merging a given set of bookmarks into +the user's set of bookmarks; if the user doesn't have any bookmarks created +yet, a new bookmark list is created and the given bookmarks are inserted into +it. While doing this, &kbookmarkmerger; keeps track of which files were +merged in a previous run already, so no bookmark will get installed to the +user's bookmarks more than once. In case &kde; is running while +&kbookmarkmerger; is executed, the &kde; bookmark subsystem will be informed +of any changes to the user's bookmarks, so that all applications accessing +that information (&ie; &konqueror;) will pick the changes up instantly. + +The traditionally used approach to achieve something like this was to +use carefully crafted skeleton home directories when creating a new user +account, to provide the user with a standard set of bookmarks. The problem +with this approach is that after the user account has been created, no new +bookmarks can be propagated. + +This mechanism is useful for system administrators who want to propagate +a bookmark pointing to a certain document (for instance, important notes about +the system) to all users. Distributors might find it useful as well, for +instance by augmenting the software packages they supply with bookmark files +which &kbookmarkmerger; merges into the user's bookmark list when the +package is installed. That way, documentation shipped with a software package +is easily and visibly accessible right after the package has been +installed. + +The only parameter required by &kbookmarkmerger; is the name of a +directory which shall be scanned for bookmark files. All files in the given +directory will be considered for being merged into the user's setup. The +files in the given directory should be valid XBEL +files. + + + +See Also +&konqueror; manual + + + +Examples +joe@hal9000:~> kbookmarkmerger /usr/local/extra-bookmarks +Merges all bookmark files stored in +/usr/local/extra-bookmarks into joe's list of +bookmarks. + + + +Standards + + + XBEL specification + + + + + +Restrictions +When determining whether a given bookmark file has been merged into the +user's bookmarks already or not, &kbookmarkmerger; merely looks at the +filename of the bookmark file - the contents are not checked at all. This means +that changing a bookmark file which was already merged into a user's bookmarks +will not trigger merging it once again. + +Also note that in case a user modifies a bookmark which was merged into +his setup, the original bookmark file will be left unmodified. + + + +Author +&Frerich.Raabe; &Frerich.Raabe.mail; + + + -- cgit v1.2.1