[oXygen-user] oXygen Author-mode document comparison plugin

[David Cramer]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi Michael,
Thanks for the information. This is a very interesting tool and I think
it will be useful for many people.

I've put follow-up questions inline below.

> Currently entities are only preserved in the general XML comparison mode
> (which produces oXygen tracked changes). This default behavior can be
> configured by changing the value of the 'Preservation Mode' parameter.
> Note that the general XML comparison mode's configuration parameters are
> made available by pressing the 'Configure' button on the Comparison
> file/window selection panel.
> 
> The DITA and DocBook comparison modes always expand entity references,
> as their revision flag markup is not intended for round-trip processing.

I'm not seeing a "Preservation Mode" field in the "Preferences for
Compare DocBook" window.

> The DocBook specific comparison mode, by default, expands xi:includes
> elements. This can be turned off by 'unchecking' the 'Enable XInclude'
> parameter. The general XML and DITA comparison modes do not expand
> xi:include elements.

I see. I guess it would be quite a complex process to compare two files
and their xincluded contents while preserving the xincludes. The tool
would have to name and save new versions of all the xincluded files in a
new directory and update all the hrefs on the xinclude elements. I could
imagine situations that would be hard to process (say if an element were
moved from the main file to an xincluded file with no other changes).
But for a more limited case, say where all the xincluded files are code
listings, this could work.

>> 2. If you have a document with a DOCTYPE statement but with no DTD, it
>> fails to parse the document. This situation arises when you use a schema
>> to validate the document but add a DOCTYPE to declare entities. For
>> example, if you attempt to load two versions of the following valid
>> DocBook 5.x document, it fails to load the first one complaining that
>> "book" has not been defined:
>>
> We will address this bug, which arises due to the inappropriate use of
> DTD validation. One work-around is to compare these documents by turning
> off the 'Validation' configuration parameter. Alternatively, the general
> XML comparison successfully compares these files.

Ok, thanks. Turning off validation works around the issue for now.

David
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJOFc34AAoJEMHeSXG7afUhyT0H/21R8Qp+4jeExaQ4gqCCQF8/
Z9uvB2KeQsdvPhrVQB8beC0eyAAvataJjZVRyN7fsqsW6/SUV9zKF6FAuzwDOwVj
IwzgZm/9OXE61dIT6bEKQyMvCxxme1rwdA0sn08Mbtzbt/FwwJesgniKYV2JeTPQ
tr/pVswiHlH3NRtddBJRumHm63GiWZ77vM/Y0lvdetAV4M9qCMlq3awO6aP3PJGl
UpGNLw7o+ULeyQ+ecx8GibivgCrVB41tprbsetZcfLz6fh0TcLVTvBHVIyqlOnpv
kUgUyG7Ir58ZK3IYN+gEBRGiMEcGj2GPzjVDPZ5bGEdllDoXhAgwSXScNSaglgY=
=UI0I
-----END PGP SIGNATURE-----
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Screenshot-Preferences for Compare DocBook.png
Type: image/png
Size: 23829 bytes
Desc: not available
Url : http://www.oxygenxml.com/pipermail/oxygen-user/attachments/20110707/309caf2e/attachment.png