How to use gen_stub.php?

[AllenJB]

I was attempting to document the currently undocumented litespeed (SAPI) functions, creating a new book similar to that for apache / fpm.

According to the docs I should be able to use gen_stub.php to bootstrap this using the stubs in php-src. However I can't get it to actually appear to do anything - it generates no files, and emits no errors.

The best existing documentation I can find is in docs/editing.md, and gen_stub.php -h, but these are very light on detail and aren't helping.

I'm almost certainly doing something "stupid" like running it with the wrong parameters, or not in the correct directory, but without any feedback I can't tell what.

Please can someone provide a step-by-step for basic usage?

(And while we're here, are there any other additional steps I should be aware of when creating a new book?)

[ndossche]

You're probably looking for the --generate-methodsynopses option.