GNOME Bugzilla – Bug 61345
markup for non-crossreferenced functions/symbols
Last modified: 2004-12-22 21:47:04 UTC
The following patch makes the (), # abbreviations emit proper DocBook markup for non-crossreferenced functions and symbols, so that eg occurrences of strlen() in inline docs will come out as <tt>strlen()</tt> in html.
Created attachment 5724 [details] [review] the patch
Damon, while I have your attention. How do you think about this patch ?
Reassigning all open gtk-doc bugs to gtk-doc-maint
http://www.docbook.org/tdg/en/html/type.html lists <link> as a possible child of <type>. Did that change? Also, why the _ for _tagify?
Hmm, don't know what version of Docbook I was using when I wrote that patch... the Docbook V3.1 docs also list like as child of type... I'll rework the patch and remove the _ at the same time.
Wishful reading on our part. If you read that page carefully, you'll notice that <link> is a possible *parent* of <type>, not a child. But as always, there's a different solution: We can simply put the semantic markup (<type>, <function>, etc) inside the <link>. Here is a patch which achieves this by giving MarkXRef a second, optional parameter. This has been tested with sgml and xml mode and all of the GTK+ stack docs. I'm going to commit this.
Created attachment 17771 [details] [review] revised patch