file: ChaosBook.org's chaosSpring06/0ReadMe
svn: $Author: predrag $ - $Date: 2006-03-19 15:59:10 -0500 (Sun, 19 Mar 2006) $ 
--------------------------------------------------------


subversion repository, ChaosBook.org's chaosSpring06 course homepages
on  zero.physics.gatech.edu, running SUSE 10.0
[formerly prime.physics.gatech.edu, running SUSE 10.0]

SUBVERSION BIBLE

	http://svnbook.red-bean.com/nightly/en/svn.serverconfig.html

%% SUBVERSION INSTALLATION
%% -----------------------
%% 
%%		if you do not see Suse 10.0 subversion on your machine
%%	yast 
%%		or 
%%	apt-get install subversion
%%		then follow instructions on http://svnbook.red-bean.com


REPOSITORY CHECK OUT
--------------------

	If you are creating your copy of repository for the first time
	(rather than subsequent updates):

	on any machine running svn, any user:
ssh yourId@zero (or any machine within Physics building running svnserve)
	or (from outside of the Physics building), read first
	www.cns.gatech.edu/CNS-only/sshTunnel.html

mkdir ~/tmpsvn	(or whatever path)
cd    ~/tmpsvn

cd  your/working/directory

	check that repository is accessible:
svn info svn://zero.physics.gatech.edu/chaosSpring06

svn co svn://zero.physics.gatech.edu/chaosSpring06
	creates a directory chaosSpring06 with everything in it
        users domenico, ratford, rytis, predrag, ....
        default password: ask Jonathan

	now you have a working copy
ll ~/your/working/directory/chaosSpring06


UPDATE OF LOCAL COPY
--------------------

	if you are returning to your copy to continue editing, first
	update your version:
cd ~/your/working/directory/chaosSpring06
svn up
	to retrieve others' edits, resolve conflicts.


EDITING
-------

	To be in sync, say "svn up" in regular intervals, 
	and perhaps also check in your edits every so often
svn ci -m "myName edits of blah blah"

	If you want to add a new subdirectory tree or a new file:
svn add fileName

	When you do get a collision, marked by a "C", go into the file
	and clean up things marked between <<< and >>> etc.


KEYWORDS WITHIN FILES
---------------------

vi someFile.type
	enter someplace keywords such as the bottom line of this file, 
	then activate
svn propset svn:keywords "Date Author" someFile.type
svn ci -m "svn:keywords set on someFile.type"


UPLOADING
---------

	Example: when done
svn commit -m "a small edit of thisFile" thisFile.typ
svn ci svn://zero.physics.gatech.edu/chaosSpring06  -m "edited this and this"

svn ci -m "added Predrag's chaosSpring06 files"

DISPLAYING THE EDITED HOMEPAGES
-------------------------------

Last step: changes to the repository show up on the web page only after
Predrag does this
   ssh predrag@zero
   cd ~predrag/public_html/courses/chaosSpring06
   svn up

NOTIFICATIONS (fix this section!)
-------------

OPEN QUESTION: active email update messages to Rathford, Domenico, Predrag

	to get an email every single check-in, checkout somewhere
svn co chaosSpring06
	and edit in there the file loginfo. (CVS only?)
	Search for 'whatever' and remove # (uncomment the rest of the line),
	or put any other email address there.
	Then check the file back in again
svn ci -m "testing: is chaosSpring06 email working?"



MISCELLANEOUS
-------------

	Mar 19 2006: moved repositories prime -> zero
	to ensure they are backed up

--------------------------------------------------------