jota 0.9.0.dev7 → 0.9.0

data/INSTALL

@@ -1,128 +1,180 @@
 
-$Id: INSTALL 248 2010-04-11 10:07:21Z dz $
-
 Jota is a written in the Ruby programming language and uses GTK+ Widgets.
 
-To set up a working run time environment to have to install the
-following packages:
-
-- Ruby interpreter		often already installed
-- GTK+ libraries		comes with Gnome, you probably have it already
-- libglade			a library for loadable user interfaces
-				part of the GTK+ project
-- Ruby bindings for GTK+ and libglade
-- Ruby Gems			the Ruby packet manager
-
-
-PREREQUISITES
--------------
-
-For the common operating systems you can use the following command:
-
-* Ubuntu/Debian
-
-  % apt-get install libglade2-ruby1.8 rubygems
-
+Before you can install Jota you must install the Ruby programming language
+and the GTK+ widget set.
 
-* FreeBSD
+You need:
 
-  % portinstall ruby18-libglade2 ruby18-gems
+ - The Ruby language: compiler, runtime, libraries
+ - Gem: The Ruby package manager. Sometimes included in the Ruby package
+ - Build tools (optional): If you want to install the GTK+ bindings with Ruby's
+   package manager 'gem', you need the so called build tools, like 
+   C-compiler, linker, make-tools, and so on. The build tools are needed,
+   because the system dependent parts of the GTK+ gem are compiled during
+   installation.
+ - GTK+: The graphics library and widget set, known from Gnome and Gimp
+ - GTK+ Bindings for Ruby: A library so that you can access GTK+ from Ruby
+ - Jota: Finally Jota itself. This is also a Ruby gem.
 
-	or
 
-  % cd /usr/ports/devel/ruby-libglade2
-  % make
-  % make install
-
-
-* Fedora (unfinished)
-
-  % yum install ... 
-
-
-* OpenSUSE
+INSTALLING
+==========
 
-  Does not work for 11.0, probably 10.0 and maybe 11.1. Sorry!
+For the most common operating systems the steps are as follows:
 
-  At first, install the packages ruby and rubygems from the standard SUSE
-  repositories. Because the other GTK+ related packages that you will 
-  need are not in these repositories, you have to fetch and install the 
-  RPMs manually. Read 
-    http://ruby-gnome2.sourceforge.jp/hiki.cgi?Install+Guide+for+SUSE
-  and fetch the tgz, e.g. 
+Ubuntu/Debian Linux
+-------------------
+(Tested with Ubuntu 11.04 and Debian 6.0 (squeeze))
 
-  % wget http://franz.hob-bruneck.info/downloads/suse100/ruby-gnome2/0.14.1/\
-    ruby-gnome2-0.14.1.suse100.tar.gz
+Install Ruby + Gems:
+  apt-get install ruby rubygems
 
-  Create a temporary directory somewhere
+Install GTK+ + Ruby bindings:
+  apt-get install libgtk2-ruby          # (recommended)
+or
+  apt-get install build-essential    
+  gem install gtk2
   
