RoadRunner Source Code
I recently got hold of the full software including the source code. However, trying to understand the source code, and how the program works is proving difficult. There don't seem to be any help files with the code at all, and the variables in the code don't appear to have been given understandable names, plus the most of the comments (for me) are not adequate enough to be able to go through the program step by step and understand it, so that I can easily modify it myself for my own purposes (or write new routines for others). (I have to admit that I'm not exactly an expert in VB at present, and maybe the person that wrote the code deliberately limited comments etc.). Has anyone else gone through the program and typed in their own comments for their own understanding?? If so, would they be willing to share them???
I don't really have a answer to your question but where did you find the source code...i have been looking all over for it and cant find it anywhere.
Honestly, the source code of RR is nearly 50% code and 50% comments, so I find it hard to believe there's "not enough" comments. Plenty of people have downloaded/worked/changed/added onto the sources without too much trouble. Still, the software is very complex in its nature (skins+codeflow, etc) and I wouldn't be surprised if advanced programmers had trouble following it. All I can say is that you should start reading from modRoadRunner -- though this should be obvious As sub Main() is in there. ALL global variables are forcibly defined and well commented so even if their names are not "intuitive" they should be easy to understand. Still I'd not expect anyone to open a project this size and understand everything without spending sometime with it.
The latest source (Nov 07) is available in BlueZX3's museum:
I think of myself as intermediate when it comes to VB, and i had problems following the entire flow, but was able to identify where i needed to put my code for my own expansions of RR. I would say that you need a good understanding of VB6 to grasp all that RR does, and time...lotsa time :-)
Thought I'd better reply to what you'd said. Hope you can forgive me if you thought I was being nasty about your program, that wasn't the case. At the present, I am just about a complete novice at VB (although I did start to write small programs in it years ago). I want to try and understand exactly how your program works, and as such started stepping through the source code using VB6, but in my particular case, alot of the code is just a complete blur to me, and your comments (for me) didn't seem to fully explain the inner goings on. One thing I did notice however (don't know how you feel about this one), is that in the main module (I think its modRoadRunner), you have written short comments to explain what some of the variables are. I was taught many years ago at college, that when you are writing programs, you should always make your variables reasonably descriptive, so that anyone else who needs to go through a program and make alterations, can understand the code. Having to add comments to explain what you variables are (and do), is surely bad programming practise????
Don't know what you think about this, again I'm just making an observation, not being nasty. Apart from that, I think that your program is absolutely fantastic, and it must have taken ages for you to write it (well done).
cmon now. How much time should be spent focusing on the commentation of the program and "proper programming practice"? Noone will go back into RR and re-declare every variable and notate every line.. its a waste of time. Once you understand what you are trying to do then road runner becomes a very easy program to understand. I never knew a thing about VB before cracking open rr's source. And at first it was as confusing as you describe. But what you have to do is decide what u want to get from it? Do you want to add a command? A Label? An Indicator? I mean you have to have a goal other than just understanding how it works because road runner is not a program that you can read line by line and suddenly get it.
Originally Posted by malharvey
I have too added some things to rr's code and it does take a while to figure out what you need to do and where to do it. Also, I have say about the "proper programming practice" that your trying to "complain" about, if you know how rr works as a whole and know all of its features, when looking through all the variables, you would understand more of what each one stands for. You also have to take into consideration that RR is open source and guino is not the only one that add features, it a community project...
Hello, I'm a developer and am looking for the latest source code.
I am working to incorporate the xAP protocol into a front end for a car PC.
All of the links are dead.
did you even READ this thread.. there's a link in post 3
Big Red Truck! It's Dead, wont dload in IE or Opera, Hence the post. :)