php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #30756 Lack of useful documentation for PDF extension
Submitted: 2004-11-11 00:32 UTC Modified: 2010-02-11 11:11 UTC
Votes:2
Avg. Score:4.5 ± 0.5
Reproduced:1 of 2 (50.0%)
Same Version:1 (100.0%)
Same OS:1 (100.0%)
From: tim dot lokot at printsoft dot com Assigned: rjs (profile)
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS: N/A
Private report: No CVE-ID: None
View Developer Edit
 [2004-11-11 00:32 UTC] tim dot lokot at printsoft dot com 
Description:
------------
This page is a prime example ... http://au.php.net/manual/en/function.pdf-place-image.php

For example, I have no way of telling from this manual page what the scale parameter means, does, how to use it, how to calculate it, etc.

Most of the manual pages for the PDF extension are as sparse (if not worse) than this.  Google doesn't seem to return many useful results either, neither can I readily locate the documentation on the pdflib website.

Can someone either update the documentation for this extension, or point the manual pages to where the documention for these functions can be found in more detail?

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2004-11-11 09:32 UTC] vrana@php.net 
PDFlib documentation is available at http://www.pdflib.com/products/pdflib/download/#Documentation . I agree with you that there should be a link to it in the PHP documentation. I agree also that the PHP documentation should be updated.
 [2004-11-11 17:16 UTC] sean@php.net 
Hi Tim,

The reason this extension (and others) have sparse documentation is that none of the (volunteer) documentation team members have had time/ambition to contribute to this section.

The Documentation HOWTO is http://php.net/manual/howto/index.html, and the mailing list is phpdoc@lists.php.net. Feel free to contribute patches, and eventually get a CVS account, so you can make your own contributions, directly.

S
 [2004-11-11 23:26 UTC] tim dot lokot at printsoft dot com 
The annoying part about that link is that if you want the english version, you have to download pdflib to extract it.  The english version is not downloadable seperately for some reason.

Believe me, if I could figure out this extension, I would happily contribute some documentation to it to save others the headaches.
 [2010-01-11 06:42 UTC] kalle@php.net 
Assigned to maintainer.

Rainer, this bug have been long standing and it seems like PDFLib have changed alot over the years, perhaps its worth re-generating the documentation using docgen?
 [2010-01-17 14:49 UTC] bjori@php.net 
This extension is old and no longer maintained.
 [2010-02-11 11:11 UTC] rjs@php.net 
PDFlib GmbH maintains PDF versions of the documentation only.

We support too many different programming languages to update language specific versions of the documentation.

As it seems to be too complicated to extract the documentation from the source/binary packages of PDFlib we now offer the documentation online on our webserver.

http://www.pdflib.com/developer/technical-documentation/manuals/

is the location for all available documentations.

For users of PDFlib Lite these documents are relevant:

http://www.pdflib.com/fileadmin/pdflib/pdf/manuals/PDFlib-7-tutorial.pdf
http://www.pdflib.com/fileadmin/pdflib/pdf/manuals/PDFlib-7-API-reference.pdf
 
PHP Copyright © 2001-2025 The PHP Group
All rights reserved. 		Last updated: Sat Jul 05 17:01:34 2025 UTC