Google Code Create Project Recipe
I presume you’ll create your own project and put it
under version control to learn these skills. I recommend
patience since I did this three times and had some
difficulties each time (including losing my freaking
password). Let’s learn how to start an open source project
and do it cookbook style. Go to
http://code.google.com/projecthosting/. Click ‘Project
Hosting on Google Code’ shown in Figure 2.
• Click ‘Sign in to create a project.’
• Click ‘Create a new project’ and fill in the project
information as shown in Figure 3. Note that the
project name must be all lowercase and cannot
have certain characters. For example, it wouldn’t
take Avr_Toolbox but did take avrtoolbox. (Possibly
somebody at Google forgot what century we’re in?)
• Click on ‘Version control system:’ as in Figure 4.
• Click on ‘Source code license:’ as in Figure 5.
So, now we have Figure 6.
Version Control — It’s A Time Machine
A version control system manages files and
directories, and the changes made to them over time. It
allows you to recover your older work and track the
history of the changes you’ve made. When you smack
your head over something really stupid you’ve been doing
for a few days, you’ll be glad you have a version control
system time machine to take you back to your last
intelligent moment so you can examine the details of
when you messed up. If you are like me, you’ll just revert
to that moment and trash the rest. However, with a
version control system, you don’t actually trash anything
so if you decide that your stupid period maybe wasn’t so
stupid after all, you can recover those bits.
Another really useful feature is that a version control
system allows several folks to work on the same stuff at
the same time without risking destroying each other’s
work. If you and I check out the same thing and each
make a change, the system will tell us to have a discussion
about it before it will let either of us put it into the system.
If you’ve never used a version control system before,
you’ll need to learn some of the lingo so that you can talk
the talk. To save space, I’ll recommend that you mark this
spot and then proceed to the Internet book: Version
Control with Subversion, Chapter 1. Fundamental
Concepts ( http://svnbook.red-bean.com/en/1.5/
svn.basic.html). They do a great job so there’s no reason
to repeat it here. I do suggest you mark this spot when
you finish that chapter since the rest of the book can get a
bit hairy without a guide. Let’s set up a real version
control system for our avrtoolbox project.
TortoiseSVN And Our
You can get your free copy of TortiseSVN at
http://tortoisesvn.tigris.org/. Follow their instructions to
get it installed on your PC. Let’s start by creating a
directory tree so we’ll have something to put under
■ FIGURE 7. avrtoolbox in Windows Explorer.
■ FIGURE 8. Right-click avrtoolbox and Select
■ FIGURE 9. Import to Repository.
■ FIGURE 10. TortoiseSVN Import.
version control. I decided on (see Figure 7):
February 2011 53