Fwd: DIFF document?

Subject:	Re: DIFF document?
Date:	Mon, 6 Jul 2020 14:57:26 -0400
From:	Paul Knight <paul.knight@oasis-open.org>
To:	Patrick Durusau <patrick@durusau.net>
CC:	Chet Ensign <chet.ensign@oasis-open.org>

Hi Patrick,

Yes, working from a boat sounds like a great way to embrace social distancing! I imagine Chet would be happy to do that, but I'm pretty sure he's stuck landside...

It sounds like you are asking twoÂquestions - why is there a DIFF file,Âand why does it show changes - ??

First - why is there a DIFF file:

The DIFF file is intended to show the changes between the CSPRD02 stage and the CS01 stage. (A quick look at the first page of the document you linked shows that.)

As a standard part of the publication process, we always prepare a DIFF to display changes made between Public Reviews, or when an approval ballot includes Non-Material Changes (like the ballot to approve this CS [1]).Â

After preparing the files for publication as CS01, I used the MS Word "Compare" function to generate the DIFF file. (As far as I can tell, the "Compare Document" function in LibreOffice can't generate a document which is as clear as the MS- Word output.)

Second - why does it show changes?

Obviously, because there are changes between CSPRD02 and CS01. The changes are in theÂfiles theÂTC approved, as linked in the ballot.

As far as I can see, the only changes of any significance are the changes in Section 1.5, where two referencesÂto "Part 3" have been changed to "Part 2".

In addition, some of the URIs in the Normative References were hyperlinked in CS01, while they were plain text in CSPRD02. There's also a reference to [ZIP] in the last line of Appendix C that was changed.

I'm not sure what the TC member meant by "the XML did not change".Â

I assume that refers to the files in the "schemas" directory [2]. (?)

Looking at the TC's record of changes, as cited in the ballot, does not indicate any specific changes to the schema files, so I suppose there's no reason the schema files would change.Â In any case, we simply publish the schema files you provide in the approved materials, and don't try to compare them to any previous versions. (i.e., we don't prepare a DIFF for schema files)

Well, I hope that answers your questions here, but please let me know if something is unclear.

Best regards,

Paul

[1]Âhttps://www.oasis-open.org/committees/ballot.php?id=3460

[2]Âhttps://docs.oasis-open.org/office/OpenDocument/v1.3/cs01/schemas/

On Mon, Jul 6, 2020 at 1:29 PM Patrick Durusau <patrick@durusau.net> wrote:

Paul,

A TC member pointed this out to me:
http://docs.oasis-open.org/office/OpenDocument/v1.3/cs01/part2-packages/OpenDocument-v1.3-cs01-part2-packages-DIFF.pdf
and I was wondering how that came into being? The TC page links to the
proper file so I'm not sure where this even came from.

The reason for asking is it is claimed the XML did not change, yet you
can see changes in this file.Â

Thanks!

Hope you are at the start of a great week!

Patrick

PS: Is Chet working from his sailboat for social distancing purposes? ;-)

--
Patrick Durusau
patrick@durusau.net
Technical Advisory Board, OASIS (TAB)
Editor, OpenDocument Format TC (OASIS), Project Editor ISO/IEC 26300
Co-Editor, ISO/IEC 13250-1, 13250-5 (Topic Maps)

Another Word For It (blog): http://tm.durusau.net
Homepage: http://www.durusau.net
Twitter: patrickDurusau

office message