On Mon, 2005-04-04 at 12:33 -0400, Owen Taylor wrote: > I think the question is whether advantages of the use of custom > tools ... whether specialized or extensions to gtk-doc ... is worth the > hassle of maintaining those tools, compared to just writing straight-up > docbook. Sure, it's painful to write: > > <link > linkend="pango-fc-font-lock-face"><function>pango_fc_font_lock_face()</function></link>
I think the original idea behind this was that I wanted to be able to generate nice-looking cross-refs for both html and pdf output. That way, I could put the intelligence required to generate the right linkends depending on the type of output tool. I have not had time to really attempt to generate nice pdf output with cross refs though. > > But if the tutorial is mostly already written, then it can be done automated > once and then just updated from there. yes. > > Another possibility would be to extend gtk-doc.dtd and gtk-doc.xsl to allow > > <gtkdocfunction function="pango_fc_lock_face"/> > > Or maybe > > <gtkdoclink target="#PangoFcFont"/> > > and then expand that out in the xsl. Though it means that we no longer have > standard docbook that can be processed by standard docbook tools. And doing > the function->id conversion in xsl might be hard. I have no idea how hard which is why I suggested to just hack it with perl code. regards, Mathieu _______________________________________________ gtk-doc-list mailing list [email protected] http://mail.gnome.org/mailman/listinfo/gtk-doc-list
