1KBOOKMARKMERGER(1) KDE User's Manual KBOOKMARKMERGER(1)
2
3
4
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
12
14 kbookmarkmerger is a program for merging a given set of bookmarks into
15 the user's set of bookmarks; if the user doesn't have any bookmarks
16 created yet, a new bookmark list is created and the given bookmarks are
17 inserted into it. While doing this, kbookmarkmerger keeps track of
18 which files were merged in a previous run already, so no bookmark will
19 get installed to the user's bookmarks more than once. In case KDE is
20 running while kbookmarkmerger is executed, the KDE bookmark subsystem
21 will be informed of any changes to the user's bookmarks, so that all
22 applications accessing that information (i.e. Konqueror) will pick the
23 changes up instantly.
24
25
26 The traditionally used approach to achieve something like this was to
27 use carefully crafted skeleton home directories when creating a new us‐
28 er account, to provide the user with a standard set of bookmarks. The
29 problem with this approach is that after the user account has been cre‐
30 ated, no new bookmarks can be propagated.
31
32
33 This mechanism is useful for system administrators who want to propa‐
34 gate a bookmark pointing to a certain document (for instance, important
35 notes about the system) to all users. Distributors might find it useful
36 as well, for instance by augmenting the software packages they supply
37 with bookmark files which kbookmarkmerger merges into the user's book‐
38 mark list when the package is installed. That way, documentation
39 shipped with a software package is easily and visibly accessible right
40 after the package has been installed.
41
42
43 The only parameter required by kbookmarkmerger is the name of a direc‐
44 tory which shall be scanned for bookmark files. All files in the given
45 directory will be considered for being merged into the user's setup.
46 The files in the given directory should be valid XBEL files.
47
48
50 Konqueror manual: help:/konqueror/index.html
51
52
54 joe@hal9000:~> kbookmarkmerger /usr/local/extra-bookmarks
55
56 Merges all bookmark files stored in /usr/local/extra-bookmarks into
57 joe's list of bookmarks.
58
59
61 XBEL specification: http://pyxml.sourceforge.net/topics/xbel/
62
63
65 When determining whether a given bookmark file has been merged into the
66 user's bookmarks already or not, kbookmarkmerger merely looks at the
67 filename of the bookmark file - the contents are not checked at all.
68 This means that changing a bookmark file which was already merged into
69 a user's bookmarks will not trigger merging it once again.
70
71
72 Also note that in case a user modifies a bookmark which was merged into
73 his setup, the original bookmark file will be left unmodified.
74
75
77 Frerich Raabe <raabe@kde.org>
78
79
81 Frerich Raabe.
82
83
84
85K Desktop Environment February 1st, 2005 KBOOKMARKMERGER(1)