phpdoc-parser icon indicating copy to clipboard operation
phpdoc-parser copied to clipboard

Add support for parsing docs for single constants

Open DrewAPicture opened this issue 7 years ago • 1 comments

The parser already technically supports parsing constants, but the attached PR hooks them up to a new post type and retrieves the associated documentation. We can add post type / editing / display support at a later time in the wporg-developer theme, but it would be nice to be actually storing the descriptions somewhere.

PR: #203

It should be noted that parsing DocBlock template support is not yet available in phpDocumentor, which means core WordPress is kind of out of luck with the current state of constants documented in wp-config.php. Templates are the ability to document multiple elements at the same time, e.g.

/**#@+
 * DocBlock Template example: One summary for all.
 *
 * One description for all.
 *
 * @since 2.6.0
 */
define('AUTH_KEY',         '...');
define('SECURE_AUTH_KEY',  '...');
define('LOGGED_IN_KEY',    '...');
define('NONCE_KEY',        '...');
define('AUTH_SALT',        '...');
define('SECURE_AUTH_SALT', '...');
define('LOGGED_IN_SALT',   '...');
define('NONCE_SALT',       '...');

/**#@-*/

DrewAPicture avatar Nov 01 '18 00:11 DrewAPicture

Also worth noting that it might be possible to set up our own reflector to parse params/args passed when defining the constants. As it stands, phpDocumentor\Reflection\ConstantReflector doesn't support param/argument retrieval.

DrewAPicture avatar Nov 01 '18 00:11 DrewAPicture