[Dev] SVN Primer draft
grant at osafoundation.org
Wed May 25 10:02:25 PDT 2005
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).
> 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
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:
> -- OSAF Repositories --
> To browse or check-out anonymously
> To commit
> -- Repository layout --
> Each repository has the following base directories:
> 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
> 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
> Open Source Applications Foundation (OSAF)
> PGP Fingerprint = 9996 719F 973D B11B E111 D770 9331 E822 40B3 CD29
> _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
> Open Source Applications Foundation "Dev" mailing list
More information about the Dev