Man Linux: Main Page and Category List

NAME

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

SYNOPSIS

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

DESCRIPTION

       kbookmarkmerger is a program for merging a given set of bookmarks  into
       the  user's  set  of  bookmarks; if the user doesn't have any bookmarks
       created yet, a new bookmark list is created and the given bookmarks are
       inserted  into  it.  While  doing  this, kbookmarkmerger keeps track of
       which files were merged in a previous run already, so no bookmark  will
       get  installed  to  the user's bookmarks more than once. In case KDE is
       running while kbookmarkmerger is executed, the KDE  bookmark  subsystem
       will  be  informed  of any changes to the user's bookmarks, so that all
       applications accessing that information (i.e.  Konqueror) will pick the
       changes up instantly.

       The  traditionally  used approach to achieve something like this was to
       use carefully crafted skeleton home directories  when  creating  a  new
       user account, to provide the user with a standard set of bookmarks. The
       problem with this approach is that after  the  user  account  has  been
       created, no new bookmarks can be propagated.

       This  mechanism  is  useful  for  system  administrators  who  want  to
       propagate a bookmark pointing to  a  certain  document  (for  instance,
       important notes about the system) to all users. Distributors might find
       it useful as well, for instance by  augmenting  the  software  packages
       they  supply  with bookmark files which kbookmarkmerger merges into the
       user's  bookmark  list  when  the  package  is  installed.  That   way,
       documentation  shipped  with  a  software package is easily and visibly
       accessible right after the package has been installed.

       The only parameter  required  by  kbookmarkmerger  is  the  name  of  a
       directory  which  shall be scanned for bookmark files. All files in the
       given directory will be considered for being  merged  into  the  user's
       setup. The files in the given directory should be valid XBEL files.

SEE ALSO

       Konqueror manual: help:/konqueror/index.html

EXAMPLES

              joe@hal9000:~> kbookmarkmerger /usr/local/extra-bookmarks

       Merges  all  bookmark  files  stored in /usr/local/extra-bookmarks into
       joe's list of bookmarks.

STANDARDS

       XBEL specification: http://pyxml.sourceforge.net/topics/xbel/

RESTRICTIONS

       When determining whether a given bookmark file has been merged into the
       user's  bookmarks  already  or not, kbookmarkmerger merely looks at the
       filename of the bookmark file - the contents are not  checked  at  all.
       This  means that changing a bookmark file which was already merged into
       a user's bookmarks will not trigger merging it once again.

       Also note that in case a user modifies a bookmark which was merged into
       his setup, the original bookmark file will be left unmodified.

AUTHOR

       Frerich Raabe  <raabe@kde.org>

AUTHOR

       Frerich Raabe.