Re: Removing warnings in doc

Le 5 nov. 2004, à 12:04, Nickolay V. Shmyrev a écrit :

> В Птн, 05/11/2004 в 11:38 +0100, Michèle Garoche пишет:
>>
>>
>> ______________________________________________________________________
>>
>> What do you think if I add systematically something equivalent to:
>>
>> /**
>> * cong_ui_hook_tree_new_sibling:
>> * @doc:
>> * @element_desc:
>> *
>> * TODO: Write me
>> */
>>
>> in all source files which are in the doc and generates in warning?
>>
>
> I think there is not much sense in such docs. Docs should be
> informative, otherwise, they only make maintainer work harder. Now we
> should fix warnings in exactly docs of the same type (with TODO: Write
> me).
>
> So, could you only fix all warnings that present currently in gtk-doc
> build? Thanks.
Yes, that was what I meant, see:

[quote]
>> which are in the doc and generates in warning
[/quote]

I meant at doc built time.

Or do you mean, there should not be TODO: Write me?
If this is the case, and you want my removing all TODO: Write me, then 
the doc at build time will generate 10 pages of warnings.

But that was only a proposal, if it is not wanted, it's also good for 
me (less work :-).

Michèle
<http://micmacfr.homeunix.org>

_______________________________________________
Conglomerate-devel mailing list
[email protected]
http://lists.copyleft.no/mailman/listinfo/conglomerate-devel