[Bug 27878] some generated comments are so wide they can't be parsed by flex (for Vala bindings)

[bugzilla-daemon at freedesktop.org]

https://bugs.freedesktop.org/show_bug.cgi?id=27878

Danielle Madeley <danielle.madeley at collabora.co.uk> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                URL|                            |http://git.collabora.co.uk/
                   |                            |?p=user/danni/telepathy-gli
                   |                            |b.git;a=shortlog;h=refs/hea
                   |                            |ds/readable-docstrings
           Keywords|                            |patch

--- Comment #2 from Danielle Madeley <danielle.madeley at collabora.co.uk> 2010-04-28 21:28:00 PDT ---
http://git.collabora.co.uk/?p=user/danni/telepathy-glib.git;a=shortlog;h=refs/heads/readable-docstrings

This is a first pass at this problem using an XSLT stylesheet to process the
docstrings into something managable by GTK-Doc. It's certainly not perfect,
because it's not trivial to map from XHTML back to GTK-Doc.

<tp:dbus-ref> and <tp:member-ref> could specifically do with some work.

I wonder if it would be better to process the spec with this stylesheet
_before_ running the parser on it, converting all <tp:docstring> elements to
some sort of <glib-comment> element that we could copy in as the comment, this
would allow simpler access to DOM elements such as <interface>, and also remove
the requirement on python-libxslt that I've introduced.

-- 
Configure bugmail: https://bugs.freedesktop.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
You are the assignee for the bug.