The Ultimate in Windows Jabber Clients

How can I modify/compile Winjab?

Preperation

1. Get a copy of Borland's Delphi version 5. I use Delphi professional, but standard may work ok.

2. Start installing 3rd party Components. Surf over to Nevrona and download a copy of the Indy Socket components. I use these to handle the file transfer stuff (http send/receive). These components are Open Source, and are also used in the JabberCOM library.

   You'll need to either run the "installer" or download the zip file and install the package with all of the components.

3. Get the Hyperstring String Library. This freely available lib is available from: http://www.mindspring.com/~efd/hyperstr.htm.
   Download the DCU files for Delphi 5 and install them. The source code for this library is available for a fee, but you can use the DCU files for free.

4. The HTMLView component is used now to display all chat and group-chat messages. This is a component that accepts raw HTML code and displays it correctly. This is a huge improvement over using the stock Rich-Text control, since this allows us to embed anchors, and other hotlinks. We could even use it to do background bitmaps or images if we choose to.

   Download the component here.

5. Next you'll need to download a copy of the JabberCOM COM Library. if you don't already have a copy. To work with the CVS version of Winjab, you'll typically need the leatest version.

   Unzip the package, and put it "someplace" convenient. If you already have a copy of JabberCOM installed, you should copy the JabberCOM.TLB file into the same directory, and replace the (possibly) old jabberCOM with the newer one from the zip file.

   If you've never installed Winjab before, and you're putting JabberCOM someplace for the first time, you'll need to register it. Check the Readme.txt file included with JabberCOM for more instructions.

6. Once you have JabberCOM set to go, you need to open up Delphi and "import" the Type Library. This will put components into your tool pallette for the various COM Objects which are contained in the JabberCOM library.

   Select the Project | Import Type Library menu item from Delphi's main menu. Select the JabberCOM library, and click the 'Install...' button.

   
   

7. Get a CVS tool/program. If you've never used cvs before, you should read some of the sourceforge documents about cvs. An introduction to the basics of CVS can be found here.

   If you don't have a copy of any cvs programs or tools, surf to the WinCVS site and download a copy if you want a fancy GUI, or surf to CVSHome.org if you want the old-school command line utility. Specific instructions on using WinCVS with a sourceforge project are over here.

   NOTE: For those wondering, I do a LOT of work with CVS every day and have given up using the GUI WinCVS application. I use the command line tools 100% of the time now as they seem a lot more "fool proof" and sometimes easier :).

8. Checkout the source code.
   The CVS page for winjab gives you the appropriate CVSROOT to use to checkout the sourcecode. Unless you're listed as part of the winjab "team", you need to use anonymous CVS access. Use:

   	Username = anonymous
   	Password = ..blank, just hit enter..
   	

9. Setup the project options
   You need to setup a conditional compile "Jabber" in the project options to make everything work right :)

   Select Project | Options,