[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

RE: Re: Binary documentation in SVN?

From: Glenn McAllister <gmcallister_at_sapient.com>
Date: 2005-02-03 01:13:02 CET

The issue is around merging binary documents. There are algorithms that
can do a (mostly) logical merge of multiple versions of a text file that
produces something legible. Try that with a binary file (a graphic is
the de-facto example) and usually the result is completely useless.

You can't use an arbitrary merge algorithm with a Word document and have
it make sense. You'd need to understand the details of how the Word
binary format works to be able to logically merge changes
(addition/deletion of text), which is why no one does it. Everyone
understands "text," be it plain-old ASCII or UTF8 in more modern
environments, which is why everyone supports it.

If you want to do merging with documentation, you need to use a
text-only format. Docbook and its siblings can be appropriate depending
on your author's comfort level. I don't know how well the XML format
that Word 2003 can produce would merge; from what I recall seeing it was
pretty icky XML.

Glenn McAllister
Sapient Canada, Inc.

-----Original Message-----
From: news [mailto:news@sea.gmane.org] On Behalf Of Nick Seigal
Sent: Wednesday, February 02, 2005 5:09 PM
To: users@subversion.tigris.org
Subject: Re: Binary documentation in SVN?

I too am curious about this. I think there must be some tricks of the
here. Certainly documentation is not as error-prone as code is (the
use of Subversion), so if merging works for code, I fail to see whey it
wouldn't work for documents. The red-bean Subversion book mentions
of risk-averseness in how Subversion is used (see
and I
think the strict level -- including all requiring all patches to be done
feature branches, then reviewed, approved and merged by central command
(which is how Linux does it I think) -- would be a good idea for you and

might soothe your editors.

Nick Seigal

"Keith Wellman" <keith@Bladelogic.com> wrote in message

I'm looking for information about using svn for documentation
I'm wondering if there is a recommended way of using svn to handle this
of situation (outlined below)?


We have a tech writing staff that works mostly in framemaker, which uses

binary files for storing their various booksets and are used to generate

pdf's and other rich (and binary) document formats.

Their classic mode of operation in other source control systems is to
use of the exclusive locking mechanisms to prevent concurrent work on
same files. My understanding is that svn is not looking to support any

locking mechanism until the 1.2.0 timeframe (or later).

I'm not aware of any good tools that would handle merging of these sorts
files, and I've met strong resistance from the writing staff about how
merging could be done even if the right tools could be found.


* is there a svn "best-practice" for this sort of work? I suppose "no"
is a
perfectly reasonable answer.. :D

* if there is one... what is it?

We certainly have the option of keeping documentation in a separate
versioning tool, but I'd like to avoid that if it isn't too much of a
on out tech writers to use subversion. But they do seem to have valid
concerns about concurrent changes to framemaker files being difficult or

impossible to deal with.

Thanks for any help this list can provide.

-- Keith Wellman
BladeLogic, Inc.

To unsubscribe, e-mail: users-unsubscribe@subversion.tigris.org
For additional commands, e-mail: users-help@subversion.tigris.org

To unsubscribe, e-mail: users-unsubscribe@subversion.tigris.org
For additional commands, e-mail: users-help@subversion.tigris.org
Received on Thu Feb 3 01:15:31 2005

This is an archived mail posted to the Subversion Users mailing list.

This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.