First Step

Contact me! Then a developer should read the Guide Line document. To get involved you should subscribe to the timefinder-devel mailing list. Then write a comment to timefinder-devel@lists.sourceforge.net

Active Development

Find out where you can help.
Then, if you would like to contribute code you can contact the admin and give him your sourceforge login. The TimeFinder-Team will evaluate your code quality and discuss your contribution. Have fun!

Warning: The TimeFinder-Team reserves the right to cancel your membership, because of 'unsportsmanlike' behaviour or inactivity over a long period. You will recieve an email before this happens.

Installation of Developer Tools

Other IDEs

If you downloaded all stuff from sourceforge via subversion you can open the project with almost all major IDE, because it is a mavenized project.
For Eclipse you have to do:
mvn eclipse:eclipse
Go here for more information.

And for IntelliJ Idea you have to do
mvn idea:idea
Go here for more information.

Which creates a project for your IDE.

Further NetBeans Set-Up

  • Update NetBeans: Click on the world icon on the bottom right and follow the instructions.
  • Install the Maven plugin via: MenuBar->Tools->Plugins
  • NetBeans has a subversion UI included, but on linux it is good to use kdesvn to commit.
  • If you downloaded all stuff from sourceforge via subversion you can open the project directly with NetBeans.
    But I prefer to use a standard Java-project. Why? Because it is faster with compiling, running etc. And at the moment you cannot profile a maven project in NetBeans. So, create a Java project with sources any where on your filesystem. Now add the source folders to "Source Package" and the test folders to "Test Package". In linux this does not work, because NetBeans says: "the directory is already in use from an other project". Now you have to cheat. Link all the necessary folders to e.g. src/core-src, src/core-res, src/core-test-src, src/test-res, ... via 'ln -s fromPath toPath'
    and then import these folders to the standard Java project as described above. If this doesn't help, please contact me!
  • At the beginning it is important to configure NetBeans' templates:

    • Author: To generate a specific user in the code file (e.g. with email) you should go to MenuBar->Tools->TemplateManager->User Configuration Properties. And open User.properties in the editor. Replace the default text (Your Name) with your name ;-)
    • License: To generate for every new file the license you have to add the following line to the nbproject/project.properties file:
      project.license=apache20
    • Now set-up some abbreviations: Go to MenuBar->Tools->Options->Editor->Code Tempates and set expand template on space.
    • Logger: Click new and type clog (i.e. create logger), press okay and insert:
    private final Log log = LogFactory.getLog(getClass());
                    
    • Language: Click new and type clang, press okay and insert:
    private Translator tr; public void setTranslator(Translator trans) { tr = trans; }
    Now on every 'clog+SPACE' this will expand to the necessary statement.

Spring Rich Client

TimeFinder uses this framework in its Swing UI to make the use of tasks and translation easier. For more information look into the following documents:

Tools