ps_add_bookmark(3) [debian man page]

PS_ADD_BOOKMARK(3)					     Library Functions Manual						PS_ADD_BOOKMARK(3)

NAME

       PS_add_bookmark -- Add bookmark to current page

SYNOPSIS

       #include <pslib.h>

       int PS_add_bookmark(PSDoc *psdoc, const char *text, int parent, int open)

DESCRIPTION

       Adds  a bookmark for the current page. Bookmarks usually appear in PDF-Viewers left of the page in a hierachical tree.  Clicking on a book-
       mark will jump to the given page.

       The parameter parent is another bookmark which is used as the parent of the new bookmark. If open is unequal to zero the bookmark  will	be
       shown open by the pdf viewer.

       The  bookmark has no meaning if the document is printed or viewed but it will be used if the document is converted to pdf by either Acrobat
       Distillertm or Ghostview.

       The returned value is a reference for the bookmark. It is only used if the bookmark shall be used as a parent.

RETURN VALUE

       Returns the identifier of the bookmark or zero in case of an error.  The identifier is a positiv number.

SEE ALSO

       PS_add_launchlink(3), PS_add_pdflink(3), PS_add_weblink(3)

AUTHOR

       This manual page was written by Uwe Steinmann uwe@steinmann.cx.

																PS_ADD_BOOKMARK(3)

KBOOKMARKMERGER 
						 KDE User's Manual						   KBOOKMARKMERGER

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[1]

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[2]

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 <raabe@kde.org>
	   Author.

NOTES

	1. Konqueror manual
	   help:/konqueror/index.html

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

K Desktop Environment						February 1st, 2005						   KBOOKMARKMERGER