VSCode, when showing a tool-tip for an Apex method, will show the description of that method as defined in the fairly standard format:
/** * States that the next method definition is expected to be called in the order it appears. * * If a method is subsequently called out of order, will fail the test. * * Calling 'verify' will check that all expectations have been met, failing the test if not. * * 'Expectations' take lower priority than 'whens' (I.E. if a matching 'when' is defined at call time, then it will match that over the next 'expect'). * * Define in the format: * expects() * .method( 'methodName' ) * .withParameter( 'parameterValue' ) * .returning( 'theValueItShouldReturn' ) */
However, it does not take into account the formatting of the comment, and renders it much like how you would expect text within HTML to be rendered.
Adding HTML or escaped characters does not help, as the tags and suchlike are rendered as is.
Is anyone aware of the format required in order to get formatting preserved, or explicitly state the formatting required?