colour lib needs reviewers
Manu via Digitalmars-d
digitalmars-d at puremagic.com
Thu Sep 15 00:08:32 PDT 2016
On 15 September 2016 at 16:44, Walter Bright via Digitalmars-d
<digitalmars-d at puremagic.com> wrote:
> 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.
+1
More information about the Digitalmars-d
mailing list