3rdRail 1.2 Release Notes

By: Mark Deckert

Abstract: Release Notes

These notes apply to the 3rdRail 1.2 Release.

For updates to these notes, see https://dn.codegear.com/article/38274.

    Post Installation Instructions

    Confirm the Installation

To confirm a good installation from the command prompt or the shell:

  1. Run ruby -v. This should return: Ruby version 1.8.5 or higher.
  2. Run rails -v. This should return: Rails version 1.2 or higher.

    Configure the Ruby Interpreter

After installing and launching 3rdRail you will need to specify a “workspace”, which is a container directory for your projects. You can create new workspaces and switch workspaces from within 3rdRail. For every new workspace you will need to specify a Ruby interpreter.

From the IDE to configure the Ruby interpreter:

  1. Select Window->Preferences->Ruby->Interpreters.
  2. Either try the Search... button or Add and browse for the ruby executable file in the Ruby installation directory.
  3. Once the installed Ruby interpreter is shown in the Ruby Interpreters list, ensure its checkbox is checked and click OK.

Note: Selection lists for gem install and script/plugin install may be slow during their initial use.

    New Features in this Version

In this release, we have added support for Problem Detection and Correction. For more information see the "What's New" Help topic.

    Product Updates

The 3rdRail team expects to update the product regularly. You can check for updates using the Update Manager, found under the Help menu.

    Reporting Bugs

Please report bugs and make suggestions for improvements to 3rdRail via Quality Central at https://qc.codegear.com.

    Known Issues

These issues may affect your projects:

ID Number



Intermittent long pauses when editing Ruby files under Linux Ubuntu and Ruby 1.8.5. Upgrading to Ruby 1.8.6 with i686 ISA alleviates this problem.


The "Stop the Server" button fails to stop the WEBrick web server on Mac OS X 10.5 and Ubuntu 7.10. The workaround is to use the Mongrel web server.


Running a server using Run in Mozilla on Ubuntu 7.10 does not show an embedded browser. Workaround: run `sudo apt-get install libstdc++5`.


Gem installation fails on Mac OS X if prerequisites are not met. Workaround: Install XCode.


Add column to table does not work with SQLite 3.13 and Mac OS X 10.4.11. Workaround:

  • Build latest sqlite3 library (3.5.6) from source:
    cd sqlite-3.5.6
    ./configure sudo make install
  • Reinstall gem:
    sudo gem uninstall sqlite3-ruby
    sudo gem install sqlite3-ruby


The "Form Partial for Model" wizard may add the Partial to the wrong Controller in the case that there are two identically named controllers which are distinguished only by namespace differences.


Setting Visual Effects on Ubuntu 7.10 results in an empty installer window. Workaround: Set [System]|[Preferences]|[Appearance]|[Visual Effects] to "None".


Lack of support for UTF-8 encoded documents results in the corrupted display of Japanese characters on the Windows platform when the display of a document encoded in this manner is requested (e.g. running "rake notes" from the Workspace Commander).


If 3rdRail has been launched from a terminal, required password entry for external processes (e.g. repository access without cached credentials) must be entered from the terminal which launched 3rdRail.


EUC-JP locale on Ubuntu causes errors in the display of the Welcome Page.


Installation of subversion Win32 package built against Apache 2.2 will cause 3rdRail to crash. Workaround: Uninstall subversion and reinstall subversion built against Apache 2.0 or rename APR_ICONV_PATH environment variable to APR_ICONV1_PATH before you start 3rdRail.
Note: This is fixed in subversion 1.5, which has not yet been released. (Workaround information from subclipse.tigris.org)


Due to an issue with the ruby-debug gem version 0.10.1, step return does not pause execution when the fast ruby debugging engine is enabled. Workaround: choose "Basic Ruby Debugging Engine" from Ruby->Debug->Engines in the Preferences Menu.


When run as an unprivileged user, the uninstaller fails to ask permission to execute as the superuser and instead fails to uninstall correctly. Workaround: execute the uninstaller using sudo.


The installer does not execute correctly if run from within a mounted iso. Workaround: copy the contents of the iso to a local directory and run from there.


Due to an issue with Subclipse, renaming an SVN Project which has been imported from another workspace (or otherwise had its working copy moved) fails. Workaround: run `chflags -R nouchg {PROJECT_DIRECTORY}` and then "Refresh" inside Eclipse.


Installing the oracle adapter gem (activerecord-oracle-adapter) fails. This is a problem with Rails Core.


[Use Step Filters] tool bar button is disable in [Debug] view.


Referencing a named or formatted_ Route helper method causes an invalid Phantom Route marker to appear. Workaround: update to latest version from the update site.


With [Use Step Filters] enabled, the debugger may step into a filtered class it should step over.


Due to a possible SQLite3 or Ruby issue, migrations fail if a project path contains a double byte (Japanese) character.

    Enabling the Fast Debugger

A new debugger with significant speed improvements and support for Rails projects is now available. The following steps are necessary to enable this new debugger:


  1. Execute "gem install ruby-debug --include-dependencies"

Mac and Linux:

  1. Execute "sudo gem install ruby-debug --include-dependencies".

Copyright CodeGear™ 2007-2008. All rights reserved.

Server Response from: ETNASC01