Jani Taskinen wrote:

> On Wed, 24 Jan 2001, Uwe Steinmann wrote:
> >On Wed, Jan 24, 2001 at 03:07:09PM +0100, Cynic wrote:
> >> confuse folks. and the consensus (at least I got it it's agreed
> >> on) is pdf_add_local_link-like names.
> >>From the php point of view there should be underscores but
> >the pdflib api doesn't use them except for the one after the 'pdf'.
> >The question is, shall we enforce the php naming or allow the
> >pdflib naming.
> This API is used in PHP -> use the PHP naming. If we start making
> exceptions we end up having a mess in our hands.. :)

This is the same problem for us. We have to support eight (number is
still growing) PDFlib language bindings including documentation and
samples, on differnent plattforms. So it is very essential for us to have
a consistent API and documentation. We cannot afford to duplicate the
whole PDFlib-Manual for each language binding, and therefore strive to
supply a single unified reference Manual for all languages. The benefit
for the developer is that allwas has access to the latest and
comprehensive PDFlib documentation. The maintainers not neccesarly have
to duplicate the manual into the PHP documentation. Even another little
detail, if somebody changes from i.e. ASP to php they can simply reuse
the pdflib-code :-)

> >There are probably other points which need to be discussed like
> >what a function should return if it fails. Many php functions return
> >false but pdflib's api requires to return -1.
> Again, we should be consistant within PHP the language.
> ie. if function fails -> RETURN_FALSE.

After some discussion with Thomas, we are convinced to do it the php way.
The extension will take care to convert the PDFlib error convention to
PHP conventions. In addition PDFlib exceptions are mapped to php_error().

> IMO.
> --Jani

Rainer + Thomas ([EMAIL PROTECTED])
Rainer Schaaf       [EMAIL PROTECTED]        http://www.pdflib.com
_______PDFlib - a library for generating PDF on the fly________

PHP Development Mailing List <http://www.php.net/>
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
To contact the list administrators, e-mail: [EMAIL PROTECTED]

Reply via email to