First thing is to ensure that the pom.xml is setup correctly:
There is a good link on the JBoss site about how to setup RichFaces 3.x on a maven project.
When digging into the documentation – the Developer Guide URL is as follows http://docs.jboss.org/richfaces/4.5.X/4.5.12.Final/Developer_Guide/en-US/html_single/ – though there are multiple versions – so use the relevant one.
Migrating from 3.3.x to 4.x
There is a brief overview https://developer.jboss.org/wiki/RichFacesMigrationGuide33x-4xMigration – which indicates things like the fact that
is deprecated, though it does not give advice on any workarounds.
This JBoss thread gives some workarounds on <rich:spacer> and <a4j:actionparam>, though it is somewhat incomplete. Specifically for <rich:spacer> the advice is to go with
The most complete is the “Richfaces 3.3 -> 4.x migration guide. Unleashed” – which is a table produced indicating what has changed, and some of the alternatives. There is also an itneresting post about doing automatic transformations – though this is not something that I’ve tried..
My personal list is:
“reRender” attribute was renamed
Replace with “render” attribute