gettext 1.93.0 → 2.0.0

data/lib/gettext/textdomain_manager.rb

@@ -0,0 +1,224 @@
+=begin
+  gettext/textdomain_manager - GetText::TextDomainManager class
+
+  Copyright (C) 2009  Masao Mutoh
+
+  You may redistribute it and/or modify it under the same
+  license terms as Ruby.
+
+=end
+
+require 'gettext/textdomain'
+require 'gettext/class_info'
+require 'locale/util/memoizable'
+
+module GetText
+  class TextDomainManager
+    include Locale::Util::Memoizable
+
+    @@textdomain_pool = {}
+    @@textdomain_manager_pool = {}
+
+    @@output_charset = nil
+    @@gettext_classes = []
+
+    # Find textdomain by name
+    def self.textdomain_pool(domainname)
+      @@textdomain_pool[domainname]
+    end
+
+    # create or find a textdomain-manager for an given object/class
+    def self.get(obj)
+      klass = ClassInfo.normalize_class(obj)
+      manager = @@textdomain_manager_pool[klass]
+      return manager if manager
+      @@textdomain_manager_pool[klass] = TextDomainManager.new
+    end
+
+    # Set the value whether cache messages or not. 
+    # true to cache messages, otherwise false.
+    #
+    # Default is true. If $DEBUG is false, messages are not checked even if
+    # this value is true.
+    def self.cached=(val)
+      TextDomain.cached = val
+    end
+    
+    # Return the cached value.
+    def self.cached?
+      TextDomain.cached?
+    end
+
+    # Gets the output charset.
+    def self.output_charset
+      @@output_charset 
+    end
+
+    # Sets the output charset.The program can have a output charset.
+    def self.output_charset=(charset)
+      @@output_charset = charset
+      @@textdomain_pool.each do |key, textdomain|
+        textdomain.output_charset = charset
+      end
+    end
+   
+    # bind textdomain to the class.
+    def self.bind_to(klass, domainname, options = {})
+      warn "Bind the domain '#{domainname}' to '#{klass}'. " if $DEBUG
+
+      charset = options[:output_charset] || self.output_charset
+      textdomain = create_or_find_textdomain(domainname,options[:path],charset)
+
+      target_klass = ClassInfo.normalize_class(klass)
+      get(target_klass).add(textdomain, options[:supported_language_tags])
+      add_to_gettext_classes(target_klass)
+
+      textdomain
+    end
+
+    def self.each_textdomains(klass) #:nodoc:
+      ClassInfo.related_classes(klass, @@gettext_classes).each do |target|
+        msg = nil
+        get(target).textdomains.each do |textdomain|
+          yield textdomain
+        end
+      end
+    end
+
+    #
+    # Instance methods
+    #
+
+    # Returns the textdoman in the instance.
+    attr_reader :textdomains, :supported_language_tags
+  
+    def initialize
+      @textdomains = []
+      @supported_language_tags = nil
+    end
+
+    def add(textdomain, supported_language_tags)
+      @textdomains.unshift(textdomain) unless @textdomains.include? textdomain
+      @supported_language_tags = supported_language_tags if supported_language_tags
+    end
+
+    # Translates msgid, but if there are no localized text, 
+    # it returns a last part of msgid separeted "div" or whole of the msgid with no "div".
+    #
+    # * msgid: the message id.
+    # * div: separator or nil.
+    # * Returns: the localized text by msgid. If there are no localized text, 
+    #   it returns a last part of msgid separeted "div".
+    def translate_singluar_message(klass, msgid, div = '|')
+      lang = Locale.candidates(:supported_language_tags => @supported_language_tags, 
+                               :type => :posix)[0]
+      translate_singluar_message_to(lang, klass, msgid, div)
+    end
+
+    def translate_singluar_message_to(lang, klass, msgid, div = '|') #:nodoc:
+      msg = nil
+      # Find messages from related classes.
+      self.class.each_textdomains(klass) do |textdomain|
+        msg = textdomain.translate_singluar_message(lang, msgid)
+        break if msg
+      end
+      
+      # If not found, return msgid.
+      msg ||= msgid
+      if div and msg == msgid
+        if index = msg.rindex(div)
+          msg = msg[(index + 1)..-1]
+        end
+      end
+      msg
+    end
+    memoize :translate_singluar_message_to unless $DEBUG
+
+    # This function is similar to the get_singluar_message function 
+    # as it finds the message catalogs in the same way. 
+    # But it takes two extra arguments for plural form.
+    # The msgid parameter must contain the singular form of the string to be converted. 
+    # It is also used as the key for the search in the catalog. 
+    # The msgid_plural parameter is the plural form. 
+    # The parameter n is used to determine the plural form. 
+    # If no message catalog is found msgid1 is returned if n == 1, otherwise msgid2. 
+    # And if msgid includes "div", it returns a last part of msgid separeted "div".
+    #
+    # * msgid: the singular form with "div". (e.g. "Special|An apple", "An apple")
+    # * msgid_plural: the plural form. (e.g. "%{num} Apples")
+    # * n: a number used to determine the plural form.
+    # * div: the separator. Default is "|".
+    # * Returns: the localized text which key is msgid_plural if n is plural(follow plural-rule) or msgid.
+    #   "plural-rule" is defined in po-file.
+    #
+    # or
+    #
+    # * [msgid, msgid_plural] : msgid and msgid_plural an Array
+    # * n: a number used to determine the plural form.
+    # * div: the separator. Default is "|".
+    def translate_plural_message(klass, arg1, arg2, arg3 = "|", arg4 = "|")
+      lang = Locale.candidates(:supported_language_tags => @supported_language_tags, 
+                               :type => :posix)[0]
+      translate_plural_message_to(lang, klass, arg1, arg2, arg3, arg4)
+    end
+
+    def translate_plural_message_to(lang, klass, arg1, arg2, arg3 = "|", arg4 = "|")
+      # parse arguments
+      if arg1.kind_of?(Array)
+        msgid = arg1[0]
+        msgid_plural = arg1[1]
+        n = arg2
+        if arg3 and arg3.kind_of? Numeric
+          raise ArgumentError, _("3rd parmeter is wrong: value = %{number}") % {:number => arg3}
+        end
+        div = arg3
+      else
+        msgid = arg1
+        msgid_plural = arg2
+        n = arg3
+        div = arg4
+      end
+
+      # Find messages from related classes.
+      msgs = nil
+      self.class.each_textdomains(klass) do |textdomain|
+        msgs = textdomain.translate_plural_message(lang, msgid, msgid_plural)
+        break if msgs
+      end
+      
+      # If not found, return msgid.
+      msgs = [[msgid, msgid_plural], "n != 1"] unless msgs
+
+      msgstrs = msgs[0]
+      if div and msgstrs[0] == msgid and index = msgstrs[0].rindex(div)
+        msgstrs[0] = msgstrs[0][(index + 1)..-1]
+      end
+
+      # Return the singular or plural message.
+      plural = eval(msgs[1])
+      return msgstrs[plural] if plural.kind_of?(Numeric)
+      return plural ? msgstrs[1] : msgstrs[0]
+    end
+    memoize :translate_plural_message_to unless $DEBUG
+
+    # for testing.
+    def self.clear_all_textdomains
+      @@textdomain_pool = {}
+      @@textdomain_manager_pool = {}
+      @@gettext_classes = []
+    end
+    
+  private
+
+    def self.add_to_gettext_classes(klass)
+      @@gettext_classes << klass unless @@gettext_classes.include? klass
+    end
+
+    def self.create_or_find_textdomain(name, path, charset)#:nodoc:
+      textdomain = @@textdomain_pool[name]
+      return textdomain if textdomain
+
+      @@textdomain_pool[name] = TextDomain.new(name, path, charset)
+    end
+  end
+end

