Re: Patch to warn on source/template collision

[Damon Chaplin <damon ximian com>]

On Thu, 2002-04-25 at 21:38, Owen Taylor wrote:
> 
> Here's a patch to make gtkdoc warn if a symbol is documented both
> inline and in the template files.
> 
> Look OK to people?

It only overrides parameter descriptions, though. The function/struct
etc. description from the template file is appended to the inline one.
(I'm not sure if anyone is using that feature in any way, e.g. by
putting a short description inline, and a longer one in the templates.)

So maybe it should only warn if a parameter description is non-empty and
is overridden, i.e. where it does this:

	# Override the description.
	$$tmpl_params[$j + 1] = $param_desc ;

You can check if $tmpl_param_desc ne "" and output a warning.

Damon