Next Previous Contents

3. Usage

3.1 Basics

TaskJuggler uses one or more text files to describe a project. The main project should be placed in a file with the .tjp extension. This main project may contain several subprojects. Such subprojects should be placed in files with the .tjsp extension. These subprojects are included in the main project during compile time.

3.2 General Usage

TaskJuggler works like a compiler. You provide the source files, it computes the contents and creates the output files.

After you created the project description file, have TaskJuggler compute and create the output. For example, if you have created the AcSo.tjp project file. You need to send this file to TaskJuggler then:

% taskjuggler AcSo.tjp

TaskJuggler will try to schedule all tasks with the specified conditions and generate the reports that were requested with the htmltaskreport, htmlresourcereport or other report attributes in the input file(s).

Calling TaskJuggler with . as input filename will cause reading from stdin. To redirect output to stdout you can specify -- as filename for reports. This feature can for example be used to generate dynamic html pages from CGI scripts.

3.3 The Command Line Options

To get a list of the command line options of TaskJuggler, use the --help option:

% taskjuggler --help

3.4 Reporting Bugs and Sending Feedback

All official releases of TaskJuggler are meant to be stable releases unless explicitly noted differently. But our test suite is still very small and some features cannot be tested automatically very well. So it's very likely that your current version of TaskJuggler contains bugs. If you find a bug please follow this procedure:


Next Previous Contents