1KBOOKMARKMERGER kbookmarkmerger 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 {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.
19 The traditionally used approach to achieve something like this was to
21 use carefully crafted skeleton home directories when creating a new
22 user account, to provide the user with a standard set of bookmarks. The
23 problem with this approach is that after the user account has been
24 created, no new bookmarks can be propagated.
25 This mechanism is useful for system administrators who want to
27 propagate a bookmark pointing to a certain document (for instance,
28 important notes about the system) to all users. Distributors might find
29 it useful as well, for instance by augmenting the software packages
30 they supply with bookmark files which kbookmarkmerger merges into the
31 user's bookmark list when the package is installed. That way,
32 documentation shipped with a software package is easily and visibly
33 accessible right after the package has been installed.
34 The only parameter required by kbookmarkmerger is the name of a
36 directory which shall be scanned for bookmark files. All files in the
37 given directory will be considered for being merged into the user's
38 setup. The files in the given directory should be valid XBEL files.
39
41 Konqueror manual[1]
42 kf5options(7)
43
45 joe@hal9000:~> kbookmarkmerger /usr/local/extra-bookmarks
46 Merges all bookmark files stored in /usr/local/extra-bookmarks into
48 joe's list of bookmarks.
49
51 XBEL specification[2]
52
54 When determining whether a given bookmark file has been merged into the
55 user's bookmarks already or not, kbookmarkmerger merely looks at the
56 filename of the bookmark file - the contents are not checked at all.
57 This means that changing a bookmark file which was already merged into
58 a user's bookmarks will not trigger merging it once again.
59 Also note that in case a user modifies a bookmark which was merged into
61 his setup, the original bookmark file will be left unmodified.
62
64 Frerich Raabe <raabe@kde.org>
65
67 Frerich Raabe <raabe@kde.org>
68 Author.
69
71 1. Konqueror manual
72 help:/konqueror/index.html
73 2. XBEL specification
75 http://pyxml.sourceforge.net/topics/xbel/
76KDE Applications Applications 2016-11-07 KBOOKMARKMERGER