gettext 1.93.0 → 2.0.0

data/{NEWS → NEWS-1}

@@ -1,3 +1,5 @@
+(OBSOLETE: Move to ChangeLog since 2.0.0)
+
 = Ruby-GetText-Package-1.93.0 (2008-09-14)
  * Bulgarian added.
  * Estonian updated.

data/README.rdoc

@@ -0,0 +1,251 @@
+= gettext - Ruby-GetText-Package
+
+Ruby-GetText-Package is a Localization(L10n) library and tool  
+which is modeled after the GNU gettext package.
+
+This library translates original messages to localized  
+messages using client-side locale information(environment  
+variable or CGI variable).
+
+The tools for developers support creating, useing, and modifying  
+localized message files(message catalogs).
+
+((*Rails*))
+Rails support has been removed.  
+Rails / ActiveRecord specific code now lives in locale_rails[http://github.com/mutoh/locale_rails/tree/master], gettext_rails[http://github.com/mutoh/gettext_rails/tree/master] and gettext_activerecord[http://github.com/mutoh/gettext_activerecord/tree/master].
+
+== Website
+* homepage[http://www.yotabanana.com/hiki/ruby-gettext.html]
+* on rubyforge[http://gettext/rubyforge.org/]
+* on github[http://github.com/gettext/]
+
+== Features
+* Translate singular/plural messages with simple APIs(similar to GNU gettext)
+
+* Thread safety. Message resources are shared from all threads, but 
+  returns translated messages of the current thread's locale.
+
+* Tools to find message IDs
+  * Extract message IDs to po-files using rgettext from 
+    * ruby scripts 
+    * glade-2 XML file(.glade)
+    * ERB file(.rhtml, .erb)
+    * Anything (with your own parsers)
+    * The po-files are compatible to GNU gettext.
+
+  * rmsgfmt creates a mo-file from a po-file.
+    The mo-file is compatible to GNU gettext(msgfmt).
+
+  * Using rgettext/rmsgfmt as Rake tasks
+
+* textdomain's scope is adapt to ruby class/module mechanism.
+  * A class/module can have plural textdomains.
+  * a message is looked up in its class/module and ancestors.
+
+* CGI support (gettext/cgi)
+  * Locale is retrieved from client informations using Ruby-Locale.
+    (HTTP_ACCEPT_LANGUAGE, HTTP_ACCEPT_CHARSET, QUERY_STRING(lang), Cookies(lang)).
+
+* String%() is extended to use named argument such as <tt>%{foo}" %{:foo => 1}</tt>.
+  Notes that Ruby-1.9.x supports this format by itself.
+
+== Requirements
+* {Ruby 1.8.3 or later}[http://www.ruby-lang.org]
+* {Rubygems}[http://www.rubygems.org/]
+* {locale gem}[http://rubyforge.org/projects/locale/]
+  * $ gem install locale
+* (for development only)
+  * {GNU gettext 0.10.35 or later}[http://www.gnu.org/software/gettext/gettext.html]
+  * {Racc-1.4.3 or later}[http://www.ruby-lang.org/raa/list.rhtml?name=racc]
+    * (for compiling src/rmsgfmt.ry only)
+
+== Install
+* Uninstall old gettext if exists. (You need to do this when updating 1.93.0 -> 2.0.0)
+    (sudo/su on POSIX system)
+    gem uninstall gettext
+
+* gem
+    #from github (edge/unstable)
+    (sudo/su on POSIX system)
+    gem install locale
+    gem install mutoh-gettext -s http://gems.github.com/
+
+    #from rubyforge (stable)
+    (sudo/su on POSIX system)
+    gem install locale
+    gem install gettext
+
+* download tar-ball
+    # De-Compress archive and enter its top directory.
+    (sudo/su on POSIX system)
+    ruby setup.rb
+
+You can also install files in your favorite directory by  
+supplying setup.rb some options. Try <tt>ruby setup.rb --help</tt>.
+
+== Usage
+===Translation
+- _: Basic translation method
+  Translates the message.
+    _("Hello")
+
+The gettext methods comes in 3 combinable flavors
+- n: Pluralized
+  Returns singular or plural form, depending on how many you have.
+    n_("Apple", "%{num} Apples", 3)
+    n_(["Apple", "%{num} Apples"], 3)
+
+- p: context aware
+  A context is a prefix to your translation, usefull when one word has different meanings, depending on its context.
+    p_("Printer","Open") <=> p_("File","Open")
+    is the same as s_("Printer|Open")  <=> s_("File|Open")
+
+- s: without context
+  If a translation could not be found, return the msgid without context.
+    s_("Printer|Open") => "Öffnen" #translation found
+    s_("Printer|Open") => "Open"   #translation not found
+
+- combinations
+    np_("Fruit", "Apple", "%{num} Apples", 3)
+    ns_("Fruit|Apple","%{num} Apples", 3)
+
+    np_(["Fruit","Apple","%{num} Apples"], 3)
+    ns_(["Fruit|Apple","%{num} Apples"], 3)
+
+- N_, Nn_: Makes dynamic translation messages readable for the gettext parser.
+  <tt>_(fruit)</tt> cannot be understood by the gettext parser. To help the parser find all your translations,
+  you can add <tt>fruit = N_("Apple")</tt> which does not translate, but tells the parser: "Apple" needs translation.
+
+    fruit = N_("Apple")   # same as fruit = "Apple"
+    _(fruit)              # does a normal translation
+
+    fruits = Nn_("Apple", "%{num} Apples")
+    n_(fruits, 3)
+
+=== Bind textdomains to the classes.
+A textdomain has a translation file in each language.
+A module/class can have multi textdomains. This means the 
+libraries/applications can have their own textdomains.
+
+ class Foo
+   include GetText
+   bindtextdomain "your_app_domain_name"
+ end
+
+ class Book
+   include GetText
+   bindtextdomain "general"
+   bindtextdomain "book"
+ end
+
+=== Locale
+If you need to set the locale by yourself, then use:
+  GetText.locale = "en_US" # translate into english from now on
+  GetText.locale # => en_US
+Or
+  include GetText
+  set_locale "en_US"
+
+For more details and options, have a look at the samples folder or
+consult the tutorial[http://www.yotabanana.com/hiki/ruby-gettext-howto.html].
+
+== License
+This program is licenced under the same licence as Ruby.  
+(See the file 'COPYING'.)
+
+* mofile.rb
+  * Copyright (C) 2001-2009 Masao Mutoh <mutoh at highwhay.ne.jp>
+  * Copyright (C) 2001,2002 Masahiro Sakai <s01397ms at sfc.keio.ac.jp>
+
+* gettext.rb
+  * Copyright (C) 2001-2009 Masao Mutoh <mutoh at highwhay.ne.jp>
+  * Copyright (C) 2001,2002 Masahiro Sakai <s01397ms at sfc.keio.ac.jp>
+
+* rgettext 
+  * Copyright (C) 2001-2009 Masao Mutoh <mutoh at highwhay.ne.jp>
+  * Copyright (C) 2001,2002 Yasushi Shoji <yashi at atmark-techno.com>
+
+* setup.rb
+  * Copyright (C) 2000-2005 Minero Aoki <aamine at loveruby.net>
+  * This file is released under LGPL. See the top of the install.rb.
+
+* Others
+  * Copyright (C) 2001-2009 Masao Mutoh <mutoh at highwhay.ne.jp>
+
+
+== Translators
+* Bosnian(bs)                - Sanjin Sehic <saserr at gmail.com>
+* Bulgarian(bg)              - Sava Chankov <sava.chankov at gmail.com>
+* Catalan(ca)                - Ramon Salvadó <rsalvado at gnuine.com>
+* Chinese(Simplified)(zh_CN)
+  * Yang Bob <bob.yang.dev at gmail.com> (current)
+  * Yingfeng <blogyingfeng at gmail.com>
+* Chinese(Traditional)(zh_TW)
+  * Yang Bob <bob.yang.dev at gmail.com> (current)
+  * LIN CHUNG-YI <xmarsh at gmail.com>
+* Croatian(hr)               - Sanjin Sehic <saserr at gmail.com>
+* Czech(cs)                  - Karel Miarka <kajism at yahoo.com>
+* Dutch(nl)                  - Menno Jonkers <ruby-gettext at jonkers.com>
+* Esperanto(eo)              - Malte Milatz <malte at gmx-topmail.de>
+* Estonian(et)               - Erkki Eilonen <erkki at itech.ee>
+* French(fr)
+  * Vincent Isambart <vincent.isambart at gmail.com> (current)
+  * David Sulc <davidsulc at gmail.com>
+  * Laurent Sansonetti <laurent.sansonetti at gmail.com>
+* German(de)
+  * Patrick Lenz <patrick at limited-overload.de> (current)
+  * Detlef Reichl <detlef.reichl at gmx.org>
+  * Sven Herzberg <herzi at abi02.de>
+  * Sascha Ebach <se at digitale-wertschoepfung.de>
+* Greek(el)                  - Vassilis Rizopoulos <damphyr at gmx.net>
+* Hungarian(hu)              - Tamás Tompa <tompata at gmail.com>
+* Italian(it)
+  * Marco Lazzeri <marco.lazzeri at gmail.com>
+  * Gabriele Renzi <surrender_it at yahoo.it>
+* Japanese(ja)               - Masao Mutoh <mutomasa at gmail.com>
+* Korean(ko)                 - Gyoung-Yoon Noh <nohmad at gmail.com>
+* Latvian(lv)                - Aivars Akots <aivars.akots at gmail.com>
+* Norwegian(nb)              - Runar Ingebrigtsen <runar at mopo.no>
+* Portuguese(Brazil)(pt_BR)  
+  * Antonio S. de A. Terceiro <terceiro at softwarelivre.org> (current)
+  * Joao Pedrosa <joaopedrosa at gmail.com>
+* Russian(ru)                - Yuri Kozlov <kozlov.y at gmail.com>
+* Serbian(sr)                - Slobodan Paunović" <slobodan.paunovic at gmail.com>
+* Spanish(es)
+  * David Espada <davinci at escomposlinux.org> (current)
+  * David Moreno Garza <damog at damog.net>
+* Swedish(sv)                - Nikolai Weibull <mailing-lists.ruby-talk at rawuncut.elitemail.org>
+* Ukrainian(ua)              - Alex Rootoff <rootoff at pisem.net>
+* Vietnamese(vi)             - Ngoc Dao Thanh <ngocdaothanh at gmail.com>
+
+== Status of translations
+* Bosnian(bs)               - 1.90.0 (old)
+* Bulgarian(bg)             - 2.0.0 (new)
+* Catalan(ca)               - 2.0.0
+* Croatian(hr)              - 1.90.0 (old)
+* Chinese(zh_CN)            - 2.0.0
+* Chinese(zh_TW)            - 2.0.0
+* Czech(cs)                 - 1.9.0 (old)
+* Dutch(nl)                 - 1.90.0 (old)
+* English(default)          - 1.90.0 (old)
+* Esperanto(eo)             - 2.0.0
+* Estonian(et)              - 2.0.0
+* French(fr)                - 2.0.0
+* German(de)                - 2.0.0
+* Greek(el)                 - 2.0.0 
+* Hungarian(hu)             - 2.0.0
+* Italian(it)               - 1.6.0 (old)
+* Japanese(ja)              - 2.0.0
+* Korean(ko)                - 1.9.0 (old)
+* Latvian(lv)               - 2.0.0 (new)
+* Norwegian(nb)             - 2.0.0
+* Portuguese(Brazil)(pt_BR) - 2.0.0
+* Russian(ru)               - 2.0.0
+* Serbian(sr)               - 1.91.0 (old)
+* Spanish(es)               - 2.0.0
+* Swedish(sv)               - 0.8.0 (too much old)
+* Ukrainian(ua)             - 2.0.0
+* Vietnamese(vi)            - 2.0.0
+
+== Maintainer
+Masao Mutoh <mutomasa at gmail.com>

data/Rakefile

@@ -6,7 +6,7 @@
 # Use setup.rb or gem for installation.
 # You don't need to use this file directly.
 #
-# Copyright(c) 2005-2007 Masao Mutoh
+# Copyright(c) 2005-2009 Masao Mutoh
 # This program is licenced under the same licence as Ruby.
 #
 
@@ -17,16 +17,13 @@ require 'rake'
 require 'rake/packagetask'
 require 'rake/gempackagetask'
 require 'rake/rdoctask'
+require 'rake/testtask'
 require 'gettext/version'
 
-RUBYBIN = File.join(Config::CONFIG['bindir'], Config::CONFIG['ruby_install_name']) + " "
-
 PKG_VERSION = GetText::VERSION
 
-task :default => [:makemo]
-
 ############################################################
-# GetText tasks
+# GetText tasks for developing
 ############################################################
 desc "Create lib/gettext/poparser.rb"
 task :poparser do
@@ -36,9 +33,8 @@ task :poparser do
     puts "racc was not found: #{racc}"
     exit 1
   else FileTest.exist?(racc)
-    cmd = "#{RUBYBIN} #{racc} -g src/poparser.ry -o src/poparser.tmp.rb"
-    system(cmd)
-    $stderr.puts cmd
+    ruby "#{racc} -g src/poparser.ry -o src/poparser.tmp.rb"
+    $stderr.puts  %Q[ruby #{racc} -g src/poparser.ry -o src/poparser.tmp.rb]
 
     file = open(poparser_path, "w")
 
@@ -46,7 +42,7 @@ task :poparser do
     file.print <<-EOS
   poparser.rb - Generate a .mo
 
-  Copyright (C) 2003-2005 Masao Mutoh <mutoh@highway.ne.jp>
+  Copyright (C) 2003-2009 Masao Mutoh <mutomasa at gmail.com>
 
   You may redistribute it and/or modify it under the same
   license terms as Ruby.
@@ -59,43 +55,26 @@ EOS
     tmpfile.close
     File.delete("src/poparser.tmp.rb")
     $stderr.puts "Create #{poparser_path}."
-    require 'gettext/utils'
   end
 end
 
-############################################################
-# Manage po/mo files
-############################################################
-task :makemo_test do
-  begin
-    require 'gettext'
-    require 'gettext/poparser'
-    require 'gettext/utils'
-  rescue LoadError
-    puts "gettext/poparser was not found."
-  end
-  $stderr.puts "Create test mo files."
-  GetText.create_mofiles(false, "test/po", "test/locale")
-end
 
 desc "Create *.mo from *.po"
-task :makemo => [:makemo_test] do
-  $stderr.puts "Create rgettext/rails mo files."
-  mkdir_p "samples/rails/log" unless FileTest.exist? "samples/rails/log"
-
-  GetText.create_mofiles(false)
+task :makemo do
+  require 'gettext/tools'
+  GetText.create_mofiles
 
   $stderr.puts "Create samples mo files."
-  GetText.create_mofiles(false, "samples/po", "samples/locale")
+  GetText.create_mofiles(
+	:po_root => "samples/po", :mo_root => "samples/locale")
 
   $stderr.puts "Create samples/cgi mo files."
-  GetText.create_mofiles(false, "samples/cgi/po", "samples/cgi/locale")
-
-  $stderr.puts "Create samples/rails mo files."
-  GetText.create_mofiles(false, "samples/rails/po", "samples/rails/locale")
+  GetText.create_mofiles(
+	:po_root => "samples/cgi/po", :mo_root => "samples/cgi/locale")
 
-  $stderr.puts "Create samples/rails plugin mo files."
-  GetText.create_mofiles(false, "samples/rails/vendor/plugins/gettext/po", "samples/rails/vendor/plugins/gettext/locale")
+  $stderr.puts "Create test mo files."
+  GetText.create_mofiles(
+	:po_root => "test/po", :mo_root => "test/locale")
 end
 
 desc "Update pot/po files to match new version."
@@ -103,25 +82,21 @@ task :updatepo do
   begin
     require 'gettext'
     require 'gettext/poparser'
-    require 'gettext/utils'
+    require 'gettext/tools'
   rescue LoadError
     puts "gettext/poparser was not found."
   end
 
   rails = ["lib/gettext/rails.rb", "lib/gettext/active_record.rb"]
   #lib/gettext/*.rb -> rgettext.po
-  GetText.update_pofiles("rgettext", 
-			 Dir.glob("lib/**/*.rb") + ["src/poparser.ry"] - rails,
-			 "ruby-gettext #{GetText::VERSION}")
-
+  GetText.update_pofiles("rgettext",
+                         Dir.glob("lib/**/*.rb") + ["src/poparser.ry"] - rails,
+                         "ruby-gettext #{GetText::VERSION}")
   #lib/gettext/rails.rb -> rails.po
   GetText.update_pofiles("rails", rails,
-			 "ruby-gettext #{GetText::VERSION}")
+                         "ruby-gettext #{GetText::VERSION}")
 end
 
-desc "Setup Ruby-GetText-Package. (for setup.rb)"
-task :setup => [:makemo]
-
 desc "Gather the newest po files. (for me)"
 task :gatherpo => [:updatepo] do
   mkdir_p "pofiles/original" unless FileTest.exist? "pofiles/original"
@@ -136,11 +111,11 @@ task :gatherpo => [:updatepo] do
       mkdir_p "pofiles/#{lang}" unless FileTest.exist? "pofiles/#{lang}"
       copy f, "pofiles/#{lang}/"
       Dir.glob("pofiles/original/*.pot").each do |f|
-	newpo = "pofiles/#{lang}/#{File.basename(f, ".pot")}.po"
-	copy f, newpo unless FileTest.exist? newpo
+        newpo = "pofiles/#{lang}/#{File.basename(f, ".pot")}.po"
+        copy f, newpo unless FileTest.exist? newpo
       end
     end
-  end	
+  end
 end
 
 def mv_pofiles(src_dir, target_dir, lang)
@@ -181,24 +156,23 @@ task :deploypo do
     mv_pofiles(srcdir, "samples/rails/vendor/plugins/gettext/po", lang)
 end
 
-
 ############################################################
 # Package tasks
 ############################################################
-
 desc "Create gem and tar.gz"
 spec = Gem::Specification.new do |s|
   s.name = 'gettext'
   s.version = PKG_VERSION
   s.summary = 'Ruby-GetText-Package is a libary and tools to localize messages.'
   s.author = 'Masao Mutoh'
-  s.email = 'mutoh@highway.ne.jp'
+  s.email = 'mutomasa at gmail.com'
   s.homepage = 'http://gettext.rubyforge.org/'
   s.rubyforge_project = "gettext"
   s.files = FileList['**/*'].to_a.select{|v| v !~ /pkg|CVS/}
   s.require_path = 'lib'
   s.executables = Dir.entries('bin').delete_if {|item| /^\.|CVS|~$/ =~ item }
   s.bindir = 'bin'
+  s.add_dependency('locale', '>= 2.0.0')
   s.has_rdoc = true
   s.description = <<-EOF
         Ruby-GetText-Package is a GNU GetText-like program for Ruby.
@@ -222,17 +196,29 @@ end
 ############################################################
 # Misc tasks
 ############################################################
-desc "Test task (for shell environment only)"
-task :testunit => [:makemo_test] do 
-  sh 'cd test; sh test.sh'
+desc 'Run all tests'
+task :test do
+   Dir.chdir("test") do
+     if RUBY_PLATFORM =~ /win32/
+       sh "rake.bat", "test"
+     else
+       sh "rake", "test"
+     end
+   end
 end
 
 Rake::RDocTask.new { |rdoc|
+  begin
+    allison = `allison --path`.chop
+  rescue
+    allison = ''
+  end
   rdoc.rdoc_dir = 'doc'
   rdoc.title    = "Ruby-GetText-Package API Reference"
   rdoc.options << '--line-numbers' << '--inline-source'
   rdoc.rdoc_files.include('README', 'ChangeLog')
   rdoc.rdoc_files.include('lib/**/*.rb')
+  rdoc.template = allison if allison.size > 0
 }
 
 desc "Publish the release files to RubyForge."
@@ -240,10 +226,13 @@ task :release => [ :package ] do
   require 'rubyforge'
 
   rubyforge = RubyForge.new
+  rubyforge.configure
   rubyforge.login
-  rubyforge.add_release("gettext", "gettext", 
-                        "Ruby-GetText-Package #{PKG_VERSION}", 
+  rubyforge.add_release("gettext", "gettext",
+                        "Ruby-GetText-Package #{PKG_VERSION}",
                         "pkg/gettext-#{PKG_VERSION}.gem",
                         "pkg/ruby-gettext-package-#{PKG_VERSION}.tar.gz")
 end
 
+desc "Setup Ruby-GetText-Package. (for setup.rb)"
+task :setup => [:makemo]