Re: new gtk-doc release

[Damon Chaplin <damon karuna uklinux net>]

On Tue, 2005-07-05 at 11:16 -0400, Owen Taylor wrote:
> On Sun, 2005-07-03 at 23:12 +0100, Damon Chaplin wrote:
> > On Wed, 2005-05-25 at 09:37 +0200, Stefan Kost wrote:
> > > hi damon,
> > > 
> > > what do you think about making a new gtk-doc release? On guadec I do a BOF about 
> > > gstreamer api doc and among I suggest to move docs to the sources. when doing 
> > > this cleanup, it would be nice to move the long-description too.
> > 
> > I just did a new release, 1.4 (since I think the latest GTK+ depends on
> > a new gtk-doc).
> > 
> > I forgot to update NEWS though. Oops.
> 
> Don't put --only-section-tmpl into NEWS if you do update it ... it
> doesn't work :-(

I'd guess this is because MergeSourceDocumentation() in gtkdoc-mkdb.pl
uses the parameter names and order found in the templates.

You may just need to copy the parameter info from the sources over, as
we already do for signals. (Just a guess.)

   if (!defined ($tmpl_params)) {
       #print "No merge for $symbol\n";
+      $SymbolParams{$symbol} = $SourceSymbolParams{$symbol}
       next;
   }

Damon