taskjuggler 3.0.0 → 3.1.0

data/lib/taskjuggler/reports/TableReportColumn.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby -w
+# encoding: UTF-8
+#
+# = TableReportColumn.rb -- The TaskJuggler III Project Management Software
+#
+# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011, 2012
+#               by Chris Schlaeger <chris@linux.com>
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of version 2 of the GNU General Public License as
+# published by the Free Software Foundation.
+#
+
+class TaskJuggler
+
+  # This class holds some computed data that is used to render the TableReport
+  # Columns.
+  class TableReportColumn
+
+    attr_accessor :start, :end
+
+    def initialize(startDate, endDate)
+      @start = startDate
+      @end = endDate
+    end
+
+  end
+
+end
+

data/lib/taskjuggler/reports/TagFile.rb

@@ -1,9 +1,9 @@
 #!/usr/bin/env ruby -w
 # encoding: UTF-8
 #
-# = ProjectFileParser.rb -- The TaskJuggler III Project Management Software
+# = TagFile.rb -- The TaskJuggler III Project Management Software
 #
-# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011
+# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011, 2012
 #               by Chris Schlaeger <chris@linux.com>
 #
 # This program is free software; you can redistribute it and/or modify

data/lib/taskjuggler/reports/TaskListRE.rb

@@ -3,7 +3,7 @@
 #
 # = TaskListRE.rb -- The TaskJuggler III Project Management Software
 #
-# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011
+# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011, 2012
 #               by Chris Schlaeger <chris@linux.com>
 #
 # This program is free software; you can redistribute it and/or modify
@@ -33,10 +33,9 @@ class TaskJuggler
     def generateIntermediateFormat
       super
 
-      setReportPeriod
-
       # Prepare the task list.
       taskList = PropertyList.new(@project.tasks)
+      taskList.includeAdopted
       taskList.setSorting(@report.get('sortTasks'))
       taskList.query = @report.project.reportContexts.last.query
       taskList = filterTaskList(taskList, nil, @report.get('hideTask'),
@@ -51,11 +50,9 @@ class TaskJuggler
       resourceList.query = @report.project.reportContexts.last.query
       resourceList.sort!
 
-      adjustReportPeriod(taskList, @report.get('scenarios'),
-                         @report.get('columns'))
-
       # Generate the table header.
       @report.get('columns').each do |columnDescr|
+        adjustColumnPeriod(columnDescr, taskList, @report.get('scenarios'))
         generateHeaderCell(columnDescr)
       end
 

data/lib/taskjuggler/reports/TextReport.rb

@@ -3,7 +3,7 @@
 #
 # = TextReport.rb -- The TaskJuggler III Project Management Software
 #
-# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011
+# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011, 2012
 #               by Chris Schlaeger <chris@linux.com>
 #
 # This program is free software; you can redistribute it and/or modify

data/lib/taskjuggler/reports/TimeSheetReport.rb

@@ -3,7 +3,7 @@
 #
 # = TimeSheetReport.rb -- The TaskJuggler III Project Management Software
 #
-# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011
+# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011, 2012
 #               by Chris Schlaeger <chris@linux.com>
 #
 # This program is free software; you can redistribute it and/or modify
@@ -217,14 +217,14 @@ EOT
         records << (resourceRecord = TSResourceRecord.new(resource))
 
         # Calculate the average working days per week (usually 5)
-        weeklyWorkingDays = @project['yearlyworkingdays'] / 52.1428
+        weeklyWorkingDays = @project.weeklyWorkingDays
         # Calculate the number of weeks in the report
         weeksToReport = (to - from) / (60 * 60 * 24 * 7)
 
         # Get the vacation days for the resource for this period.
         queryAttrs['property'] = resource
         query = Query.new(queryAttrs)
-        query.attributeId = 'vacationdays'
+        query.attributeId = 'timeoffdays'
         query.start = from
         query.end = to
         query.process

data/lib/taskjuggler/reports/TjpExportRE.rb

@@ -3,7 +3,7 @@
 #
 # = TjpExportRE.rb -- The TaskJuggler III Project Management Software
 #
-# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011
+# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011, 2012
 #               by Chris Schlaeger <chris@linux.com>
 #
 # This program is free software; you can redistribute it and/or modify
@@ -81,6 +81,9 @@ class TaskJuggler
                               "#{@project['scheduleGranularity'] / 60}min", 2)
       end
       generateAttributeText("timezone \"#{@project['timezone']}\"", 2)
