I've run quite often into the situation where it would be really nice to have LaTex support for a documentation. Even while I'm primarly a coder I find it much easier to understand a mathematical formula which a method tries to implement than looking at a bunch of code that in some cases is difficult to read do to numerical improvements.

Proposal

A tag like:

@formula x = {-b \pm \sqrt{b^2-4ac} \over 2a}

which get's rendered using LaTex and would be such a big help for many classes and functions I'm working on.

Cons:

• Maybe this is only of limited use since the person implementing the code would need to know LaTex and math/physic formula implementations aren't the forte of PHP
• This doesn't improve the readability in the source code since the strength of this would only unfold in the generated documentation
• Additional documentation loading times

Pros:

• Much easier to read in generated documentation
• This could lead to potential plugins for IDEs to also implementing this feature
• Enforces a standard of writing formulas since other formula formats will not get rendered

For the implementation existing libraries could be used in order to minimize the work that needs to be put into an implementation (e.g. https://github.com/mathjax/MathJax).