[PHP-DOC] Prematurely commited Documentation From: Alexander Wirtz (wirtz <email protected>)
Date: 03/27/01

Hi there,

today I was helping a guy creating PDF's with the PHP extension. He was
totally clueless, because he tried to orientate himself via the
documentation on www.php.net.
As I had a look at the current doc-version, I found out, that the docu
implements already the commands for the PDFLib 4.x _beta_ version.
Also the example-scripts are the ones from 4.x beta. Personally I deem this
a Very Bad Idea [TM], because for using the commands in the examples, a
user/developer has a) to use the PHP-CVS (thank god, that fact is made clear
on the individual command-docs) and b) has to use the beta version of
PDFLib, and that fact is _not_ apparent from the current documentation.
I would suggest, that until the status of PDFLib 4.x hasn't changed, you
should enable the old docu again, or change this docu to reflect the status
of the PDFLib.

I just found on the Docu, that you call the command pdf_open
depreciated (should be deprecated, shouldn't it?) ...using the current PDFLib
3.03 this is not the case, pdf_open is the appropriate command with this
version...so this is not a good idea either!

Please have in mind, that I'm no reader of this list, so please reply to my
mail address ;-)

Regards,
        Alexander 

-- 
| Alexander Wirtz           | eMail: wirtz <email protected>                |
| web <email protected> GmbH            | WWW:   http://www.web-active.com           |