debian man page for ps_add_bookmark

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)