Dear M. Shafie,
That will be perfect, many thanks for your help.
Best regards,
Philippe.

----- Message d'origine -----
De : Hussein Shafie [mailto:huss...@xmlmind.com]
Envoyé : Tuesday, March 20, 2012 06:28 PM
À : nobili, philippe
Cc : 'xmleditor-support@xmlmind.com' <xmleditor-support@xmlmind.com>
Objet : Re: [XXE] XXE changes & SCM tools [UPDATE]

In fact, our Compare tool does not allow to compare revA and revB having 
both untranscluded contents. XXE indeed reports the "edited outside XXE" 
error message.

We'll remove this limitation in the next release. We'll try to do it a 
way which will also solve your specific problem.



On 03/20/2012 05:27 PM, Philippe Nobili wrote:
>
> With XXE 5.2, we seem close to have an efficient XML-aware difference
> engine connected with our SCM system (we use Perforce), at least as far
> as DocBook documents are concerned. However, we are facing a problematic
> issue with this right now; I'll try to explain it below, I hope my
> explanations are more or less clear...
>
> *Workflow:*
>
> In our SCM system, we have defined XXE (5.2) as our difference viewing
> tools for the DocBook documents; what users usually do from the SCM GUI
> frontend is that they usually select a DocBook file from their
> workspace, and ask to see the difference with the last repository version.
>
> *Description of the issue:*
>
> When the XML document is monolithic, everything goes OK, and we can
> activate the change tool and start scanning the differences.
>
> When the XML document is a flexible DocBook document containing
> references to external entities or XML documents, we get into problems:
> XXE is unable to transclude these XInclude statement (the SCM tools only
> retrieves the XML file itself not the related resources) and thus
> consider that the repository version has been manually edited by another
> application... refusing to let us scan the changes.

I think I understand what happens. This is not a bug: our Compare tool 
have not been designed to compare 2 revisions of the same modular 
document where revA has inclusion errors and revB has no inclusion errors.

Our Compare tool works fine when:

* Both revA and revB have untranscluded contents.

* Both revA and revB have transcluded contents. In this case, note that 
our Compare tool will automatically skip the transcluded contents. See 
below.



>
> :-[ Needless to say, almost all our Docbook documents except the most
> simple ones, are flexible documents...
>
> *A Suggestion:*
>
> When comparing two DocBook documents, we usually do not need to
> transclude the XIncluded resources, for they corresponding themselves to
> files stored somewhere else, and are thus easily comparable individually
> themselves.
>
> It is possible to improve the change mechanism so that it simply skips
> (e.g. untransclude) the XInclude elements during the time of the change
> examination process, simply showing the differences in the XInclude
> elements themselves (e.g. A changed file's path) ? This could simply be
> an option of the comparison tool.

This is already the case. Our Compare tool always compares the inclusion 
directives (even when the included contents have been transcluded) and 
not the included contents. Common sense dictates this, so this cannot be 
an option.

This feature is documented here:

http://www.xmlmind.com/xmleditor/_distrib/doc/help/xmlDiff_algorithm.html

Search for "Included contents".



>
> We do not know if this is feasible, neither if this would be the best
> option, you may have better suggestions. Right now, however, we do not
> see how to use XXE changes with complex documents in connection with our
> SCM tool.
>


 
--
XMLmind XML Editor Support List
xmleditor-support@xmlmind.com
http://www.xmlmind.com/mailman/listinfo/xmleditor-support

Reply via email to