[wp-meta] [Making WordPress.org] #197: Parser doesn't recognize line breaks and/or lists

[Making WordPress.org]

#197: Parser doesn't recognize line breaks and/or lists
---------------------------+-------------------------------------
  Reporter:  samuelsidler  |      Owner:
      Type:  defect        |     Status:  new
  Priority:  high          |  Component:  developer.wordpress.org
Resolution:                |   Keywords:
---------------------------+-------------------------------------

Comment (by nicole@…):

 I've looked into fixing this on the front end, and while `<pre>` does fix
 the spacing issue, the results are less than desired.

 Ultimately, this needs to be fixed from the back end. The parser needs to
 parse param array values in the docblock, and searching through the code
 (keep in mind, I'm not familiar with the intricacies of the parser) I see
 that there is a `getParsedDescription()` function in vendor/phpdocumentor
 /reflection-docblock/src/phpDocumentor/Reflection/DocBlock/Tag.php on line
 297 that appears to do just that.  Line 131 of lib/runner.php uses
 `getDescription()`, which is defined in that same Tag.php file on line
 270.

 So my thought is that the runner.php code is getting the tag description
 before it is parsed and it should be getting a parsed version of the tag
 description instead. If my thinking is correct, this should give us a
 multidimensional array providing the nested tags as separate objects that
 we can then properly output in the theme.

 I may be way off the mark, but thoughts?

--
Ticket URL: <https://meta.trac.wordpress.org/ticket/197#comment:5>
Making WordPress.org <https://meta.trac.wordpress.org/>
Making WordPress.org