Menu

#80 ch04: Incorrect definition of revision

en-1.6
Done
nobody
None
Medium
Defect
2011-07-07
2010-05-20
Anonymous
No

Originally created by: ppi...@gmail.com
Originally owned by: ptbu...@gmail.com

I'm both a newbie to svn and a nitpicker.  Chapter 4 states near the top:
"At this point, you should understand how each commit creates an entirely
new filesystem tree (called a “revision”) in the repository." 

Finding it alarming that a commit would create an entirely new filesystem
tree, I went and read the chapter on Revisions where it states "Each time
the repository accepts a commit, this creates a new state of the filesystem
tree, called a revision. "

I propose the chapter 4 text say "At this point, you should understand how
each commit creates a new state of filesystem tree (called a “revision”) in
the repository." 

Thanks,
Phil
ppitha@gmail.com

Discussion

  • Anonymous

    Anonymous - 2011-06-28

    Originally posted by: cmpilato

    Technically speaking, commits *do* create new filesystem (in the "virtual versioned filesystem encapsulated by the repository" sense) trees.  Those trees just happen to share most of their storage with previous trees.  Still, I agree that some reconciliation between these two subtly different definitions of "revision" needs to happen.

    Labels: Milestone-en-1.6

     
  • Anonymous

    Anonymous - 2011-06-28

    Originally posted by: cmpilato

    (No comment was entered for this change.)

    Owner: cmpilato

     
  • Anonymous

    Anonymous - 2011-07-05

    Originally posted by: cmpilato

    (No comment was entered for this change.)

    Summary: ch04: Incorrect definition of revision

     
  • Anonymous

    Anonymous - 2011-07-06

    Originally posted by: cmpilato

    (No comment was entered for this change.)

    Owner: pbu...@googlemail.com

     
  • Anonymous

    Anonymous - 2011-07-06

    Originally posted by: cmpilato

    Oops.  Use the correct address for Paul Burba.

    Owner: ptbu...@gmail.com

     
  • Anonymous

    Anonymous - 2011-07-07

    Originally posted by: ptbu...@gmail.com

    Chapter 4 probably isn't the place to get into a comprehensive discussion of libsvn_fs_*'s storage mechanisms vs. a user's view of a revision (and everything in-between)...so in [r3896] I simply changed the language to be similar to that in svn.basic.in-action.revs.

    Status: Done

     

Log in to post a comment.

Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.