cvs: /phpdoc/functions cpdf.sgml

rasmus Thu Nov 11 01:21:47 1999 EDT Modified files: /phpdoc/functions cpdf.sgml Log: Make this flow a bit better Index: phpdoc/functions/cpdf.sgml diff -u phpdoc/functions/cpdf.sgml:1.10 phpdoc/functions/cpdf.sgml:1.11 --- phpdoc/functions/cpdf.sgml:1.10 Wed Oct 20 18:41:42 1999 +++ phpdoc/functions/cpdf.sgml Thu Nov 11 01:21:46 1999 @@ -5,33 +5,33 @@ <partintro> <simpara> - ClibPDF allows to create pdf documents with PHP. It is available at - <ulink url="http://www.fastio.com">FastIO</ulink> but is not free + ClibPDF lets you create PDF documents with PHP. It is available at + <ulink url="http://www.fastio.com">FastIO</ulink> but it isn't free software. You should definitely read the licence before you start playing with ClibPDF. If you cannot fullfil the licence agreement consider using pdflib by Thomas Merz, which is also very powerful. - ClibPDF functionality and API is similar to Thomas Merz pdflib but - ClibPDF is, according to FastIO, faster and creates smaller documents. + ClibPDF functionality and API is similar to Thomas Merz's pdflib but, + according to FastIO, ClibPDF is faster and creates smaller documents. This may have changed with the new version 2.0 of pdflib. A simple benchmark (the pdfclock.c example from pdflib 2.0 turned into a php - script) actually show no difference in speed at all. The file size - is also similar if compression is turned off.</simpara> + script) actually shows no difference in speed at all. The file size + is also similar if compression is turned off. So, try them both + and see which one does the job for you.</simpara> <simpara> - This documentation should be read with the ClibPDF manual since it - explains much of the library in much more detail. Once you understand - the manual of ClibPDF you should be able to start using the library - with PHP.</simpara> + This documentation should be read alongside the ClibPDF manual since it + explains the library in much greater detail. + </simpara> <simpara> Many functions in the native ClibPDF and the PHP module, as well as in pdflib, have the same name. All functions except for - <function>cpdf_open</function> take as their first parameter the - handle for the document on which the function is to be performed. + <function>cpdf_open</function> take the handle for the document as + their first parameter. Currently this handle is not used internally since ClibPDF does not support the creation of several PDF documents at the same time. Actually, you should not even try it, the results are unpredictable. I - cannot oversee what the consequences in a multi threaded environment + can't oversee what the consequences in a multi threaded environment are. According to the author of ClibPDF this will change in one of the next releases (current version when this was written is 1.10). If you need this functionality use the pdflib module.</simpara>