Re: 1.9 API review
From: Julian Foad <julianfoad_at_btopenworld.com>
Date: Thu, 5 Mar 2015 14:23:37 +0000
Stefan Fuhrmann wrote:
I have adopted the practice of identifying functions with () in Doxygen doc strings because Doxygen recognizes that syntax and it's much neater than prefixing with '@c' or anything else. Inside '@see' Doxygen seems to assume (I'm only guessing) that every word is an identifier if it can find it, so the parentheses may be redundant in that particular context, but elsewhere they are valuable.
This is an archived mail posted to the Subversion Dev mailing list.