colour lib needs reviewers

Walter Bright via Digitalmars-d digitalmars-d at puremagic.com
Wed Sep 14 23:44:16 PDT 2016


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.



More information about the Digitalmars-d mailing list