From 9861c56baa2ab7e948cc9947dcc02641afb4469b Mon Sep 17 00:00:00 2001
From: Uwe Steinmann <steinm@php.net>
Date: Mon, 20 Dec 1999 08:37:26 +0000
Subject: [PATCH] - marked optional arguments propperly - completed
 documentation of pdf_set_font(), pdf_add_outline()

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@17611 c90b9560-bf6c-de11-be94-00142212c4b1
---
 functions/pdf.xml | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/functions/pdf.xml b/functions/pdf.xml
index be96e80e07..39335f4a8f 100644
--- a/functions/pdf.xml
+++ b/functions/pdf.xml
@@ -701,7 +701,7 @@ fclose($fp);
      <paramdef>string <parameter>font name</parameter></paramdef>
      <paramdef>double <parameter>size</parameter></paramdef>
      <paramdef>int <parameter>encoding</parameter></paramdef>
-     <paramdef>int <parameter>embed</parameter></paramdef>
+     <paramdef>int <parameter><optional>embed</optional></parameter></paramdef>
     </funcsynopsis>
     <para>
      The <function>PDF_set_font</function> function sets the
@@ -1709,14 +1709,21 @@ PDF_stroke($pdf);
    <refsect1>
     <title>Description</title>
     <funcsynopsis>
-     <funcdef>void <function>pdf_add_outline</function></funcdef>
+     <funcdef>int <function>pdf_add_outline</function></funcdef>
      <paramdef>int <parameter>pdf document</parameter></paramdef>
      <paramdef>string <parameter>text</parameter></paramdef>
+     <paramdef>int <parameter><optional>parent</optional></parameter></paramdef>
+     <paramdef>int <parameter><optional>open</optional></parameter></paramdef>
     </funcsynopsis>
     <para>
      The <function>PDF_add_outline</function> function adds a bookmark
-     with text <parameter>text</parameter> that points to the current page.</para>
-
+     with text <parameter>text</parameter> that points to the current page.
+     The bookmark is inserted as a child of <parameter>parent</parameter> and
+     is by default open if <parameter>open</parameter> is not 0. The
+     return value is an identifier for the bookmark which can be used
+     as a parent for other bookmarks. Therefore you can build up hierarchies
+     of bookmarks.
+    </para>
     <simpara>
      Unfortunately pdflib does not make a copy of the string, which forces
      PHP to allocate the memory. Currently this piece of memory is not