On Mon, 2005-08-08 at 11:48 +0200, Stefan Kost wrote: > hello, > > I'd like to change all the OutputXXX function in gtkdoc-mkdb to write > not just > > <title><anchor id="xxx"/>yyy</title> > > but e.g. > > <title><anchor id="xxx" role="macro"/>yyy</title> > > instead. from the docbook point of view it is legal to use the 'role' > attribute for such purpose. [1][2] > > On the base of this the devhelp.xsl script can be extended to not just > write out 'function' tags. I spoke to the devhelp developers and they > would like to show the type of symbol e.g. by an icon or allow to filter > on symbol types. > > Other information that I'd like to go in there so that we can pass them > to devhelp are: > * deprecating status > * since > * stabillity > > The docbook anchor tag has to following attributes for application usage: > * Arch > * Condition > * Conformance > * Revision > * Security > * UserLevel > * Vendor > > 'Condition' sounds like a good candidate to me, but would require that > we pack the data into this attribute in a form, where devhelp can easily > pare it. If we make this extensible we can transport future data the > same way. I have something like this in my head: > > <title> > <anchor id="xxx" role="macro" condition="since:2.2|deprecated:2.8"/> > yyy > </title> > <title> > <anchor id="xxx" role="function" condition="since:2.6|deprecated"/> > yyy > </title> > > Any comments. Should I have a go at it?
It looks fine to me, and I think is fairly easy to do. Damon _______________________________________________ gtk-doc-list mailing list [email protected] http://mail.gnome.org/mailman/listinfo/gtk-doc-list
