On 9/14/2016 11:11 PM, Walter Bright wrote:
On 9/14/2016 2:31 PM, Andrei Alexandrescu wrote:
The resulting look is alien too, as opposed to the more familiar $MACRO(a1, a2,
a3) or the CPP-style MACRO(a1, a2, a3).
The $(MACRO a1, a2, a3) syntax comes from makefiles.
The original idea was to be able to write documentation without needing many
macros, if any. Such as this I wrote recently:
/**
* Provides a safe interface to the Posix stat() function.
*
* Detailed description that I didn't write for this function,
* but this is where it goes.
*
* Another paragraph.
*
* Params:
* path = file name
* buf = stat instance to be filled in
* Returns:
* 0 for success, system errno for error
*/
I suspect that adding Markdown would help a lot (yes, I changed my mind about
that). Also auto-detecting email addresses and urls and turning them into
clickable links would help.