-  % mkdir opensuse.tmp
-  % cd opensuse.tmp
-
-  Unpack and install the necessary RPMs
-
-  % tar xvfz ../ruby-gnome2*.tar.gz
-  % rpm -i ruby-glib2*
-  % rpm -i ruby-atk*
-  % rpm -i ruby-pango*
-  % rpm -i --nodeps ruby-gdkpixbuf2*
-  % rpm -i ruby-gtk2*
-  % rpm -i ruby-libglade2*
-
-
-
-* Windows
-
-  Windows of course has no sophisticated package management. You have to
-  download and install the following by hand.
-
-  Go to http://ruby-gnome2.sourceforge.jp/hiki.cgi?Install+Guide+for+Windows
-  and follow the three steps. In short:
-
-  1. Install Ruby from
-     http://rubyforge.org/frs/download.php/47082/ruby186-27_rc2.exe
-     (enable RubyGems). Install into default installation directory.
-  2. Install GTK+ Bindingf for Ruby from
-     http://prdownloads.sourceforge.net/ruby-gnome2/ruby-gnome2-0.16.0-1-i386-mswin32.exe?download
+Install Jota:
+  gem install jota                      # (recommended)
+or
+  Download a jota-VER.gem from http://rubygems.org/gems/jota. VER stand
+  for the version you are looking for.
+  gem install jota-VER.gem
+
+Call Jota:
+or
+  /var/lib/gems/1.8/bin/jota
+or
+  Append the line
+    PATH="$PATH:/var/lib/gems/1.8/bin"
+  to $HOME/.bashrc (or consult your shell's manpage for the correct file
+  and/or syntax)
+
+  Then you can invoke Jota by calling jota
+
+  (Please see https://launchpad.net/bugs/145267 for details, why invoking
+  a gem is not straight forward on Ubuntu)
+
+
+Fedora Linux
+------------
+(Tested with Fedora 14)
+
+Install Ruby + Gems:
+  yum install ruby rubygems
+
+Install GTK+ + Ruby bindings:
+  yum install ruby-gtk2                 # (recommended)
+or
+  yum groupinstall "Development Tools" "Legacy Software Development"
+  yum install gtk2-devel
+  gem install gtk2
+
+Install Jota:
+  gem install jota                      # (recommended)
+or
+  Download a jota-VER.gem from http://rubygems.org/gems/jota. VER stand
+  for the version you are looking for.
+  gem install jota-VER.gem
+
+Call Jota:
+  jota
+
+
+OpenSUSE Linux
+--------------
+(Tested with OpenSUSE 11.4)
+
+Install Ruby + Gems:
+  zypper install ruby rubygems
+
+Install GTK+ + Ruby bindings:
+  zypper install -t pattern devel_C_C++
+    (There is no prebuild ruby-gtk package, therefore we need this 
+    cumbersome way to install the Ruby bindings for GTK+.)
+  gem install gtk2
+
+Install Jota:
+  gem install jota			# (recommended)
+or
+  Download a jota-VER.gem from http://rubygems.org/gems/jota. VER stand
+  for the version you are looking for.
+  gem install jota-VER.gem
+
+Call Jota:
+  jota
+
+
+FreeBSD
+-------
+(Tested with FreeBSD 8.2)
 
+Install Ruby + Gems:
+  cd /usr/ports/lang/ruby18; make install # (Select OK)
+  cd /usr/ports/devel/ruby-gems; make install
 
-INSTALLING
-----------
+Install GTK+ + Ruby bindings:
+  cd /usr/ports/x11-toolkits/ruby-gem2; make install  # (recommended)
+or
+  gem install gtk2
 
-Now install Jota as a ruby gem:
+Install Jota:
+  gem install jota			# (recommended)
+or
+  Download a jota-VER.gem from http://rubygems.org/gems/jota. VER stand
+  for the version you are looking for.
+  gem install jota-VER.gem
 
-	gem install jota 
+Call Jota:
+  jota
 
-alternatively, download jota-$VERSION.gem and install it with
 
-	gem install jota-$VERSION.gem
+Windows
+-------
+(Tested with Windows XP)
 
-On Windows Vista you must execute gem as administrator. To do so enter
-"gem install jota" in the run box (Start menu, at the bottom) and hit
-Ctrl-Shift-Enter. Then accept the UAC dialog with "Continue".
+Install Ruby + Gems:
+  Goto http://rubyinstaller.org
+  Download the latest 1.8.x version (at least 1.8.7)
+  Install 
+    Install into default folder (like c:\Ruby187)
+    Check box: Add Ruby executable to your PATH
+    Check box: Associate .rb and .rbw files with this Ruby installation
 
+Install GTK+ + Ruby bindings:
+  Execute (1): gem install gtk2
 
+Install Jota:
+  Execute (1): gem install jota		# (recommended)
+or
+  Download a jota-VER.gem from http://rubygems.org/gems/jota. VER stands
+  for the version you are looking for.
+  Execute (1): gem install jota-VER.gem
 
-RUNNING
--------
+Call Jota:
+  Execute(1): jota
+or
+  Create a shortcut and point it to 
+  "C:\Ruby187\bin\rubyw C:\Ruby187\bin\jota" (2)
 
