mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/Popups
synced 2024-11-24 15:44:09 +00:00
bffa3178d5
Our documentation generator Doxygen is not able to understand @var tags on constants. A constant is neither a "variable", nor is it possibly to specify an allowed type for a constant. The type of a constant is strictly derived from it's value. There is no way to change it, other than changing the constant itself. There is not much value in repeating the type either. If it's critical to know the type of a constant (which is a very rare situation), that should be better explained in the comment. Doxygen strips all @… tags it does not understand, and renders everything else as a plain string. This makes it possible to use something like: /** * @const Description… */ But this is not different from: /** * Description… */ Change-Id: I4531d4f6b2ab2aca7a62f13f10a655f31c4d6a7a |
||
---|---|---|
.. | ||
EventLogger.php | ||
EventLoggerFactory.php | ||
MWEventLogger.php | ||
NullLogger.php |