[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

--- Comment #3 from Travis Reitter <travis.reitter at collabora.co.uk> 2010-04-29 17:19:38 PDT ---
(In reply to comment #2)
> 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.

I didn't check the XSLT stylesheet in detail, but it seems to work well-enough
for now after a few small build, etc. fixes:

http://git.collabora.co.uk/?p=user/treitter/telepathy-glib.git;a=shortlog;h=refs/heads/readable-docstrings

-- 
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.