-Unix:
+When you call jota with rubyw instead of ruby, you won't get a command
+window hanging around.
 
-Normally, binaries installed through gems should be in the path, so you
-can simply invoke Jota with the command jota
 
-If the binary is not in the path, you have to find out the full pathname. 
-This is gems dependant. For Ubuntu Linux, the full name is 
-/var/lib/gems/1.8/bin/jota
+(1) Execute either by
+    - clicking Start->Run on Windows XP
+    - hitting Win-R
+    - opening a command prompt window (cmd.exe) and entering a command
 
-Windows:
+(2) Use the install path from the first step instead of c:\Ruby187,
+    if different.
 
-You can run Jota through: Start->Execute: "Jota" or create a shortcut and
-point it to C:\Ruby\bin\jota.cmd
 
 
 UPDATING
---------
+========
 
 gem update jota
 
@@ -133,14 +185,13 @@ gem install jota
 gem cleanup jota
 
 
+
 DEVELOPMENT TOOLS
------------------
+=================
 
 If you want to contribute to the development of Jota you need the following
 tools:
 
-- rake		"make" supplement with ruby syntax
+- rake		"make" alternative with ruby syntax
 - rdoc		inline documentation generator
 - rtags		"tags" for ruby code
-
-

data/lib/gui.rb

@@ -1,6 +1,6 @@
 #!/usr/bin/env ruby
 
-# $Id: gui.rb 299 2011-02-24 21:19:55Z dz $
+# $Id: gui.rb 300 2011-04-18 08:38:44Z dz $
 
 
 # rdoc: see http://en.wikibooks.org/wiki/Ruby_Programming/RubyDoc
@@ -37,7 +37,7 @@ require 'preferences'
 
 class Gui
 
-require 'libglade2'
+require 'gtk2'
 
 attr :glade
 

data/lib/version.rb

@@ -1,5 +1,5 @@
 
-# $Id: version.rb 298 2011-02-23 14:44:55Z dz $
+# $Id: version.rb 302 2011-08-03 13:28:05Z dz $
 
 
 class Version
@@ -7,7 +7,7 @@ class Version
 def Version.state
 	result = ""
 	if STATE != "" then
-		result = "#{STATE}"
+		result = ".#{STATE}"
 		if STATEVER > 0 then
 			result += ("%d" % STATEVER)
 		end
@@ -23,16 +23,16 @@ def Version.platform
 	return "#{RUBY_PLATFORM}"
 end
 
-# Semantic versioning used. See http://semver.org for details
+# Rational Versioning Policy: http://docs.rubygems.org/read/chapter/7
 
 MAJOR = 0
 MINOR = 9
 PATCH = 0
-STATE = "dev"	# "dev", "beta", "rc", "" (for final)
-STATEVER = 7
+STATE = ""	# "dev", "rc", or ""
+#STATE = "dev"	# "dev", "rc", or ""
+STATEVER = 8
 
 STRING = "%d.%d.%d%s" % [MAJOR, MINOR,PATCH,Version.state]
-GEM_STRING = "%d.%d.%d.%s" % [MAJOR, MINOR,PATCH,Version.state]
 
 PROGRAM_NAME = "Jota"
 PROGRAM_NAMELC = PROGRAM_NAME.downcase

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: jota
 version: !ruby/object:Gem::Version 
-  hash: 1641194486
-  prerelease: true
+  hash: 59
+  prerelease: false
   segments: 
   - 0
   - 9
   - 0
-  - dev7
-  version: 0.9.0.dev7
+  version: 0.9.0
 platform: ruby
 authors: 
 - Derik van Zuetphen
@@ -16,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-02-27 20:40:19 +01:00
+date: 2011-08-03 15:32:48 +02:00
 default_executable: 
 dependencies: []
 
@@ -70,7 +69,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
 required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
   requirements: 
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version 
       hash: 31
       segments: 
@@ -78,8 +77,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       - 0
       - 0
       version: 0.0.0
-requirements: []
-
+requirements: 
+- GTK+ ruby bindings, you can either use your package manager or do gem install gtk2
 rubyforge_project: jota
 rubygems_version: 1.3.7
 signing_key: