OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: 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)


- Steinar

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]