Document stubs

[kocsismate]

I'm not a good writer, so feel free to suggest better wording/rephrase the text wherever needed :)

[iluuu1994]

Thank you! I did read this in detail. There are some grammatical oddities, but I'm not sure code reviews are a good tool to fix those.

Please check the README on how to auto-format the files.

Thank you for providing some documentation on the frameless calls 🙂

[iluuu1994]

I think you should start out explaining what problem stubs solve exactly, along with maybe a simple example of a stub and a function implementation.

[kocsismate]

I'll try to come up with a better intro.. I also felt that the current one is not very good :D

[iluuu1994]

Mostly, it is about not creating a stack frame, but passing arguments to the function directly via the ICALL operands. Hence the name "frameless".

[kocsismate]

Thank you! I did read this in detail. There are some grammatical oddities, but I'm not sure code reviews are a good tool to fix those.

Feel free to point these out/suggest a better wording, and I'll try to fix them! I wouldn't want to provide docs which scares native speakers.

[Girgias]

Mostly looks good just some nits

[derickr]

I could do quite a bit to make this easier to read — but would it make sense if I spend an hour on it?

[kocsismate]

@derickr just a gentle ping: will you have capacity on improving the wording in the near future?

[kocsismate]

With the help of Derick, the documentation was revamped :)

[Girgias]

LGTM

[kocsismate]

@iluuu1994 If you have followup suggestions, or anything comes to your mind which should be improved, feel free to reach out to me!

[kocsismate]

The documentation is now live at https://php.github.io/php-src/miscellaneous/stubs.html