Menu

#26 Redundant whitespace in JavaDoc-style function comment

Latest git
closed-fixed
5
2010-02-19
2008-01-03
No

In the following (taken from the latest version in CVS):

>>>
(defconst doxymacs-JavaDoc-function-comment-template
'((let ((next-func (doxymacs-find-next-func)))
(if next-func
(list
'l
"/** " '> 'n
" * " 'p '> 'n
" * " '> 'n
<<<

I think the last three lines could be changed in the following way by removing whitespace from the first and third:

>>>
"/**" '> 'n
" * " 'p '> 'n
" *" '> 'n
<<<

in order to remove redundant trailing whitespace. Unlike in bug #1496398, I don't think this whitespace is needed to make things line up properly, as the first and third lines would not have text appended to them in a comment like this:

>>>
/**
* Some function description
*
* @param[in] x Horizontal axis co-ordinate
<<<

I assume this matches the expected style - in the Doxygen manual's examples, there is no text on the "/**" line, and although there isn't a blank line between the description and the first parameter, I assume you like that (I do too) since the template puts the extra line there.

I made a similar change to my custom template which I use with Doxymacs 1.7.0 and it "works" at least for my definition of "works".

Discussion

  • Ryan T. Sammartino

    • status: open --> closed-fixed
     

Log in to post a comment.