+      if @project['alertLevels'].modified?
+        generateAttributeText(@project['alertLevels'].to_tjp, 2)
+      end
       generateCustomAttributeDeclarations('resource', @project.resources,
                                           a('resourceAttributes'))
       generateCustomAttributeDeclarations('task', @project.tasks,

data/lib/tj3.rb

@@ -3,7 +3,7 @@
 #
 # = tj3.rb -- The TaskJuggler III Project Management Software
 #
-# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011
+# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011, 2012
 #               by Chris Schlaeger <chris@linux.com>
 #
 # This program is free software; you can redistribute it and/or modify

data/lib/tj3client.rb

@@ -3,7 +3,7 @@
 #
 # = tj3client.rb -- The TaskJuggler III Project Management Software
 #
-# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011
+# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011, 2012
 #               by Chris Schlaeger <chris@linux.com>
 #
 # This program is free software; you can redistribute it and/or modify

data/lib/tj3d.rb

@@ -3,7 +3,7 @@
 #
 # = tj3d.rb -- The TaskJuggler III Project Management Software
 #
-# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011
+# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011, 2012
 #               by Chris Schlaeger <chris@linux.com>
 #
 # This program is free software; you can redistribute it and/or modify

data/lib/tj3man.rb

@@ -3,7 +3,7 @@
 #
 # = tj3man.rb -- The TaskJuggler III Project Management Software
 #
-# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011
+# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011, 2012
 #               by Chris Schlaeger <chris@linux.com>
 #
 # This program is free software; you can redistribute it and/or modify

data/lib/tj3ss_receiver.rb

@@ -3,7 +3,7 @@
 #
 # = tj3ss_receiver.rb -- The TaskJuggler III Project Management Software
 #
-# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011
+# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011, 2012
 #               by Chris Schlaeger <chris@linux.com>
 #
 # This program is free software; you can redistribute it and/or modify

data/lib/tj3ss_sender.rb

@@ -3,7 +3,7 @@
 #
 # = tj3ss_sender.rb -- The TaskJuggler III Project Management Software
 #
-# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011
+# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011, 2012
 #               by Chris Schlaeger <chris@linux.com>
 #
 # This program is free software; you can redistribute it and/or modify

data/lib/tj3ts_receiver.rb

@@ -3,7 +3,7 @@
 #
 # = tj3ts_receiver.rb -- The TaskJuggler III Project Management Software
 #
-# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011
+# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011, 2012
 #               by Chris Schlaeger <chris@linux.com>
 #
 # This program is free software; you can redistribute it and/or modify

data/lib/tj3ts_sender.rb

@@ -3,7 +3,7 @@
 #
 # = tj3ts_sender.rb -- The TaskJuggler III Project Management Software
 #
-# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011
+# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011, 2012
 #               by Chris Schlaeger <chris@linux.com>
 #
 # This program is free software; you can redistribute it and/or modify

data/lib/tj3ts_summary.rb

@@ -3,7 +3,7 @@
 #
 # = tj3ts_summary.rb -- The TaskJuggler III Project Management Software
 #
-# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011
+# Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011, 2012
 #               by Chris Schlaeger <chris@linux.com>
 #
 # This program is free software; you can redistribute it and/or modify

data/lib/updateheader.sh

@@ -1,4 +1,7 @@
-files="*.rb reports/*.rb daemon/*.rb TextParser/*.rb ../test/*.rb ../spec/*.rb"
+files="*.rb taskjuggler/*.rb taskjuggler/apps/*.rb
+taskjuggler/daemon/*.rb taskjuggler/reports/*.rb
+taskjuggler/RichText/*.rb taskjuggler/TextParser/*.rb ../test/*.rb
+../spec/*.rb ../spec/support/*.rb" 
 
 for f in $files; do
   basename=`basename $f`

data/manual/Getting_Started

@@ -8,7 +8,7 @@ main project may include other files. Such included files must have
 file names with a ''''.tji'''' extension.
 
 The graphical user interface from the 2.x version has not been ported
-to TaskJuggler III yet. So all work with TaskJuggler needs to be done
+to TaskJuggler 3.x yet. So all work with TaskJuggler needs to be done
 in your favorite text editor and in a command shell.
 
 The commandline version of TaskJuggler works like a compiler. You
@@ -42,8 +42,8 @@ Every project must start with a [[project|project header]]. The
 project header must be in the main project file. All other elements
 may be put into include files. The project header must then be
 followed by any number of project properties such as [[account|
-accounts]], [[resource|resources]], [[task|tasks]] and [[report|
-reports]]. Each project must have at least one task defined and should
+accounts]], [[resource|resources]], [[task|tasks]] and 
+reports. Each project must have at least one task defined and should
 have at least one report.  Properties don't have to be listed in a
 particular order, but may have interdependencies that require such an
 order. If you want to assign a resource to work on a task, this
@@ -57,6 +57,9 @@ define them in the following sequence.
 * [[vacation|vacations]]
 * [[resource|resources]]
 * [[task|tasks]]
-* [[report|reports]]
+* [[accountreport|accountreports]]
+* [[resourcereport|resourcereports]]
+* [[taskreport|taskreports]]
+* [[textreport|textreports]]
 * [[export|exports]]
 

data/manual/How_To_Contribute

@@ -85,9 +85,30 @@ files, you need to register them with your repository.
 If you think you are done, you can commit your changes to your local
 repository.
 
- git commit -a
+ git commit -a -s
 
-And then push it into your forked github repository.
+The -s parameter is very important. We will only accept signed-off patches. By
+signing off on your patches you confirm that you wrote the code and have the
+right to pass it on as a patch. See
+[http://gerrit.googlecode.com/svn/documentation/2.0/user-signedoffby.html this
+document] for more information!
+
+Please include a meaningful commit message. The first line (header line) should
+be prefixed by ''''Fix: '''' for bug fixes or ''''New: '''' for new features.
+This is used to automatically generate the change log from one release to
+another. So a bug that has been introduced after the last release and is fixed
+before the next release does not need to be included in the changelog. For
+those cases, don't use any prefix.
+
+After the header line leave a blank line and include one or more paragraphs
+with more detailed information about the patch. This information will also be
+included in the the change log if the header line has a prefix.
+
+If you fix a bug that was reported by somebody else, please also include a reported-by line:
+
+ Reported-by: whoever-reported-the-bug
+
+Then push it into your forked github repository.
 
  git push
 
@@ -133,14 +154,14 @@ available in the ''''test'''' directory.
 
 ==== Contributing to the Ruby code ====
 
-For the first stable TaskJuggler III release we should have all 2.x
+For the first stable TaskJuggler release we have most 2.x
 features supported. The few things that break backwards compatibility
-should be documented in the [[TaskJuggler_2x_Migration]] section.
+are documented in the [[TaskJuggler_2x_Migration]] section.
 
 In general, patches are very welcome. Please follow the coding style
 and naming conventions used in the existing code. Larger changes
 should be preceded by a discussion in the
-[http://www.taskjuggler.org/forum.php TaskJuggler Developer Forum].
+[http://www.taskjuggler.org/contact.html TaskJuggler Developer Forum].
 
 ==== Some final words to Contributors ====
 

data/manual/Installation

@@ -1,15 +1,10 @@
 == Installation ==
 
-TaskJuggler III is written in [http://www.ruby-lang.org Ruby]. It
+TaskJuggler 3.x is written in [http://www.ruby-lang.org Ruby]. It
 should run on any platform that Ruby is available on. It uses the
 standard Ruby mechanism for distribution, a package format called
 [http://docs.rubygems.org RubyGems].
 
-TaskJuggler III is still under development. There is no stable
-version yet. You are welcome to try it. Some users are already using
-it successfully for their purposes, but it might not yet be right for
-you.
-
 === Requirements ===
 
 Ruby applications are platform independent. There is no need to
@@ -38,7 +33,7 @@ developer mailing list.
 
 ==== Other required Software ====
 
-* '''Ruby:''' TaskJuggler III is written in Ruby.  You need a Ruby
+* '''Ruby:''' TaskJuggler 3.x is written in Ruby.  You need a Ruby
 runtime environment to run it. This can be downloaded from
 [http://www.ruby-lang.org/en/downloads/ here].  Most Linux
 distributions usually have Ruby already included. So does MacOS X
@@ -54,7 +49,10 @@ version in parallel with your distribution Ruby.
 
 * '''RubyGems:''' If it did not come with your OS or the Ruby
 installation, see [http://docs.rubygems.org here] how to get and
-install it.
+install it. RubyGems is a cross-platform package manager. It will
+download and install all other required software packages
+automatically when you install TaskJuggler. These packages are called
+Ruby gems.
 
 Other versions of Ruby (Rubinius, JRuby, etc.) may work but have not
 been tested.
@@ -124,7 +122,7 @@ That's it. You now should be run TaskJuggler.
 ==== The manual way ====
 
 If the easy way doesn't work for you, you need to download and install
-the packages manually.  Download TaskJuggler III gem file from the
+the packages manually.  Download TaskJuggler gem file from the
 [http://rubygems.org/gems/taskjuggler RubyGems.org] site.
 
 A gem package is an operating system and architecture independent
@@ -150,7 +148,7 @@ following line in your ''''${HOME}/.profile'''' file.
 
 Windows and MacOS platforms may require similar steps.
 
-=== Update from older TaskJuggler III versions ===
+=== Update from older TaskJuggler 3.x versions ===
 
 Updates work just like the installation.
 
@@ -161,13 +159,22 @@ For downloaded or self-built packages use the following command:
  gem update pkg/taskjuggler-X.X.X.gem
 
 
-=== Installation Steps for Developers ===
+=== Installing TaskJuggler from the Git Repository ===
 
-The following description is for users that want to learn more about
-TaskJuggler or want to make improvements. TaskJuggler is
-[http://en.wikipedia.org/wiki/Open_source Open Source] software and
+The following description is for developers and users that want to
+learn more about TaskJuggler or want to make improvements. TaskJuggler
+is [http://en.wikipedia.org/wiki/Open_source Open Source] software and
 you are encouraged to read and modify the source code.
 
+Before you download the source code, make sure you have all the
+necessary dependencies installed. You should have Ruby 1.9.2 or later
+and you need to have the following gems installed
+
+ gem install rake mail rspec term-ansicolor rcov
+
+rcov is optional, but you must have the other gems and their
+dependencies installed.
+
 To get the source code, the recommended way it to check out the
 latest code from the developer repository. To do this, you need to
 have [http://www.kernel.org/pub/software/scm/git/docs/ git] installed.
@@ -204,7 +211,7 @@ another shell.
  # Make sure the shell finds the TaskJuggler programs
  export PATH=${PATH}:${TASKJUGGLER_DIR}/bin
 
-=== Quickly switching between various TaskJuggler III versions ===
+=== Quickly switching between various TaskJuggler 3.x versions ===
 
 One of the benefits of using TaskJuggler from the Git repository is
 the ability to get the latest bug fixes. If a bug was reported, it is
@@ -232,7 +239,7 @@ This will switch to the released version 0.0.10.
 
 provides you with a list of all tags.
 
-TaskJuggler III is written in Ruby. There is no make or build process
+TaskJuggler 3.x is written in Ruby. There is no make or build process
 needed. Every code change is effective immediately. The tutorial, the
 manual and some other parts do require a build step.
 
@@ -286,9 +293,10 @@ will be installed into ''''/usr/local/bin''''.
 
   sudo make install
 
-As a final step, you need to install the ''''mail'''' gem.
+As a final step, you need to install the ''''mail'''' and
+''''term-ansicolor'''' gems.
 
-  sudo gem19 install mail
+  sudo gem19 install mail term-ansicolor
 
 If you don't want to use TaskJuggler from the git repository, you can
 install the TaskJuggler gem as well.

data/manual/Intro

@@ -40,10 +40,10 @@ that to enter your project data you will use one of the most
 versatile and powerful tools there is: your favorite
 [http://en.wikipedia.org/wiki/Text_editor text editor]. To get a
 first impression, you can look at this
-[http://www.taskjuggler.org/tj3/examples/tutorial.tjp project file]. The
-project description is fairly intuitive, but very powerful as well.
-The [[Tutorial]] will explain this file line by line. Please look at
-the [http://www.taskjuggler.org/tj3/examples/Overview.html
+[http://www.taskjuggler.org/tj3/examples/Tutorial/tutorial.tjp project
+file]. The project description is fairly intuitive, but very powerful
+as well.  The [[Tutorial]] will explain this file line by line. Please
+look at the [http://www.taskjuggler.org/tj3/examples/Overview.html
 resulting reports] that visualize the project.
 
 
@@ -70,46 +70,68 @@ The HTML reports use icons from the
 licensed under the [http://www.fsf.org/licenses/lgpl.html GNU Lesser
 General Public License].
 
-The HTML reports use Java Script code from [http://www.walterzorn.com
-Walter Zorn]. The code is licensed under the
-[http://www.fsf.org/licenses/lgpl.html GNU Lesser General Public
-License].
+The HTML reports use Java Script code from
+[http://www.walterzorn.de/en/tooltip/tooltip_e.htm Walter Zorn]. The code
+is licensed under the [http://www.fsf.org/licenses/lgpl.html GNU
+Lesser General Public License].
+
+TaskJuggler does require other software components to operate. These
+components include the Ruby runtime system, operating system libraries
+and other components installed as Ruby gems. We have used great care
+to ensure that all dependencies are compatible with the TaskJuggler
+license and are being used as required by those licenses. But use
+cases may vary and you should check those licenses yourself to ensure
+that you use those components in accordance with their licenses.
 
 === Features and Highlights ===
 
+==== Basic Properties ====
+
 * Manages tasks, resources and accounts of your project
+* Powerful to-do list management
+* Detailed reference manual
+* Simple installation
+* Runs on all Linux, Unix, Windows, MacOS and several other operating systems
+* Full integration with Vim text editor
+
+==== Advanced Scheduling ====
+
 * Automatic resource leveling and tasks conflict resolution
-* Comprehensive and flexible reports so you can find the information you need when you need it
-* Project tracking and status reporting with dashboard support
-* Time and status sheet reporting infrastructure
 * Unlimited number of scenarios (baselines) of the same project for what-if analysis
-* Projects can be combined to larger projects
-* Project breakdown and management team support
-* Multiple project managers can work on the same project
-* Flexible working hours and vacation handling
+* Flexible working hours and leave management
 * Support for shift working
 * Multiple time zone support
+
+==== Accounting ====
+
 * Tasks may have initial costs, finishing costs
-* Resources may have running costs
-* Unlimited number of scenarios (baselines) of same project for what-if
-analysis
+* Resources may have usage based costs
+* Task and/or resource base cost models
 * Support for profit/loss analysis
-* HTML reports for Web publishing
-* CSV data export for exchange with popular office software
-* iCalendar export for data exchange with calendar applications
-* Project description syntax with macro support
-* Built-in web server for dynamic and interactive reports
-* Powerful and flexible filtering functions to provide the right
-amount of detail to the right audience
-* Server based time sheet system for status and actual collection
-* Powerful project description syntax with macro support
+
+==== Reporting ====
+
+* Comprehensive and flexible reports so you can find the information you need when you need it
+* Powerful filtering functions to provide the right amount of detail to the right audience
+* Time and status sheet reporting infrastructure
+* Project tracking and status reporting with dashboard support
+
+==== Scaling and Enterprise Features ====
+
+* Projects can be combined to larger projects
 * Support for central resource allocation database
+* Manages roles and complex reporting lines
+* Powerful project description language with macro support
 * Scales well on multi-core or multi-CPU systems
-* Full integration with Vim text editor
-* Runs on all Linux, Unix, Windows, MacOS and several other operating systems
-* Simple installation
-* Detailed reference manual
-* Support for project management teams and revision control
+* Support for project management teams and revision control systems
+
+==== Web Publishing and Groupware Functions ====
+
+* HTML reports for web publishing
+* CSV data export for exchange with popular office software
+* iCalendar export for data exchange with calendar and productivity applications
+* Built-in web server for dynamic and interactive reports
+* Server based time sheet system for status and actual work reporting
 
 === TaskJuggler on the Web ===
 
@@ -117,6 +139,6 @@ The official TaskJuggler web site can be found at
 [http://www.taskjuggler.org].
 
 Since the developers are mostly busy project managers themselves, we
-have created a [http://www.taskjuggler.org/forum.php forum] for users
+have created a [http://www.taskjuggler.org/contact.html forum] for users
 to help each other.