On 12/14/2011 09:47 AM, Eric S. Raymond wrote: > Heh. Just to add to the confusion, Daniel says that what I'm calling a > "flow" is elswehere called a "node" and that what I'm calling a "node" > is elsewhere called a "node-revision". > > I'm not sure how I want to deal with this in the 0.3 draft. The > problem with what he's telling me is the correct terminology leaves > the term "node" pretty overloaded. Best thing may be to change "node" > in the document to "node-revision" and leave in "flow" with a note > indicating that the source code sometimes calls this a "node".
Yup. A "node-revision" is, in svn-fs-speak, a single node in the giant DAG which describes the whole of the version history in the repository. It represents the state of a file or directory as it existed a given point in version time. A "node", though, is not a node in that DAG at all, but the term used to describe a whole set of those nodes (aka "node-revisions") connected in the DAG by their ancestor IDs. A "node" describes the line(s) of history of a single versioned object (file, or directory, including all states thereof including those resulting from copy operations). So, yeah, one node is a "node-revision", and a collection of "node-revisions" is a "node". We probably could have done a bit better when naming this stuff... Fortunately, there is no confusion about one thing: the term "flow" has not a single meaning at all in Subversion-speak. :-) -- C. Michael Pilato <cmpil...@collab.net> CollabNet <> www.collab.net <> Distributed Development On Demand
signature.asc
Description: OpenPGP digital signature