dfmt options
ketmar via Digitalmars-d
digitalmars-d at puremagic.com
Sun Mar 15 06:33:07 PDT 2015
On Mon, 16 Mar 2015 02:19:08 +1300, Rikki Cattermole wrote:
> On 16/03/2015 2:16 a.m., ketmar wrote:
>> On Sun, 15 Mar 2015 16:32:25 +1300, Rikki Cattermole wrote:
>>
>>> This might be a bit of a out of scope, but auto generating of DDOC
>>> comments for symbols would be nice. Basically to enforce before e.g.
>>> committing that everything has been explained.
>>
>> this never helps. what sense of having "documentation" like "enum
>> SomeType" for `enum SomeType`?
>
> Ok enums probably wouldn't be. I'm more thinking of
> struct/classes/unions functions/methods properties and global variables.
> Maybe even head of module.
but that will be the same. formater has no AI, so it can't write
documentation. ;-) and copy-pasted definitions is not a documentation at
all. i've seen alot of doxygen examples of that, and it doesn't help a
little, i have to dig into sources anyway. either author did proper
documenting, or leave it as is, as generating stubs will not help.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 181 bytes
Desc: not available
URL: <http://lists.puremagic.com/pipermail/digitalmars-d/attachments/20150315/bfc0ca8c/attachment.sig>
More information about the Digitalmars-d
mailing list