← Prev in month ← Prev in thread
Next in thread → Next in month →

How to describe the difference between two XML formats?

From
Steinar Bang <>
Date
2003-12-20T14:48:47+00:00
ID
Thread
How to describe the difference between two XML formats?
I would like to write a DocBook document describing the difference
between two XML formats.  One of the formats is a replacement for the
other format, and the target audience is the people currently
generating the old format.

My thought was to display an example in the old format, side by side
with an equivalent example in the new format, and then explain the
difference between them in prose.

My questions are: are there any tools I can use to generate the side
by side example?  Some sort of XML diff program, perhaps?  

If not, is it possible to have two <mediaobject>s placed side by side,
with a listing in each?  Or do I have to manually put the examples
side by side in a text file to be included?

Is there a way to intermingle lines in the the examples with
annotating text? (I did that when generating code examples using the
Qt qdoc tool, and the result was highly effective)

Thanx!


- Steinar
← Prev in month ← Prev in thread
Next in thread → Next in month →