tonybaldwin | blog

non compos mentis

TransProCalc, Google Code, & Subversion.

with 3 comments

A few days ago, as mentioned, I initiated the process of moving TransProCalc onto google code, feeling that it was time to dust off the project and move forward with it. I had merely signed the project up at that time, so, last night, before my brain turned to complete jello after spending the day slogging through the translation of some pretty heavy Brazilian academic articles, I took some time to configure the google code pages for the project, make a couple of wiki pages, upload the current, stable release, and, upload the existing code for the project.

Now, google code offers two version control systems, Subversion and Mercurial. I’ve never used either one before, but, at least I’ve heard of Subversion, so I chose to go with that one. It is, apparently, the default system, Mercurial offered as an option. I have used CVS before.

So, I aptitude installed subversion (svn) from the debian/lenny repos, and set about trying to import my code for the first time to the project.
The instructions on the google Subversion FAQ for importing your code are rather succint.

Just use the ‘svn import’ command.

.
Very thorough…
So, the first thing I did was, logically, try to read the man page. Now, people frequently complain that man pages are written for the hopelessly, inhumanly geeky, and not very useful for the rest of us (ok, I do write code, but I am far from being a real hacker, yet), that they are written in some secret language, and that they are generally useless. Of course, those in the know say to read them, and find them rather useful. I confess, I have actually come to the point where I can make sense of some man pages. I’m not even ashamed to admit it. Some of them are insanely usefl (ncftp, for instance, has a very thorough man page). So, I called up “man svn”.
This is what I got:

NAME
svn – Subversion command line client tool

SYNOPSIS
svn command [options] [args]

[sarcasm]That certainly cleared everything up for me…[/sarcasm]
How about explaining the options? What args? Hello!
I tried “svn help”, and that gave me a list of commands, as least, but with no explanation of how to implement them, or what they did, what options or arguments could be passed to them… Folks, the Subversion project needs documentation writers. No doubt. So, I did the next natural thing, then, and did some googling.
In defense of subversion, I must say, they have an entire book/manual for Subversion, available to be purchased in print, or read online for free. Perhaps the man page should give the link/location thereof, at least.
Of course, the instructions I found in said book was to import my code to my google code project, were a bunch of cryptic garbledy-gook, and said nothing of importing to a remote repository, only creating a repository on a local machine. I needed to import my code to a remote repository.
I did some ranting on some forums, to no avail of course (ah, but the sweet release of venting…), and did some experimenting.
I ended up resetting the repository a total of about 4 times, before I finally managed to figure out how to a) set up the svn repo at my end, b) import the code to google, and c) check in and check out.
So the code is up there, now.
Now, there do seem to be instructions available for checking out and checking in. That’s not too bad. But considering the complete lack of instruction on how to actually import the code of the first time, I thought I’d share the culmination of my efforts.

:~$ cd /path/to/project/files
:~$ svn import https://projectname.googlecode.com/svn/trunk/ –username yourname

There! Your code is imported to the svn repo… I know; Looks simple, but there was nowhere that I could find an explanation thereof.
(okay, it might as well be martian to some of you, dear readers, but those who write code and participate in open source software projects will understand).
Happy? I am.

So, TransProCalc is now up on google code and ready to start a new life. I actually made a few minor changes to the code already, last night, before loading it up there, but not enough that I would call it a release or new version…just a little clean up, rewrote the install script, and, more than anything, a lot more commenting, since I’m hoping to have collaborators. Commenting your code makes it easier for others to find stuff and figure out what you’re doing.

And, happily, I have a collaborator already! Anindita Basu, who had previously written a manual for TransProCalc, has rejoined the project (it’s been out of development for nearly 2 years, recall).

I have big plans for TransProCalc, many new features to be implemented, including but not limited to incorporation of a providers and client db, more user configurability of project parameters, and a calendar/reminder system to annoy you when invoices are due (either to you, or to your providers).
No time to work on any of that today, though…back to these articles…

Advertisements

Written by tonybaldwin

March 3, 2010 at 8:10 am

3 Responses

Subscribe to comments with RSS.

  1. I had to work with subversion a couple of years ago and wrote some about basic commands at http://unixblues.blogspot.com (it appear in the first post)

    Finally I switched to TortoiseSVN very easy to use (a windows client, sorry 😉

    tomas bradanovic

    March 7, 2010 at 3:19 pm

  2. Your blog keeps getting better and better! Your older articles are not as good as newer ones you have a lot more creativity and originality now. Keep it up!
    And according to this article, I totally agree with your opinion, but only this time! 🙂
    <hr />
    [Editor's note: Another clear example of spam comments. I let this one through, however, and actually encourage you to click through to the poster's blog. He apparently copied articles from relevant news sources about the current health care debate in the US, and, in between those articles, has original posts about acne control.The reason these are interesting is, it is patently obvious that they are the product of machine translation, and they are absolutely HILARIOUS! More clear evidence of why I still have a job! ./tony]

    strscream

    March 12, 2010 at 7:01 pm


Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: