1KBOOKMARKMERGER                KDE User's Manual               KBOOKMARKMERGER
2
3
4

NAME

6       kbookmarkmerger - A program for merging a given set of bookmarks into
7       the user's list of bookmarks.
8

SYNOPSIS

10       kbookmarkmerger [Qt Options...] [KDE Options...] {directory}
11

DESCRIPTION

13       kbookmarkmerger is a program for merging a given set of bookmarks into
14       the user's set of bookmarks; if the user doesn't have any bookmarks
15       created yet, a new bookmark list is created and the given bookmarks are
16       inserted into it. While doing this, kbookmarkmerger keeps track of
17       which files were merged in a previous run already, so no bookmark will
18       get installed to the user's bookmarks more than once. In case KDE is
19       running while kbookmarkmerger is executed, the KDE bookmark subsystem
20       will be informed of any changes to the user's bookmarks, so that all
21       applications accessing that information (i.e.  Konqueror) will pick the
22       changes up instantly.
23
24       The traditionally used approach to achieve something like this was to
25       use carefully crafted skeleton home directories when creating a new
26       user account, to provide the user with a standard set of bookmarks. The
27       problem with this approach is that after the user account has been
28       created, no new bookmarks can be propagated.
29
30       This mechanism is useful for system administrators who want to
31       propagate a bookmark pointing to a certain document (for instance,
32       important notes about the system) to all users. Distributors might find
33       it useful as well, for instance by augmenting the software packages
34       they supply with bookmark files which kbookmarkmerger merges into the
35       user's bookmark list when the package is installed. That way,
36       documentation shipped with a software package is easily and visibly
37       accessible right after the package has been installed.
38
39       The only parameter required by kbookmarkmerger is the name of a
40       directory which shall be scanned for bookmark files. All files in the
41       given directory will be considered for being merged into the user's
42       setup. The files in the given directory should be valid XBEL files.
43

SEE ALSO

45       Konqueror manual[1]
46

EXAMPLES

48           joe@hal9000:~> kbookmarkmerger /usr/local/extra-bookmarks
49
50       Merges all bookmark files stored in /usr/local/extra-bookmarks into
51       joe's list of bookmarks.
52

STANDARDS

54           XBEL specification[2]
55

RESTRICTIONS

57       When determining whether a given bookmark file has been merged into the
58       user's bookmarks already or not, kbookmarkmerger merely looks at the
59       filename of the bookmark file - the contents are not checked at all.
60       This means that changing a bookmark file which was already merged into
61       a user's bookmarks will not trigger merging it once again.
62
63       Also note that in case a user modifies a bookmark which was merged into
64       his setup, the original bookmark file will be left unmodified.
65

AUTHOR

67       Frerich Raabe raabe@kde.org
68

AUTHOR

70       Frerich Raabe <raabe@kde.org>
71           Author.
72

NOTES

74        1. Konqueror manual
75           help:/konqueror/index.html
76
77        2. XBEL specification
78           http://pyxml.sourceforge.net/topics/xbel/
79
80
81
82K Desktop Environment         February 1st, 2005               KBOOKMARKMERGER
Impressum