[nem-en] Documentation comments clarification and proposals [Long]

[Michal Moskal]

On 11/9/06, NoiseEHC <NoiseEHC at freemail.hu> wrote:
> I would strongly suggest that we should not treat case 1) and 3) as
> legal, so we should force the use of xml comments (2).

I strongly object to write any XML by hand (XML is for machines, not
us, pure human beings!), so I'm finding the proposal very appealing.

> If it would be too much work then I will go trough the nemerle codebase
> and 'prettyze' comments.
> BTW it is new to me that xml comments work in /** ... */ Maybe I am not
> that C# king? :)
> With the other tags I would suggest to have 99% C# compatibility. What I
> would like to see some easier method to include
> comment for params so that is the only thing I would call acceptable.
>
> ps:
> What is this google group? Is devel-en is obsolete?

Nah, the google group was there to replace the forum, but I guess it
didn't work out very well :/

-- 
   Michał