taskjuggler 3.8.1 → 3.8.2

data/lib/taskjuggler/Resource.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = Resource.rb -- The TaskJuggler III Project Management Software
@@ -72,7 +73,7 @@ class TaskJuggler
         # The components of the message are either UTF-8 text or RichText. For
         # the RichText components, we use the originally provided markup since
         # we compose the result as RichText markup first.
-        rText = ''
+        rText = +''
 
         taskList.each do |task|
           rText += "=== <nowiki>[</nowiki>" +

data/lib/taskjuggler/ResourceScenario.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = ResourceScenario.rb -- The TaskJuggler III Project Management Software
@@ -496,7 +497,14 @@ class TaskJuggler
     # A generic tree iterator that recursively accumulates the result of the
     # block for each leaf object.
     def treeSum(startIdx, endIdx, *args, &block)
-      cacheTag = "#{self.class}.#{caller[0][/`.*'/][1..-2]}"
+      # Starting with ruby 3.4.0, the out of caller was changed.
+      # https://www.ruby-lang.org/en/news/2024/12/25/ruby-3-4-0-released/
+      # This ugly bit of code ensure that older versions still work.
+      if Gem::Version.new(RUBY_VERSION) >= Gem::Version.new('3.4.0')
+        cacheTag = caller[0][/'.*'/][1..-2]
+      else
+        cacheTag = "#{self.class}##{caller[0][/`.*'/][1..-2]}"
+      end
       treeSumR(cacheTag, startIdx, endIdx, *args, &block)
     end
 

data/lib/taskjuggler/RichText/Document.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = Document.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/RichText/Element.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = Element.rb -- The TaskJuggler III Project Management Software
@@ -360,7 +361,7 @@ class TaskJuggler
         raise "Unknown RichTextElement category #{@category}"
       end
 
-      out = ''
+      out = +''
       @children.each do |el|
         if el.is_a?(RichTextElement)
           out << el.to_tagged + (el.appendSpace ? ' ' : '')
@@ -488,7 +489,7 @@ class TaskJuggler
 
     # Convert all childern into a single plain text String.
     def children_to_s
-      text = ''
+      text = +''
       @children.each do |c|
         text << c.to_s + (c.is_a?(RichTextElement) && c.appendSpace ? ' ' : '')
       end
@@ -507,7 +508,7 @@ class TaskJuggler
     # This function converts a String into a new String that only contains
     # characters that are acceptable for HTML tag IDs.
     def convertToID(text)
-      out = ''
+      out = +''
       text.each_utf8_char do |c|
         out << c if (c >= 'A' && c <= 'Z') ||
                     (c >= 'a' && c <= 'z') ||
@@ -520,7 +521,7 @@ class TaskJuggler
     private
 
     def sTitle(level)
-      s = ''
+      s = +''
       if @richText.sectionNumbers
         1.upto(level) do |i|
           s += '.' unless s.empty?
@@ -536,7 +537,7 @@ class TaskJuggler
       attrs['class'] = @richText.cssClass if @richText.cssClass
       el = XMLElement.new("h#{level}", attrs)
       if @richText.sectionNumbers
-        s = ''
+        s = +''
         1.upto(level) do |i|
           s += '.' unless s.empty?
           s += "#{@data[i - 1]}"

data/lib/taskjuggler/RichText/FunctionExample.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = FunctionExample.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/RichText/FunctionHandler.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = FunctionHandler.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/RichText/Parser.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = Parser.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/RichText/RTFHandlers.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = RTFHandlers.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/RichText/RTFNavigator.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = RTFNavigator.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/RichText/RTFQuery.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = RTFQuery.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/RichText/RTFReport.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = RTFReport.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/RichText/RTFReportLink.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = RTFReportLink.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/RichText/RTFWithQuerySupport.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = RTFWithQuerySupport.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/RichText/Scanner.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = Scanner.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/RichText/Snip.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = Snip.rb -- The TaskJuggler III Project Management Software
@@ -36,7 +37,7 @@ class TaskJuggler
       @name = fileName.index('/') ? fileName[fileName.rindex('/') + 1 .. -1] :
                                     fileName
 
-      text = ''
+      text = +''
       File.open(fileName) do |file|
         file.each_line { |line| text += line }
       end

