Re: Removing warnings in doc
"Nickolay V. Shmyrev" <[email protected]>
| Newsgroups | gmane.editors.conglomerate.devel |
|---|---|
| Message-ID | <[email protected]> |
В Птн, 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. > It makes not the doc more useful (i.e. the description is not very > useful), but at least there will be less warnings. > > Or is it a very bad idea? > > Michèle > <http://micmacfr.homeunix.org > _______________________________________________ > Conglomerate-devel mailing list > [email protected] > http://lists.copyleft.no/mailman/listinfo/conglomerate-devel