Hi, Bear
Looks very fine to me. Some minor suggestions:
1) Maybe mention "svn help" early on in the doc?
2) It might be worth pointing out that the http: access (under OSAF
Repositories) can be via your web browser, or a WebDAV client (e.g.,
the Finder on Mac OS).
3) w.r.t.
It will not show you any file in your working directory that has
been added to the Ignore property.
Since there's no mention of properties anywhere else in the doc,
maybe a "(see the docs for a discussion of svn properties and their
commands)" would be good here. Also, isn't the name of the property
"svn:ignore"?
--Grant
On May 25, 2005, at 9:41 AM, Mike Taylor wrote:
This is what I want to post on a wiki page - can everyone review it
and make suggestions as needed?
SVN Primer:
The best source of SVN info is from the online documentation and
from the online book:
http://subversion.tigris.org/
http://svnbook.red-bean.com/
-- OSAF Repositories --
To browse or check-out anonymously
http://svn.osafoundation.org/chandler
http://svn.osafoundation.org/server
http://svn.osafoundation.org/docs
To commit
svn+ssh://svn.osafoundation.org/chandler
svn+ssh://svn.osafoundation.org/server
svn+ssh://svn.osafoundation.org/docs
-- Repository layout --
Each repository has the following base directories:
branches/
tags/
trunk/
The trunk directory is where the most recent activity is found,
branches will contain a directory for each branch that has been
defined and tags will contain a directory for each defined tag.
The thing to remember in SVN is that a file has a reference
(symlink if you like) in branches and tags until you commit a
change so they take up no extra room in the repository.
NOTE: Never checkout a full SVN repository - you will download the
*entire* repository - all branches and tags. Instead you should
always specify a path within the repository, for example:
svn co svn+ssh://svn.osafoundation.org/chandler/trunk/chandler
chandler
To get a specific branch, do this:
svn co svn+ssh://svn.osafoundation.org/chandler/branches/
CHANDLER_0_5_MILESTONE 0_5_milestone
To find out what branch or tag is available, use the ls command:
svn ls svn+ssh://svn.osafoundation.org/chandler/branches
svn ls svn+ssh://svn.osafoundation.org/chandler/tags
-- What changes do I have pending --
The status or diff command will give all local files that have been
added, deleted and/or modified. It will not show you any file in
your working directory that has been added to the Ignore property.
Note that a network connection is not required for this command.
svn status
svn diff
-- Moving files --
Unlike CVS, SVN allows you to move and rename files and directories:
svn mv file1 file2
NOTE: Please avoid moving files or directories without checking
with me - changes in the directory layout has to be coordinated
with the various build scripts.
-- Copying and Splitting files --
If you need to create a copy of a file or which to create a new
file that is based on another, use the cp command. This will allow
the properties to transfer in svn:
svn cp old file1
svn cp old file2
svn delete old
<edit file1 and file2>
svn commit
---
Bear
http://code-bear.com
Open Source Applications Foundation (OSAF)
http://www.osafoundation.org
PGP Fingerprint = 9996 719F 973D B11B E111 D770 9331 E822 40B3 CD29
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
Open Source Applications Foundation "Dev" mailing list
http://lists.osafoundation.org/mailman/listinfo/dev
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
Open Source Applications Foundation "Dev" mailing list
http://lists.osafoundation.org/mailman/listinfo/dev
