Versioning HowTo
From FujabaWiki
This guide applies to Fujaba 4. The functionality that is provided by CoObRA in Fujaba is roughly comparable to the outer behaviour of CVS for text files.
First check that versioning is activated. You can find the option at Options->Preferences->General -> 'Activate versioning repository'. You have to restart Fujaba for the changes to take effect.
If versioning is activated you will notice the versioning buttons in the main tool bar: 
The undo and redo buttons (first two) can be used intuitively.
The other buttons and more functions in the Menu (Tools->Project Versioning->...) are for client-server operations. These can be used to share a Fujaba project amoungst developers.
| Table of contents |
Sharing a Fujaba project
Sharing a Fujaba project you usually perform these steps:
- setup a server repository
- connect to the server with Fujaba
- check in something you have modelled in Fujaba
- connect with another client with Fujaba and retrieve the shared project
- check in changes from the second client
- update on the first one
Setup a server repository
Learn how to set up a repository server in the CoObRA Server Control HowTo.
Connect to the server with Fujaba
If you already have a local version of a shared project open it first.
Choose Tools->Project Versioning->Connect (also on the main toolbar). A dialog is shown:
As name server enter the host where you started CoobraSC (server control). Enter your repository name and credentials. Then click OK. After the operation completed the status bar should state "connect succeeded". Messages shown in the status before the operation finished are usually not harmsome. If you would like to test checking out an already set up or larger project have a look at the CodeGen2 checkout info.
If you have opened the shared project prior to connecting you should run update (see below) now to retrieve the newest version.
You can now view and edit the checked out project. Editing does effect your local copy only if you don't check in (see below). You can save your project as cxr, load it lateron and continue your work. Do not save as fpr if you want to continue sharing that file.
Checkin
After you have changed a shared project you may want to upload your new version to the server, too. You can do this by simply clicking in the checkin button in the toolbar (the black arrow on a sheet of paper), or by choosing Tools->Project Versioning->Checkin. If the status bar shows "checkin succeeded" your changes have been accepted and stored by the server.
A dialog may state "There are already new changes on the server - run update first". This means someone else has changed to server content after you ran the last update. Checking in is possible again after you ran another update.
Update
To retrieve the newest changes from a server click the update button (green circling arrows) or chooose Tools->Project Versioning->Update. You have to be connected to the server to do this (see above to connect). Your local changes to the project are not lost but merged with the changes from the server.