data/lib/gettext/tools.rb

@@ -0,0 +1,195 @@
+=begin
+  tools.rb - Utility functions
+
+  Copyright (C) 2005-2008 Masao Mutoh
+
+  You may redistribute it and/or modify it under the same
+  license terms as Ruby.
+=end
+
+require 'rbconfig'
+if /mingw|mswin|mswin32/ =~ RUBY_PLATFORM
+  ENV['PATH'] = %w(bin lib).collect{|dir|
+    "#{Config::CONFIG["prefix"]}\\lib\\GTK\\#{dir};"
+  }.join('') + ENV['PATH']
+end
+
+require 'gettext/tools/rgettext'
+require 'gettext/tools/rmsgfmt'
+require 'gettext/mofile'
+require 'fileutils'
+
+module GetText
+  bindtextdomain "rgettext"
+
+  BOM_UTF8 = [0xef, 0xbb, 0xbf].pack("c3")
+
+  # Currently, GNU msgmerge doesn't accept BOM. 
+  # This mesthod remove the UTF-8 BOM from the po-file.
+  def remove_bom(path)  #:nodoc:
+    bom = IO.read(path, 3)
+    if bom == BOM_UTF8
+      data = IO.read(path)[3..-1]
+      File.open(path, "w") {|f| f.write(data)}
+    end
+  end
+
+  # Merges two Uniforum style .po files together. 
+  #
+  # *Note* This function requires "msgmerge" tool included in GNU GetText. So you need to install GNU GetText. 
+  #
+  # The def.po file is an existing PO file with translations which will be taken 
+  # over to the newly created file as long as they still match; comments will be preserved,
+  # but extracted comments and file positions will be discarded. 
+  #
+  # The ref.pot file is the last created PO file with up-to-date source references but
+  # old translations, or a PO Template file (generally created by rgettext);
+  # any translations or comments in the file will be discarded, however dot
+  # comments and file positions will be preserved.  Where an exact match
+  # cannot be found, fuzzy matching is used to produce better results.
+  #
+  # Usually you don't need to call this function directly. Use GetText.update_pofiles instead.
+  #
+  # * defpo: a po-file. translations referring to old sources
+  # * refpo: a po-file. references to new sources
+  # * app_version: the application information which appears "Project-Id-Version: #{app_version}" in the pot/po-files.
+  # * Returns: self 
+  def msgmerge(defpo, refpo, app_version, options={})
+    verbose = options.delete(:verbose)
+    puts "msgmerge called" if verbose
+    $stderr.print defpo + " "
+
+    content = merge_po_files(defpo,refpo,options.delete(:msgmerge),verbose)
+    
+    if content.empty?
+      # report failure
+      failed_filename = refpo + "~"
+      FileUtils.cp(refpo, failed_filename)
+      $stderr.puts _("Failed to merge with %{defpo}") % {:defpo => defpo}
+      $stderr.puts _("New .pot was copied to %{failed_filename}") %{:failed_filename => failed_filename}
+      raise _("Check these po/pot-files. It may have syntax errors or something wrong.")
+    else
+      # update version and save merged data
+      content.sub!(/(Project-Id-Version\:).*$/, "\\1 #{app_version}\\n\"")
+      File.open(defpo, "w") {|f|f.write(content)}
+    end
+    
+    self
+  end
+
+  # Creates mo-files using #{po_root}/#{lang}/*.po an put them to 
+  # #{targetdir}/#{targetdir_rule}/. 
+  #
+  # This is a convenience function of GetText.rmsgfmt for multiple target files.
+  # * options: options as a Hash.
+  #   * verbose: true if verbose mode, otherwise false
+  #   * po_root: the root directory of po-files.
+  #   * mo_root: the target root directory where the mo-files are stored.
+  #   * mo_path_rule: the target directory for each mo-files.
+  def create_mofiles(options = {})
+    options = {:po_root => "./po"}.merge(options)
+
+    Dir.glob(File.join(options[:po_root], "*/*.po")) do |po_file|
+      mo_file = mo_file_from_po_file(po_file,options)
+      $stderr.print %Q[#{po_file} -> #{mo_file} ... ] if options[:verbose]
+      FileUtils.mkdir_p(File.dirname(mo_file))
+      rmsgfmt(po_file, mo_file)
+      $stderr.puts "Done." if options[:verbose]
+    end
+  end
+
+
+  # At first, this creates the #{po_root}/#{domainname}.pot file using GetText.rgettext.
+  # In the second step, this updates(merges) the #{po_root}/#{domainname}.pot and all of the
+  # #{po_root}/#{lang}/#{domainname}.po files under "po_root" using "msgmerge". 
+  #
+  # *Note* "msgmerge" tool is included in GNU GetText. So you need to install GNU GetText. 
+  #
+  # See <HOWTO maintain po/mo files(http://www.yotabanana.com/hiki/ruby-gettext-howto-manage.html)> for more detals.
+  # * domainname: the textdomain name.
+  # * targetfiles: An Array of target files, that should be parsed for messages (See GetText.rgettext for more details).
+  # * app_version: the application information which appears "Project-Id-Version: #{app_version}" in the pot/po-files.
+  # * options: a hash with following possible settings
+  #     :lang    - update files only for one language - the language specified by this option
+  #     :po_root - the root directory of po-files
+  #     :msgmerge - an array with the options, passed through to the gnu msgmerge tool
+  #                 symbols are automatically translated to options with dashes,
+  #                 example: [:no_wrap, :no_fuzzy_matching, :sort_output] translated to '--no-fuzzy-matching --sort-output'
+  #     :verbose - true to show verbose messages. default is false.
+  #
+  # Example: GetText.update_pofiles("myapp", Dir.glob("lib/*.rb"), "myapp 1.0.0", :verbose => true)
+  def update_pofiles(textdomain, files, app_version, options = {})
+    puts options.inspect if options[:verbose]
+
+    #write found messages to tmp.pot
+    temp_pot = "tmp.pot"
+    rgettext(files, temp_pot)
+
+    #merge tmp.pot and existing pot
+    po_root = options.delete(:po_root) || "po"
+    FileUtils.mkdir_p(po_root)
+    msgmerge("#{po_root}/#{textdomain}.pot", temp_pot, app_version, options.dup)
+
+    #update local po-files
+    only_one_language = options.delete(:lang)
+    if only_one_language
+      msgmerge("#{po_root}/#{only_one_language}/#{textdomain}.po", temp_pot, app_version, options.dup)
+    else
+      Dir.glob("#{po_root}/*/#{textdomain}.po") do |po_file|
+        msgmerge(po_file, temp_pot, app_version, options.dup)
+      end
+    end
+
+    File.delete(temp_pot)
+  end
+
+  private
+
+  # Merge 2 po files, using msgmerge
+  def merge_po_files(po_a,po_b,msgmerge_options=[],verbose=false)
+    return File.read(po_b) unless FileTest.exist? po_a
+
+    cmd = ENV["MSGMERGE_PATH"] || "msgmerge"
+    ensure_command_exists(cmd)
+
+    remove_bom(po_a)
+
+    cmd_params = array_to_cli_options(msgmerge_options)
+    to_run = "#{cmd} #{cmd_params} #{po_a} #{po_b}"
+    puts "\nrunning #{to_run}" if verbose
+    `#{to_run}`
+  end
+
+  # convert an array of String/Symbol to cli options
+  def array_to_cli_options(array)
+    [*array].map do |o|
+      o.kind_of?(Symbol) ? "--#{o}".gsub('_','-') : o.to_s
+    end.join(' ')
+  end
+
+  def ensure_command_exists(cmd)
+    `#{cmd} --help`
+    unless $? && $?.success?
+      raise _("`%{cmd}' can not be found. \nInstall GNU Gettext then set PATH or MSGMERGE_PATH correctly.") % {:cmd => cmd}
+    end
+  end
+
+  # where lies the mo file for a given po_file
+  # generare directory unless it exists
+  def mo_file_from_po_file(po_file,options)
+    options = {
+      :mo_root => "./data/locale",
+      :mo_path_rule => "%{lang}/LC_MESSAGES"
+    }.merge(options)
+    
+    lang, textdomain = %r[/([^/]+?)/(.*)\.po].match(po_file[options[:po_root].size..-1]).to_a[1,2]
+
+    mo_dir_rule = File.join(options[:mo_root], options[:mo_path_rule])
+    mo_dir = mo_dir_rule % {:lang => lang}
+    File.join(mo_dir, "#{textdomain}.mo")
+  end
+end
+
+if __FILE__ == $0
+  GetText.update_pofiles("foo", ARGV, "foo 1.1.0")
+end

data/lib/gettext/{rgettext.rb → tools/rgettext.rb}

@@ -2,11 +2,11 @@
 =begin
   rgettext.rb - Generate a .pot file.
 
-  Copyright (C) 2003-2006  Masao Mutoh
+  Copyright (C) 2003-2009  Masao Mutoh
   Copyright (C) 2001,2002  Yasushi Shoji, Masao Mutoh
  
       Yasushi Shoji   <yashi at atmark-techno.com>
-      Masao Mutoh     <mutoh at highway.ne.jp>
+      Masao Mutoh     <mutomasa at gmail.com>
  
   You may redistribute it and/or modify it under the same
   license terms as Ruby.
@@ -32,16 +32,16 @@ module GetText
     [
       ["glade.rb", "GladeParser"],
       ["erb.rb", "ErbParser"],
-      ["active_record.rb", "ActiveRecordParser"],
+#      ["active_record.rb", "ActiveRecordParser"],
 #      ["ripper.rb", "RipperParser"],
       ["ruby.rb", "RubyParser"] # Default parser.
     ].each do |f, klass|
       begin
-	require "gettext/parser/#{f}"
-	@ex_parsers << GetText.const_get(klass)
+        require "gettext/parser/#{f}"
+        @ex_parsers << GetText.const_get(klass)
       rescue
-	$stderr.puts _("'%{klass}' is ignored.") % {:klass => klass}
-	$stderr.puts $! if $DEBUG
+        $stderr.puts _("'%{klass}' is ignored.") % {:klass => klass}
+        $stderr.puts $! if $DEBUG
       end
     end
 
@@ -73,7 +73,8 @@ module GetText
       sign = off <= 0 ? '-' : '+'
       time += sprintf('%s%02d%02d', sign, *(off.abs / 60).divmod(60))
 
-      %Q[# SOME DESCRIPTIVE TITLE.
+      <<TITLE
+# SOME DESCRIPTIVE TITLE.
 # Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
 # This file is distributed under the same license as the PACKAGE package.
 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
@@ -89,42 +90,42 @@ msgstr ""
 "MIME-Version: 1.0\\n"
 "Content-Type: text/plain; charset=UTF-8\\n"
 "Content-Transfer-Encoding: 8bit\\n"
-"Plural-Forms: nplurals=INTEGER; plural=EXPRESSION;\\n"]
+"Plural-Forms: nplurals=INTEGER; plural=EXPRESSION;\\n"
+TITLE
     end
 
     def generate_pot(ary) # :nodoc:
       str = ""
-      result = Array.new
       ary.each do |key|
-	msgid = key.shift
-	curr_pos = MAX_LINE_LEN
-	key.each do |e|
-	  if curr_pos + e.size > MAX_LINE_LEN
-	    str << "\n#:"
-	    curr_pos = 3
-	  else
-	    curr_pos += (e.size + 1)
-	  end
-	  str << " " << e
-	end
-	msgid.gsub!(/"/, '\"')
-	msgid.gsub!(/\r/, '')
-	if msgid.include?("\004")
-	  msgctxt, msgid = msgid.split(/\004/)
-	  str << "\nmsgctxt \"" << msgctxt << "\"\n"
+        msgid = key.shift
+        curr_pos = MAX_LINE_LEN
+        key.each do |e|
+          if curr_pos + e.size > MAX_LINE_LEN
+            str << "\n#:"
+            curr_pos = 3
+          else
+            curr_pos += (e.size + 1)
+          end
+          str << " " << e
+        end
+        msgid.gsub!(/"/, '\"')
+        msgid.gsub!(/\r/, '')
+        if msgid.include?("\004")
+          msgctxt, msgid = msgid.split(/\004/)
+          str << "\nmsgctxt \"" << msgctxt << "\"\n"
         else
           str << "\n"
-	end	
-	if msgid.include?("\000")
-	  ids = msgid.split(/\000/)
-	  str << "msgid \"" << ids[0] << "\"\n"
-	  str << "msgid_plural \"" << ids[1] << "\"\n"
-	  str << "msgstr[0] \"\"\n"
-	  str << "msgstr[1] \"\"\n"
-	else
-	  str << "msgid \"" << msgid << "\"\n"
-	  str << "msgstr \"\"\n"
-	end
+        end
+        if msgid.include?("\000")
+          ids = msgid.split(/\000/)
+          str << "msgid \"" << ids[0] << "\"\n"
+          str << "msgid_plural \"" << ids[1] << "\"\n"
+          str << "msgstr[0] \"\"\n"
+          str << "msgstr[1] \"\"\n"
+        else
+          str << "msgid \"" << msgid << "\"\n"
+          str << "msgstr \"\"\n"
+        end
       end
       str
     end
@@ -142,7 +143,7 @@ msgstr ""
                single_msg[0] != plural_msg[0])
             if single_msg[0] != key 
               warn %Q[Warning: n_("#{plural_msg[0].gsub(/\000/, '", "')}") and n_("#{single_msg[0].gsub(/\000/, '", "')}") are duplicated. First msgid was used.] 
-                used_plural_msgs << single_msg[0]
+              used_plural_msgs << single_msg[0]
             end
 
             single_msg[1..-1].each do |line_info|
@@ -167,17 +168,17 @@ msgstr ""
     def parse(files) # :nodoc:
       ary = []
       files.each do |file|
-	begin
-	  @ex_parsers.each do |klass|
-	    if klass.target?(file)
-	      ary = klass.parse(file, ary)
-	      break
-	    end
-	  end
-	rescue
-	  puts "Error occurs in " + file
-	  raise
-	end
+        begin
+          @ex_parsers.each do |klass|
+            if klass.target?(file)
+              ary = klass.parse(file, ary)
+              break
+            end
+          end
+        rescue
+          puts "Error occurs in " + file
+          raise
+        end
       end
       normalize(ary)
     end
@@ -193,33 +194,33 @@ msgstr ""
       opts.separator(_("Specific options:"))
 
       opts.on("-o", "--output=FILE", _("write output to specified file")) do |out|
-	unless FileTest.exist? out
-	  output = File.new(File.expand_path(out), "w+")
-	else
-	  $stderr.puts(_("File '%s' already exists.") % out)
-	  exit 1
-	end
+        unless FileTest.exist? out
+          output = File.new(File.expand_path(out), "w+")
+        else
+          $stderr.puts(_("File '%s' already exists.") % out)
+          exit 1
+        end
       end
 
       opts.on("-r", "--require=library", _("require the library before executing rgettext")) do |out|
-	require out
+        require out
       end
 
       opts.on("-d", "--debug", _("run in debugging mode")) do
-	$DEBUG = true
+        $DEBUG = true
       end
 
       opts.on_tail("--version", _("display version information and exit")) do
-	puts "#{$0} #{VERSION} (#{DATE})"
-	puts "#{File.join(Config::CONFIG["bindir"], Config::CONFIG["RUBY_INSTALL_NAME"])} #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}]"
-	exit
+        puts "#{$0} #{VERSION} (#{DATE})"
+        puts "#{File.join(Config::CONFIG["bindir"], Config::CONFIG["RUBY_INSTALL_NAME"])} #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}]"
+        exit
       end
 
       opts.parse!(ARGV)
 
       if ARGV.size == 0
-	puts opts.help
-	exit 1
+        puts opts.help
+        exit 1
       end
 
       [ARGV, output]
@@ -227,38 +228,34 @@ msgstr ""
 
     def run(targetfiles = nil, out = STDOUT)  # :nodoc:
       if targetfiles.is_a? String
-	targetfiles = [targetfiles]
+        targetfiles = [targetfiles]
       elsif ! targetfiles
-	targetfiles, out = check_options
+        targetfiles, out = check_options
       end
 
       if targetfiles.size == 0
-	raise ArgumentError, _("no input files")
+        raise ArgumentError, _("no input files")
       end
 
       if out.is_a? String
-	File.open(File.expand_path(out), "w+") do |file|
-	  file.puts generate_pot_header
-	  file.puts generate_pot(parse(targetfiles))
-	end
+        File.open(File.expand_path(out), "w+") do |file|
+          file.puts generate_pot_header
+          file.puts generate_pot(parse(targetfiles))
+        end
       else
-	out.puts generate_pot_header
-	out.puts generate_pot(parse(targetfiles))
+        out.puts generate_pot_header
+        out.puts generate_pot(parse(targetfiles))
       end
       self
     end
   end
-
-  module_function
-  # Creates a po-file from targetfiles(ruby-script-files, ActiveRecord, .rhtml files, glade-2 XML files), 
+  extend self
+  # Creates a po-file from targetfiles(ruby-script-files, .rhtml files, glade-2 XML files), 
   # then output the result to out. If no parameter is set, it behaves same as command line tools(rgettet). 
   #
   # This function is a part of GetText.create_pofiles.
   # Usually you don't need to call this function directly.
   #
-  # *Note* for ActiveRecord, you need to run your database server and configure the config/database.xml 
-  # correctly before execute this function.
-  #
   # * targetfiles: An Array of po-files or nil.
   # * out: output IO or output path.
   # * Returns: self