[ Update: the links below are out-of-date because new versions are released.
See RichFaces. Most Important Links for the actual links for current version. ]
This is a good question.
As you probably know that RichFaces are built using CDK (Component Development Kit). CDK generates the library based on the meta-data, component templates and hand-written java classes (It also runs the unit test,s generate the tld and api docs etc, but it is another store)
What you see in the richfaces-ui-3.1.0-src.zip is a truly source. I.e. a source for CDK. Those are the same files you can see in the SVN.
To the debug purpose, you need the source code that is generated by CDK before it is compiled into the binary.
Where to take such "source code"?
If you were use Maven, the Maven knows it. If you name is not Maven, you probably need more verbose instructions.
This is a typical place in the Maven repo where the nightly builds (SNAPSHOTs) are stored:
You can see a richfaces-ui-3.1.1-XXXXXXXX.XXXXXXX-X-sources.jar there. It is "source code" for debugging purpose.
Those are the "source code" for nightly API and IMPL jars:
The RichFaces 3.1.0 GA:
P.S. If you have Maven installed and use Eclipse with WTP or Red Hat Dev Studio (ex Exadel Studio), the command :
mvn eclipse:eclipse -DdownloadSources=true -Dwtpversion=1.5
allows to debug with source code automatically included. For more information see: