[Dev] SVN Primer draft

[Grant Baillie]

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
>