data/lib/taskjuggler/RichText/SyntaxRules.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = SyntaxRules.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/RichText/TOCEntry.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = TOCEntry.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/RichText/TableOfContents.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = TableOfContents.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/RichText.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = RichText.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/RuntimeConfig.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = RuntimeConfig.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/Scenario.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = Scenario.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/ScenarioData.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = ScenarioData.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/Scoreboard.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = Scoreboard.rb -- The TaskJuggler III Project Management Software
@@ -175,7 +176,7 @@ class TaskJuggler
     end
 
     def inspect
-      s = ''
+      s = +''
       0.upto(@sb.length - 1) do |i|
         s << "#{idxToDate(i)}: #{@sb[i]}"
       end

data/lib/taskjuggler/SheetHandlerBase.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = SheetHandlerBase.rb -- The TaskJuggler III Project Management Software
@@ -60,7 +61,7 @@ class TaskJuggler
       # The cutOut section
       cutOutText = nil
       quoteLen = 0
-      quoteMarks = emptyLine = ''
+      quoteMarks = emptyLine = +''
       text.each_line do |line|
         if cutOutText.nil?
           # We are looking for the line with the start marker (mark1)

data/lib/taskjuggler/SheetReceiver.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = SheetReceiver.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/SheetSender.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = SheetSender.rb -- The TaskJuggler III Project Management Software
@@ -248,8 +249,8 @@ EOT
     end
 
     def generateReport(id, reportDef)
-      out = ''
-      err = ''
+      out = +''
+      err = +''
       res = nil
       begin
         command = [ '--unsafe', '--silent', 'report', @projectId, id, '=', '.' ]

data/lib/taskjuggler/Shift.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = Shift.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/ShiftAssignments.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = ShiftAssignments.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/ShiftScenario.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = ShiftScenario.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/SimpleQueryExpander.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = SimpleQueryExpander.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/StatusSheetReceiver.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = StatusSheetReceiver.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/StatusSheetSender.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = StatusSheetSender.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/StdIoWrapper.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = StdIoWrapper.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/SyntaxReference.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = SyntaxReference.rb -- The TaskJuggler III Project Management Software
@@ -276,7 +277,7 @@ class TaskJuggler
           $stderr.puts "ERROR: #{keyword} is not a known keyword.\n\n"
         end
         # Create list of top-level keywords.
-        kwdStr = ''
+        kwdStr = +''
         @keywords.each_value do |kwd|
           if kwd.contexts.empty? ||
              (kwd.contexts.length == 1 && kwd.contexts[0] == kwd)

data/lib/taskjuggler/TableColumnDefinition.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = TableColumnDefinition.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/TableColumnSorter.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = TableColumnSorter.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/Task.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = Task.rb -- The TaskJuggler III Project Management Software
@@ -39,7 +40,7 @@ class TaskJuggler
       # The components of the message are either UTF-8 text or RichText. For
       # the RichText components, we use the originally provided markup since
       # we compose the result as RichText markup first.
-      rText = ''
+      rText = +''
       if recursive
         list = @project['journal'].entriesByTaskR(self, query.start, query.end,
                                                   query.hideJournalEntry)

data/lib/taskjuggler/TaskDependency.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = TaskDependency.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/TaskJuggler.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = TaskJuggler.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/TaskScenario.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = TaskScenario.rb -- The TaskJuggler III Project Management Software
@@ -645,7 +646,7 @@ class TaskJuggler
       end
       # Used for debugging only
       if false
-        pathText = ''
+        pathText = +''
         path.each do |t, e|
           pathText += "#{t.fullId}(#{e ? 'end' : 'start'}) -> "
         end
@@ -2764,7 +2765,7 @@ class TaskJuggler
         query.string = date.to_s(query.timeFormat)
       else
         query.sortable = query.numerical = -1
-        query.string = ''
+        query.string = +''
       end
     end
 

data/lib/taskjuggler/TernarySearchTree.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = TernarySearchTree.rb -- The TaskJuggler III Project Management Software
@@ -85,8 +86,8 @@ class TaskJuggler
         if index == maxIdx
           # We've reached the end of the search pattern.
           if partialMatch
-            # The strange looking ('' << val) is for Ruby 1.8 compatibility.
-            return collect { |v| str[0..-2] + ('' << v) }
+            # The strange looking (+'' << val) is for Ruby 1.8 compatibility.
+            return collect { |v| str[0..-2] + (+'' << v) }
           else
             return str if @last
           end
@@ -128,8 +129,8 @@ class TaskJuggler
       result = []
 
       result += @smaller.collect(str, &block) if @smaller
