Bazaar - GPL Distributed Version Control Software
1. Download the installer file from Bazaar web page and install it to your computer.
2. Open Bazaar tutorial from Windows program menu, and preferably follow it. Or for a very quick start, continue reading this.
3. Start Bazaar in command shell from Windows program menu.
4. Introduce yourself to Bazaar by entering command:
bzr whoami "Your Name <your.name@utu.fi>"
Adding an existing software code to Bazaar (for everyone to see and edit)
1.
Create the directory
P:\www\bzr\<first_letter_of_the_program_name>\<program_name>
and copy the source code of your program in there.
2. Start a command shell (Windows or MSYS) and change directory to the above mentioned directory. Enter this command:
bzr init
Bazaar then adds its own control directory .bzr in it. Do not change any files in that directory.
3. Add the files that you like to be versioned to the system, for example:
bzr add ?akefile *.c *.h doc/* test*.zip
4. If you like, check the status of the branch that you just created:
bzr status
5. When you are happy with the state of the status, you should commit it to the branch to make a new revision:
bzr commit -m "added first time"
6. If you like, check the log of the branch:
bzr log
6.
Later, the P:\www\bzr path may be configured to be automatically
copied to our web server. In that case, the log of your software could
be checked with command
bzr log http://www.turkupetcentre.net/bzr/<first_letter_of_the_program_name>/<program_name>/
Copying code from Bazaar for editing, and back
You
can just copy the program source code directory, including .bzr
directory and its contents, to your local directory, to have your own
personal branch of the codes. Alternatively, you can use Bazaar to make
the personal branch:
1. Change directory in to where you like your personal branch directory to be located, for example:
cd C:\temp
2. Create a new local branch:
bzr branch P:\www\bzr\<first_letter_of_the_program_name>\<program_name>
cd <program_name>
Instead of local directory, a web URL could also be used, for example:
bzr branch http:www.turkupetcentre.net/bzr/<first_letter_of_the_program_name>/<program_name>
3.
Edit the sources and document files as you like. During the process,
you can and should often commit the changes to your local branch; in
your brach directory, enter the command
bzr commit -m "made this change"
4.
After you have finished and tested your editions, then copy the files
that you edited to the common branch, and commit it there. If the
common branch has been changed while you were working with your own
copy, then you have to merge the branches:
cd P:\www\bzr\<first_letter_of_the_program_name>\<program_name>
bzr merge <URL_of_your_local_branch>