1KBOOKMARKMERGER KDE User's Manual KBOOKMARKMERGER
2
6 kbookmarkmerger - A program for merging a given set of bookmarks into
7 the user's list of bookmarks.
8
10 kbookmarkmerger [Qt Options...] [KDE Options...] {directory}
11
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 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 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 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
45 Konqueror manual[1]
46
48 joe@hal9000:~> kbookmarkmerger /usr/local/extra-bookmarks
49 Merges all bookmark files stored in /usr/local/extra-bookmarks into
51 joe's list of bookmarks.
52
54 XBEL specification[2]
55
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 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
67 Frerich Raabe raabe@kde.org
68
70 Frerich Raabe <raabe@kde.org>
71 Author.
72
74 1. Konqueror manual
75 help:/konqueror/index.html
76 2. XBEL specification
78 http://pyxml.sourceforge.net/topics/xbel/
79K Desktop Environment February 1st, 2005 KBOOKMARKMERGER