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

Some remarks to the subversion book

From: Marcin Kasperski <Marcin.Kasperski_at_softax.com.pl>
Date: 2004-02-18 18:22:14 CET

I am just reading subversion book (draft rev 8581) and I have the
following remarks (page numbers relate to the numbers as printed
in the page footers within the PDF version).

(page 50, note about running svn log in my-calc-branch)
I doubt whether after merging the branch changes to the trunk,
the commit message will be visible in the branch log. It seems
to me that it is the trunk that changed, on the branch nothing
has changed and nothing has been commited.

(page 31, resolving sandwich.txt by copying sandwich.txt.r2 and
running svn resolved)
What are we commiting here? It seems we have nothing to commit as
nothing has changed comparing to the repository.

(page 17, introduction of symbolic tags)
I do not understand what exactly COMMITED and PREV symbols mean.
It seems they are introduced far too early in the book,
nevertheless, wherever they are introduced, maybe one could
describe them better...

(page 41, introduction to branching with branches dir)
I would add here a mention (likely a footnote) that there exists
a method (svn switch) which allow one to keep the same working
dir while moving from trunk to branch and opposite.

(chapter 4)
I would probably introduce tags first, branches and merges later.
Maybe my CVS habits makes me to think so but tags are simpler
concept. Moreover, I would either change chapter 4 title to
'Branching, Merging and Tagging' or move tagging description to
separate chapter.

(general)
I would introduce early in the book and use consistently some
method of avoiding urls in the commands. Maybe
   export SVNREP='http://my.repo.com/subversion'
and
   svn checkout $SVNREP/mymodule
maybe something else....

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Wed Feb 18 18:33:47 2004

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