vrana Fri Aug 13 08:05:17 2004 EDT
Modified files:
/phpdoc/scripts check-references.php
/phpdoc/en/reference/pdf/functions pdf-add-bookmark.xml
pdf-findfont.xml
pdf-get-value.xml
pdf-open-file.xml
pdf-open-image-file.xml
pdf-setcolor.xml
pdf-show-boxed.xml
pdf-stringwidth.xml
Log:
Parameters are not optional anymore (confirmed by pdflib.de)
http://cvs.php.net/diff.php/phpdoc/scripts/check-references.php?r1=1.3&r2=1.4&ty=u
Index: phpdoc/scripts/check-references.php
diff -u phpdoc/scripts/check-references.php:1.3 phpdoc/scripts/check-references.php:1.4
--- phpdoc/scripts/check-references.php:1.3 Thu Aug 12 14:10:51 2004
+++ phpdoc/scripts/check-references.php Fri Aug 13 08:05:16 2004
@@ -116,7 +116,6 @@
"tcpwrap_check",
"get_headers",
"wddx_packet_end",
- "pdf_add_bookmark", "pdf_findfont", "pdf_get_value", "pdf_open_file",
"pdf_open_image_file", "pdf_setcolor", "pdf_show_boxed", "pdf_stringwidth",
"apd_echo",
"fdf_set_on_import_javascript",
);
http://cvs.php.net/diff.php/phpdoc/en/reference/pdf/functions/pdf-add-bookmark.xml?r1=1.5&r2=1.6&ty=u
Index: phpdoc/en/reference/pdf/functions/pdf-add-bookmark.xml
diff -u phpdoc/en/reference/pdf/functions/pdf-add-bookmark.xml:1.5
phpdoc/en/reference/pdf/functions/pdf-add-bookmark.xml:1.6
--- phpdoc/en/reference/pdf/functions/pdf-add-bookmark.xml:1.5 Mon Dec 15 11:52:51
2003
+++ phpdoc/en/reference/pdf/functions/pdf-add-bookmark.xml Fri Aug 13 08:05:16
2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
<!-- splitted from ./en/functions/pdf.xml, last change in rev 1.42 -->
<refentry id="function.pdf-add-bookmark">
<refnamediv>
@@ -12,8 +12,8 @@
<type>int</type><methodname>pdf_add_bookmark</methodname>
<methodparam><type>resource</type><parameter>pdfdoc</parameter></methodparam>
<methodparam><type>string</type><parameter>text</parameter></methodparam>
- <methodparam
choice="opt"><type>int</type><parameter>parent</parameter></methodparam>
- <methodparam
choice="opt"><type>int</type><parameter>open</parameter></methodparam>
+ <methodparam><type>int</type><parameter>parent</parameter></methodparam>
+ <methodparam><type>int</type><parameter>open</parameter></methodparam>
</methodsynopsis>
<para>
Add a nested bookmark under <parameter>parent</parameter>, or a new top-level
@@ -21,6 +21,8 @@
which may be used as parent for subsequent nested bookmarks.
If <parameter>open</parameter> = 1, child bookmarks will be folded out, and
invisible if <parameter>open</parameter> = 0.
+ Parameters <parameter>parent</parameter> and <parameter>open</parameter>
+ were optional before PHP 5.
</para>
<para>
<example>
http://cvs.php.net/diff.php/phpdoc/en/reference/pdf/functions/pdf-findfont.xml?r1=1.5&r2=1.6&ty=u
Index: phpdoc/en/reference/pdf/functions/pdf-findfont.xml
diff -u phpdoc/en/reference/pdf/functions/pdf-findfont.xml:1.5
phpdoc/en/reference/pdf/functions/pdf-findfont.xml:1.6
--- phpdoc/en/reference/pdf/functions/pdf-findfont.xml:1.5 Tue Jul 27 00:48:55
2004
+++ phpdoc/en/reference/pdf/functions/pdf-findfont.xml Fri Aug 13 08:05:16 2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
<!-- splitted from ./en/functions/pdf.xml, last change in rev 1.42 -->
<refentry id="function.pdf-findfont">
<refnamediv>
@@ -13,7 +13,7 @@
<methodparam><type>resource</type><parameter>pdfdoc</parameter></methodparam>
<methodparam><type>string</type><parameter>fontname</parameter></methodparam>
<methodparam><type>string</type><parameter>encoding</parameter></methodparam>
- <methodparam
choice="opt"><type>int</type><parameter>embed</parameter></methodparam>
+ <methodparam><type>int</type><parameter>embed</parameter></methodparam>
</methodsynopsis>
<para>
Prepare a font for later use with <function>pdf_setfont</function>.
@@ -23,6 +23,7 @@
<literal>macroman</literal>, <literal>winansi</literal>,
<literal>host</literal>, a user-defined encoding name or the name of
a CMap.
+ Parameter <parameter>embed</parameter> was optional before PHP 5.
</para>
<para>
<function>pdf_findfont</function> returns a font handle or &false;
http://cvs.php.net/diff.php/phpdoc/en/reference/pdf/functions/pdf-get-value.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc/en/reference/pdf/functions/pdf-get-value.xml
diff -u phpdoc/en/reference/pdf/functions/pdf-get-value.xml:1.4
phpdoc/en/reference/pdf/functions/pdf-get-value.xml:1.5
--- phpdoc/en/reference/pdf/functions/pdf-get-value.xml:1.4 Sat Aug 9 00:31:33
2003
+++ phpdoc/en/reference/pdf/functions/pdf-get-value.xml Fri Aug 13 08:05:16 2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/pdf.xml, last change in rev 1.42 -->
<refentry id="function.pdf-get-value">
<refnamediv>
@@ -12,10 +12,11 @@
<type>float</type><methodname>pdf_get_value</methodname>
<methodparam><type>resource</type><parameter>pdfdoc</parameter></methodparam>
<methodparam><type>string</type><parameter>key</parameter></methodparam>
- <methodparam
choice="opt"><type>float</type><parameter>modifier</parameter></methodparam>
+ <methodparam><type>float</type><parameter>modifier</parameter></methodparam>
</methodsynopsis>
<para>
Get the contents of some PDFlib parameter with float type.
+ Parameter <parameter>modifier</parameter> was optional before PHP 5.
</para>
</refsect1>
</refentry>
http://cvs.php.net/diff.php/phpdoc/en/reference/pdf/functions/pdf-open-file.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc/en/reference/pdf/functions/pdf-open-file.xml
diff -u phpdoc/en/reference/pdf/functions/pdf-open-file.xml:1.4
phpdoc/en/reference/pdf/functions/pdf-open-file.xml:1.5
--- phpdoc/en/reference/pdf/functions/pdf-open-file.xml:1.4 Sat Aug 9 00:31:34
2003
+++ phpdoc/en/reference/pdf/functions/pdf-open-file.xml Fri Aug 13 08:05:16 2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/pdf.xml, last change in rev 1.42 -->
<refentry id="function.pdf-open-file">
<refnamediv>
@@ -11,14 +11,16 @@
<methodsynopsis>
<type>bool</type><methodname>pdf_open_file</methodname>
<methodparam><type>resource</type><parameter>pdfdoc</parameter></methodparam>
- <methodparam
choice="opt"><type>string</type><parameter>filename</parameter></methodparam>
+ <methodparam><type>string</type><parameter>filename</parameter></methodparam>
</methodsynopsis>
<para>
Create a new PDF file using the supplied file name.
If <parameter>filename</parameter> is empty the PDF document
will be generated in memory instead of on file. The result
must be fetched by the client with the
- <function>pdf_get_buffer</function> function. &return.success;
+ <function>pdf_get_buffer</function> function.
+ Parameter <parameter>filename</parameter> was optional before PHP 5.
+ &return.success;
</para>
<para>
The following example shows how to create a pdf document in memory
http://cvs.php.net/diff.php/phpdoc/en/reference/pdf/functions/pdf-open-image-file.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc/en/reference/pdf/functions/pdf-open-image-file.xml
diff -u phpdoc/en/reference/pdf/functions/pdf-open-image-file.xml:1.4
phpdoc/en/reference/pdf/functions/pdf-open-image-file.xml:1.5
--- phpdoc/en/reference/pdf/functions/pdf-open-image-file.xml:1.4 Thu Aug 12
14:11:59 2004
+++ phpdoc/en/reference/pdf/functions/pdf-open-image-file.xml Fri Aug 13 08:05:16
2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/pdf.xml, last change in rev 1.42 -->
<refentry id="function.pdf-open-image-file">
<refnamediv>
@@ -13,17 +13,19 @@
<methodparam><type>resource</type><parameter>pdfdoc</parameter></methodparam>
<methodparam><type>string</type><parameter>imagetype</parameter></methodparam>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
- <methodparam
choice="opt"><type>string</type><parameter>stringparam</parameter></methodparam>
- <methodparam
choice="opt"><type>int</type><parameter>intparam</parameter></methodparam>
+ <methodparam><type>string</type><parameter>stringparam</parameter></methodparam>
+ <methodparam><type>int</type><parameter>intparam</parameter></methodparam>
</methodsynopsis>
<para>
Open an image file. Supported types are <literal>jpeg</literal>,
<literal>tiff</literal>, <literal>gif</literal>, and <literal>png</literal>.
- <parameter>stringparam</parameter> is either <literal></literal>,
+ <parameter>stringparam</parameter> is either empty,
<literal>mask</literal>, <literal>masked</literal>, or
<literal>page</literal>.
- <parameter>intparam</parameter>is either 0, the image id
+ <parameter>intparam</parameter> is either 0, the image id
of the applied mask, or the page.
+ Parameters <parameter>stringparam</parameter> and
+ <parameter>intparam</parameter> were optional before PHP 5.
</para>
</refsect1>
</refentry>
http://cvs.php.net/diff.php/phpdoc/en/reference/pdf/functions/pdf-setcolor.xml?r1=1.6&r2=1.7&ty=u
Index: phpdoc/en/reference/pdf/functions/pdf-setcolor.xml
diff -u phpdoc/en/reference/pdf/functions/pdf-setcolor.xml:1.6
phpdoc/en/reference/pdf/functions/pdf-setcolor.xml:1.7
--- phpdoc/en/reference/pdf/functions/pdf-setcolor.xml:1.6 Wed Dec 3 06:06:44
2003
+++ phpdoc/en/reference/pdf/functions/pdf-setcolor.xml Fri Aug 13 08:05:16 2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
<!-- splitted from ./en/functions/pdf.xml, last change in rev 1.42 -->
<refentry id="function.pdf-setcolor">
<refnamediv>
@@ -14,9 +14,9 @@
<methodparam><type>string</type><parameter>type</parameter></methodparam>
<methodparam><type>string</type><parameter>colorspace</parameter></methodparam>
<methodparam><type>float</type><parameter>c1</parameter></methodparam>
- <methodparam
choice="opt"><type>float</type><parameter>c2</parameter></methodparam>
- <methodparam
choice="opt"><type>float</type><parameter>c3</parameter></methodparam>
- <methodparam
choice="opt"><type>float</type><parameter>c4</parameter></methodparam>
+ <methodparam><type>float</type><parameter>c2</parameter></methodparam>
+ <methodparam><type>float</type><parameter>c3</parameter></methodparam>
+ <methodparam><type>float</type><parameter>c4</parameter></methodparam>
</methodsynopsis>
<para>
Set the current color space and color. &return.success;
@@ -32,6 +32,8 @@
space specified by <parameter>colorspace</parameter>. Except as
otherwise noted, the color components are floating-point values that
range from 0 to 1.
+ Parameters <parameter>c2</parameter>, <parameter>c3</parameter> and
+ <parameter>c4</parameter> were optional before PHP 5.
</para>
<para>
For <literal>gray</literal> only <parameter>c1</parameter> is used.
http://cvs.php.net/diff.php/phpdoc/en/reference/pdf/functions/pdf-show-boxed.xml?r1=1.5&r2=1.6&ty=u
Index: phpdoc/en/reference/pdf/functions/pdf-show-boxed.xml
diff -u phpdoc/en/reference/pdf/functions/pdf-show-boxed.xml:1.5
phpdoc/en/reference/pdf/functions/pdf-show-boxed.xml:1.6
--- phpdoc/en/reference/pdf/functions/pdf-show-boxed.xml:1.5 Tue Sep 30 04:33:40
2003
+++ phpdoc/en/reference/pdf/functions/pdf-show-boxed.xml Fri Aug 13 08:05:16
2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
<!-- splitted from ./en/functions/pdf.xml, last change in rev 1.42 -->
<refentry id="function.pdf-show-boxed">
<refnamediv>
@@ -17,7 +17,7 @@
<methodparam><type>float</type><parameter>width</parameter></methodparam>
<methodparam><type>float</type><parameter>height</parameter></methodparam>
<methodparam><type>string</type><parameter>mode</parameter></methodparam>
- <methodparam
choice="opt"><type>string</type><parameter>feature</parameter></methodparam>
+ <methodparam><type>string</type><parameter>feature</parameter></methodparam>
</methodsynopsis>
<para>
Format <parameter>text</parameter> in the current font and size into the
@@ -28,6 +28,7 @@
If <parameter>width</parameter> and <parameter>height</parameter> are 0,
only a single line is placed at the point (<parameter>left</parameter>,
<parameter>top</parameter>) in the requested <parameter>mode</parameter>.
+ Parameter <parameter>feature</parameter> was optional before PHP 5.
</para>
<para>
Returns the number of characters that did not fit in the specified
http://cvs.php.net/diff.php/phpdoc/en/reference/pdf/functions/pdf-stringwidth.xml?r1=1.5&r2=1.6&ty=u
Index: phpdoc/en/reference/pdf/functions/pdf-stringwidth.xml
diff -u phpdoc/en/reference/pdf/functions/pdf-stringwidth.xml:1.5
phpdoc/en/reference/pdf/functions/pdf-stringwidth.xml:1.6
--- phpdoc/en/reference/pdf/functions/pdf-stringwidth.xml:1.5 Sat Aug 9 00:31:34
2003
+++ phpdoc/en/reference/pdf/functions/pdf-stringwidth.xml Fri Aug 13 08:05:16
2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
<!-- splitted from ./en/functions/pdf.xml, last change in rev 1.42 -->
<refentry id="function.pdf-stringwidth">
<refnamediv>
@@ -12,8 +12,8 @@
<type>float</type><methodname>pdf_stringwidth</methodname>
<methodparam><type>resource</type><parameter>pdfdoc</parameter></methodparam>
<methodparam><type>string</type><parameter>text</parameter></methodparam>
- <methodparam
choice="opt"><type>int</type><parameter>font</parameter></methodparam>
- <methodparam
choice="opt"><type>float</type><parameter>size</parameter></methodparam>
+ <methodparam><type>int</type><parameter>font</parameter></methodparam>
+ <methodparam><type>float</type><parameter>size</parameter></methodparam>
</methodsynopsis>
<para>
Returns the width of <parameter>text</parameter> using the last
@@ -23,6 +23,8 @@
calculated using that font and size instead. Please note that
<parameter>font</parameter> is a font handle returned by
<function>pdf_findfont</function>.
+ Parameters <parameter>font</parameter> and <parameter>size</parameter>
+ were optional before PHP 5.
</para>
<note>
<para>
