INSTALL SUBVERSION FOR SERVOY 6.1 ON A MAC

1. Requirements

Make sure the directory and Developer are named "Servoy". In other words, don't rename anything after installing Servoy!

You need an SVN server someplace. Options:
	setup your own
	we're currently using http://www.beanstalkapp.com
	a bazillion other ones out there for reasonable monthly fees (and even free)

Lastly, make sure servoy (especially after a new install) has 
	servoy.application_server.startRepositoryAsTeamProvider = false
	(servoy admin, bottom of page)

2. Install SVN for Mac

Download the latest Mac OS X binary package from openCollabNet
	http://www.open.collab.net/downloads/community/
	
Install the file and follow the steps

Once installed, run the command export PATH=/opt/subversion/bin:$PATH to set the proper path

3. Install subversive in Servoy Eclipse

Help > Install New Software...

Add the following URL's (press the "Add" button to add them in)
	http://download.eclipse.org/technology/subversive/0.7/update-site/

Choose which connector to install
	select "--All Available Sites--" from "Work with:" filter
	expand "Subversive SVN Connectors" and select:
		- Subversive SVN Connector Connectors (required)
		- SVNKit 1.3.0 Implementation (need for subversion v1.6x)
		- Native JavaHL 1.6 Implementation (need for subversion v1.6x)
	expand "Subversive SVN Team Provider Plugin" and select:
		- Subversive SVN JDT Ignore Extensions
		- Subversive SVN Team Provider
		- Subversive SVN Team Provider Localization (don't need if just using english)	click "next" until installed	

- restart
	- open SVN perspective (need to use the + toolbar button)
	- choose native javaHL 1.6.x (don't choose if installer doesn't like you.)
	- choose SVNKit 1.3.x
	- Subversive SVN Connector Connectors (already selected as it is required)
- restart again

4. Configure subversive

Go to preferences for subversive (Team > SVN)
	make sure under "SVN Connector" tab that the native JavaHL is selected
	rest of the defaults are ok

Open SVN perspective
	Window menu > Open perspective... > Other... > SVN Repository Exploring

Add an SVN repository and connect it to your SVN server
	"SVN Repositories" view > "New Repository Location" (small yellow button at top of view)
		enter URL to SVN server
		enter user/password credentials (or SSL key under SSL settings)
			recommend clicking "Save password"
			note that capitalization may be important
		(optional) use a custom label to name this repository

5. Basic usage notes

The basic things you can do:
	Share
	Synchronize
	Commit
	Update
	
Share: creates initial link from workspace to repository (only need to do once)
	right-click a solution in Servoy's Solution Explorer
	choose "Team > Share Project..."
	select type of team sharing. in this case "SVN"
	choose your newly created repository
	click "Next" and optionally enter a comment in the next pane
		note "Launch the Commit Dialog for the shared resources"
			this does two additional steps: synchronize and commit. this is a good thing
			you get the option to enter comments on the commit 
	at this point you get an error dialog "Developer started repsoitory"
		the short version is click "Change setting / restart"

	sharing is done
		switch to SVN perspective and you should see your newly shared, synchronized and committed files
	
Synchronize: compare what's in your workspace to what is on the SVN server
	right-click a solution in Servoy's Solution Explorer
	choose "Team > Synchronize with repository..."
		will pop you into Synchronize perspective
		double-click and object to see differences
	note: a right arrow next to an object name denotes that you have new change in the workspace
		an asterisk denotes the repository has a new change

Commit: push workspace changes to repository
	you can do from Solution Explorer or SVN perspective

Update: pull repository changes to workspace
	this overwrites files in your workspace
	you can do from Solution Explorer or SVN perspective

5. Finish up

Subversive is cool in that it generally tells you when you need to commit as you're working. Just look for the ">" in front of your objects in the Solution Explorer.

Numbers to the right of objects in the Solution Explorer/SVN Repositories denote the revision you are working on.

At this point you can rename the servoy directory and developer file if you'd like.