[xmlroff] Simple docbook

[Tony Graham]

On Tue, Mar 18 2008 13:08:18 +0000, asmodai at in-nomine.org wrote:
> -On [20080318 12:47], Tony Graham (Tony.Graham at MenteithConsulting.com) wrote:
>>It's likely to be related to incomplete changeover between 0.5 and 0.6
>>in the version numbers, though I believe I have changed them all in my
>>local copy.
>
> Tony, why would the version numbers matter? I must be missing something
> simple, I guess. :)

Because it might have been that you (and I) had both libfo-0.5.la and
libfo-0.6.la after the change in configure.ac and no certainty about
which one being used or which has the latest changes.

Also because the version number change was the most recent 'no-brainer'
checkin that I did.

> This is more telling I think:
>
> #6  0x0819e7fc in fo_property_writing_mode_to_bpd (writing_mode=0x82330a0, 
>     error=0x0) at fo-property-writing-mode.c:393
> 393           g_assert_not_reached ();

IIRC, that comes after lots of other messages about NULL values.
Possibly an FO object isn't being updated from its context correctly.

Reverting some of the recent checkins may revert the problem as well.
Unfortunately, I've already spent more time on xmlroff today than I
should have.

> I am seriously not understanding what to look for. I see the enum stuff in
> the code, but everything is so opaque with all these typedefs and macros.

This is where you need gtk-doc, since you could then read about
debugging in the xmlroff manual.

I have copied the xmlroff manual page about debugging to the wiki:

   http://xmlroff.org/wiki/Debugging

The functions listed at the end are more useful for debugging FoObjects:

fo_object_sprintf(object)

    The 'nice' printout of the object.

fo_object_debug_sprintf(object)

    The 'nice' printout of the object plus its address and reference
    count.

fo_object_debug_dump(object,indent)

    Dump everything about the object and its descendants (if it's part
    of a tree, that is).

fo_node_path_to_root_sprintf(node)

    Print XPath-like locator for node.

fo_node_debug_dump_tree(node)

    Dumps just the FoNode objects, not their properties, in the tree
    rooted at node.

Regards,


Tony.