1KBOOKMARKMERGER          kbookmarkmerger 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 {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.
19
20       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
26       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
35       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

SEE ALSO

41           Konqueror manual[1]
42           kf5options(7)
43

EXAMPLES

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

STANDARDS

51           XBEL specification[2]
52

RESTRICTIONS

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
60       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

AUTHOR

64       Frerich Raabe <raabe@kde.org>
65

AUTHOR

67       Frerich Raabe <raabe@kde.org>
68           Author.
69

NOTES

71        1. Konqueror manual
72           help:/konqueror/index.html
73
74        2. XBEL specification
75           http://pyxml.sourceforge.net/topics/xbel/
76
77
78
79KDE Applications Applications     2016-11-07                   KBOOKMARKMERGER
Impressum