Frank Koenigstein wrote:
Dear PHP Documentation Team,
Hello Frank

In your documentation about the ming library, there is a detail about two important functions, that is only mentioned by a user in the comments section, but should be pointed out in a more official manner in the documentation itself. This affects the following pages:

http://www.php.net/manual/en/function.swfmovie.save.php
http://www.php.net/manual/en/function.swfmovie.output.php

instead of
void *swfmovie->save* ( string filename)
you should put it like
void *swfmovie->save* ( string filename [, int compressionlevel] )

and

instead of
void *swfmovie->output* ( void)
you should put
void *swfmovie->output* ( [int compressionlevel] )

The compression level can be a value between 0 and 9, defining the swf compression similar to gzip compression.

This detail about the ming library (which exists at least since version 0.3) can hardly be found anywhere on the internet, since it is not even documented by the creators of the library. But, I assure you, it would matter a lot to programmers using ming, who don't know about this yet and think you just have to take the disadvantage of 0 compression.

If you need to verify this hint before altering the documentation, I would be glad if I could help you in any way (example scripts, results, ...).

Here we are :) The ming documentation is pretty outdated and needs a lot of work. If you are ready to help, you could update it all. I just had a look in the sources and you are right for your two functions. I'll update the ptotos after ending this mail.


If you wan't to see how our documentation works, please read :

  http://fr.php.net/manual/howto/index.html

Basically, you'll need a copy of this folder :

  http://cvs.php.net/cvs.php/phpdoc/en/reference/ming

And some time to donate to the community :)

Feel free to contacts us back if you need more information and thank you a lot for your fixes.

Mehdi Achour

Reply via email to