By rszrama on
I was asked to provide some info on how I updated Tagadelic for use at my 5.0 site, and I thought the information might prove useful to others who are maybe new to the whole process. Basically, it involves looking in the handbook for the new changes and then scanning the code to make them! Simple enough on a small module like Tagadelic, but it can be quite a task for larger projects like e-commerce.
Check out the article and let me know if I left any holes or made any mistakes. I won't put that past me, especially after midnight. ;)
Comments
Nice one!
You forgot a very important initial step, though. :) Always check the issue queue of the module in question to see if someone has already gone through the trouble of updating the module for you.
However, I like the fact that you've documented what you've learned in the process of updating Tagadelic, as I think that will be very helpful to new developers (and I imagine you learned some stuff in the process as well!). And now you can compare your work with Egon's to see how they match up -- it's possible you might've spotted something during the update that he didn't and vice-versa.
There is also a very important final step, which is creating a patch of your changes and submitting it to the issue queue of the module. Having a .zip of a 5.0 version of Tagadelic module on your site doesn't allow others who haven't read this post to benefit from it, and not submitting the patch for community review doesn't allow other developers to incorporate and/or improve upon your work. :)
Thanks a lot for the info,
Thanks a lot for the info, webchick! I'll gladly update the article in a bit to include your suggestions. I think I did see that tagadelic update later, but several of the modules I converted about 5 weeks ago when they weren't available or were in the works. I remembered that for a couple other modules, and I'll definitely mention that step in the article, too. ; )
I am curious about how to creat a patch in Windows. The only client I was really able to successfully use for CVS was SmartCVS, and I've yet to find a console where I can just enter commands. Have you had any experience w/ that program and diff patches?
You can try cygwin. The
You can try cygwin. The package does include diff and patch.
http://www.cygwin.com
hah... didn't even think
hah... didn't even think about that. I was seriously just looking at cygwin yesterday to think about working on some MUD code on my machine. : P Thanks for the idea.
Yep, Cygwin's the only one I've been able to get to work...
There's also a section in the handbook about how to create patches on Windows which might be worth a look!
That handbook helped a lot,
That handbook helped a lot, I was having some issues about patches on windows but i menaged to sort it out
TortoiseCVS
I use TortoiseCVS to checkout all my code. It got a really handy create patch function that'll do all the hard work for you. It even lets you add files to a patch easily. It's way easier than doing it under cygwin.