-      # The strange looking ('' << val) is for Ruby 1.8 compatibility.
-      newStr = str.nil? ? ('' << @value) : str + ('' << @value)
+      # The strange looking (+'' << val) is for Ruby 1.8 compatibility.
+      newStr = str.nil? ? (+'' << @value) : str + (+'' << @value)
       result << yield(newStr) if @last
       result += @equal.collect(newStr, &block) if @equal
       result += @larger.collect(str, &block) if @larger

data/lib/taskjuggler/TextFormatter.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = TextFormatter.rb -- The TaskJuggler III Project Management Software
@@ -34,7 +35,7 @@ class TaskJuggler
     # first line will be indented by @firstLineIndent. Lines that are longer
     # than @width will be clipped.
     def indent(str)
-      out = ''
+      out = +''
       # Indentation to be used for the currently processed line. It will be
       # set to nil if it was inserted already.
       indentBuf = ' ' * @firstLineIndent
@@ -73,11 +74,11 @@ class TaskJuggler
     # Format the String _str_ according to the class settings.
     def format(str)
       # The resulting String.
-      @out = ''
+      @out = +''
       # The column of the last character of the current line.
       @linePos = 0
       # A buffer for the currently processed word.
-      @wordBuf = ''
+      @wordBuf = +''
       # True of we are at the beginning of a line.
       @beginOfLine = true
       # A buffer for the indentation to be used for the next line.
@@ -175,7 +176,7 @@ class TaskJuggler
 
       # Append the word and reset the @wordBuf.
       @out += @wordBuf
-      @wordBuf = ''
+      @wordBuf = +''
       @linePos += wordLength
       @beginOfLine = false if @beginOfLine
     end

data/lib/taskjuggler/TextParser/MacroTable.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = MacroTable.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/TextParser/Pattern.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = Pattern.rb -- The TaskJuggler III Project Management Software
@@ -323,7 +324,7 @@ class TaskJuggler::TextParser
       # "Push" us on the stack.
       stack[self] = true
 
-      str = ''
+      str = +''
       first = true
       # Analyze the tokens of the pattern skipping the first 'skip' tokens.
       skip.upto(@lastSyntaxToken) do |i|

data/lib/taskjuggler/TextParser/Rule.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = Rule.rb -- The TaskJuggler III Project Management Software
@@ -158,11 +159,11 @@ class TaskJuggler::TextParser
     end
 
     def to_syntax(stack, docs, rules, skip)
-      str = ''
+      str = +''
       str << '[' if @optional || @repeatable
       str << '(' if @patterns.length > 1
       first = true
-      pStr = ''
+      pStr = +''
       @patterns.each do |pat|
         if first
           first = false

data/lib/taskjuggler/TextParser/Scanner.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = Scanner.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/TextParser/SourceFileInfo.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = SourceFileInfo.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/TextParser/StackElement.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = StackElement.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/TextParser/State.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = State.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/TextParser/TokenDoc.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = TokenDoc.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/TextParser.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = TextParser.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/TimeSheetReceiver.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = TimeSheetReceiver.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/TimeSheetSender.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = TimeSheetSender.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/TimeSheetSummary.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = TimeSheetSummary.rb -- The TaskJuggler III Project Management Software
@@ -67,7 +68,7 @@ EOT
     def sendSummary(resourceIds)
       setWorkingDir
 
-      summary = ''
+      summary = +''
       defaulterList = []
       getResourceList.each do |resource|
         resourceId = resource[0]
@@ -152,7 +153,7 @@ EOT
     end
 
     def getResourceJournal(sheetFile)
-      err = ''
+      err = +''
       status = nil
       report = nil
       warnings = nil

data/lib/taskjuggler/TimeSheets.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = TimeSheets.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/Tj3AppBase.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = Tj3AppBase.rb -- The TaskJuggler III Project Management Software
@@ -34,7 +35,7 @@ class TaskJuggler
       # Show some progress information by default
       @silent = false
       @configFile = nil
-      @mandatoryArgs = ''
+      @mandatoryArgs = +''
       @mininumRubyVersion = '1.9.2'
 
       # If stdout is not a tty, we don't use ANSI escape sequences to color

data/lib/taskjuggler/Tj3Config.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = Tj3Config.rb -- The TaskJuggler III Project Management Software

data/lib/taskjuggler/Tj3SheetAppBase.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby -w
+# frozen_string_literal: true
 # encoding: UTF-8
 #
 # = Tj3SheetAppBase.rb -- The TaskJuggler III Project Management Software