The Python documentation should borrow the idea from the PHP.net

Documentation
46

Thanks for your valuable input, I would also be fine with a link to a useful tutorial on how to use the function, we all just need to create an agreement on where to put it and how.