rhodes 3.3.3.beta.4 → 3.3.3

data/doc/build.txt

@@ -1,4 +1,4 @@
-# Build Rhodes Application
+# Build Rhodes Application
 
 This page describes how to build Rhodes Application on all of our supported platforms: iPhone, RIM Blackberry, Windows Mobile and Android.
 
@@ -773,6 +773,7 @@ You can also clean emulator and start emulator again:
 Press Menu button on emulator. Go to Downloads, run Rhodes
 
 ## Build for Symbian
+** NOTE: Symbian support is discontinued. **
 
 Note that Symbian versions of your Rhodes app must be built in a Windows environment.
 
@@ -858,7 +859,7 @@ Make sure you have installed the following software.
 * Windows Mobile 6 Professional SDK(s) 
 * Microsoft Active Sync 4.5 for Windows XP; Windows Mobile Device Center for Windows Vista or higher
 * Microsoft Device Emulator 3.0 for Windows Vista or higher
-* Visual Studio 2005 Service Pack 1 installed or Visual Studio 2008. 
+* Visual Studio 2008. 
 * Software for unzipping a zip file, such as [7-zip](http://www.7-zip.org/)
 
 NOTE: It is a good idea to install Windows Mobile 6 Professional last, since it needs to be installed after Visual Studio, and since the Windows Mobile 6 Professional install process will tell you if you forgot to install any of the other prerequisites.
@@ -898,14 +899,14 @@ Also check that the vcbuild path is shown in the rhobuild.yml file. The rhobuild
 
 	env:
 	  paths:
-	    vcbuild: C:/Program Files/Microsoft Visual Studio 8/VC/vcpackages/vcbuild.exe
+	    vcbuild: C:/Program Files/Microsoft Visual Studio 9/VC/vcpackages/vcbuild.exe
 	    cabwiz: C:/Program Files/Windows Mobile 6 SDK/Tools/CabWiz
 
 On 64-bit installations:
 
 	env:
 	  paths:
-	    vcbuild: C:/Program Files (x86)/Microsoft Visual Studio 8/VC/vcpackages/vcbuild.exe
+	    vcbuild: C:/Program Files (x86)/Microsoft Visual Studio 9/VC/vcpackages/vcbuild.exe
 	    cabwiz: C:/Program Files (x86)/Windows Mobile 6 SDK/Tools/CabWiz
 
 ### Setup target SDK and emulator
@@ -1039,16 +1040,16 @@ To read the log file from the emulator or your device:
 ### Prerequisites
 
 * Follow [All Platforms Prerequisites](#all-platforms-prerequisites)
-* Visual Studio 2005 Service Pack 1 installed, Visual Studio 2008 or Visual Studio 2010 (Express editions are also supported)
+* Visual Studio 2008
 * WTL : http://wtl.sourceforge.net/ :
 	* unzip to folder: <VS path>\VC\WTL
 	* open in Visual studio menu `Tools\Options\Projects and solutions\VC++ directories`. Select platform - `Win32`; Show directories for - `Include files`; Add - `$(VCInstallDir)wtl\include`
 
 ### Build application from the command line
 
-Make sure that path to vcbuild.exe (something like `C:\Program Files\Microsoft Visual Studio 8\VC\vcpackages`) is in your PATH env variable. The list of paths which should be in PATH env variable:
+Make sure that path to vcbuild.exe (something like `C:\Program Files\Microsoft Visual Studio 9\VC\vcpackages`) is in your PATH env variable. The list of paths which should be in PATH env variable:
 
-<i>C:\Program Files\Microsoft Visual Studio 8\Common7\IDE;C:\Program Files\Microsoft Visual Studio 8\VC\BIN;C:\Program Files\Microsoft Visual Studio 8\Common7\Tools;C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\bin;C:\Program Files\Microsoft Visual Studio 8\VC\PlatformSDK\bin;C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\bin</i>
+<i>C:\Program Files\Microsoft Visual Studio 9\Common7\IDE;C:\Program Files\Microsoft Visual Studio 9\VC\BIN;C:\Program Files\Microsoft Visual Studio 9\Common7\Tools;C:\Program Files\Microsoft Visual Studio 9\Common7\Tools\bin;C:\Program Files\Microsoft Visual Studio 9\VC\PlatformSDK\bin;C:\Program Files\Microsoft Visual Studio 9\SDK\v2.0\bin</i>
 
 If you use Visual Studio 2010 : add path to `msbuild` to `rhobuild.yml` in rhodes folder:
 
@@ -1233,7 +1234,7 @@ So if you change icon of application, you have to restart device/simulator(unins
 You can change icon for your Symbian application replacing icon.svg which is in your application icon folder with a new one.
 
 ## Upgrade application
-Rhodes 3.3 support application code upgrade for iPhone(non AppStore distribution) and Windows Mobile.
+Rhodes 3.3 support application code upgrade for iPhone(non AppStore distribution), Android and Windows Mobile.
 
 ### Prepare application package
 
@@ -1244,6 +1245,13 @@ To prepare upgrade package for iPhone run in application folder:
 
 Application package will be placed to <app_root>/bin/target/iphone
 
+To prepare upgrade package for Android run in application folder:
+
+	:::term
+    $ rake build:android:upgrade_package
+    
+Application package will be placed to <app_root>/bin/target/android
+
 To prepare upgrade package for Windows Mobile run in application folder:
 
 	:::term
@@ -1272,8 +1280,11 @@ Unzip and replace package:
 
 Application will restart automatically.
 
-NOTE: On iPhone application has to be manually started.
+NOTE: On iPhone and Android application has to be started manually.
+
+NOTE: When using Rho::RhoSupport.rhobundle_download method on a network that has proxies, you may need to configure a proxy exception on the device, if your  HTTP server is also on that same network. Ex: local network has an IP subnet of 192.168 and it uses a proxy. On the Windows Mobile device go into System >> Settings >> Connections >>Advanced and add 192.168.* to the proxy exception list. 
 
+NOTE: The URL parameter for rhobundle_download must be a HTTP URL - FTP is not supported
     
 ### Sample
 See [Reload bundle demo](http://github.com/rhomobile/ReloadBundleDemo) for more information.

data/doc/configuration.txt

@@ -98,6 +98,14 @@ Max log file size in Bytes, set 0 to unlimited size; when limit is reached, log
 
 	MaxLogFileSize=50000
 
+Custom log file path
+
+	LogFilePath = '/mnt/sdcard/myapp.log'
+
+Enables the logging of memory usage in the system; specifies the time interval in milliseconds at which memory logs will be generated periodically
+
+	LogMemPeriod=5000
+
 Turn on local http server traces, off by default
 
 	net_trace = 0
@@ -126,14 +134,6 @@ Sync server url, typically this will look like 'http://<hostname>:<port>/applica
 
 	syncserver = 'http://localhost:9292/application'
 
-Geo location update period (in seconds). Used as default value for third parameter of GeoLocation.set_notification method. This value is passed to OS API and behaviour is OS dependent (it should be used by system as a tip how often call notification back). Ignored on iOS.
-
-	gps_ping_timeout_sec = 30
-
-Geo location inactivity timeout (in seconds). This parameter controls the time after that location service is switched off in case no calls to the service. It also used as time period to drop cached location value.
-	
-	geo_location_inactivity_timeout = gps_ping_timeout_sec * 10
-
 Set this option to 1 in order to open Rhodes app in full screen mode. Default is 1 for Android up to Rhodes 2.2.5. On all other platforms and on Android from Rhodes > 2.2.5 default is 0
 	
 	full_screen = 1

data/doc/connect-to-web-services.txt

@@ -8,7 +8,7 @@ Below is the list of available `AsyncHttp` methods you can use to asyncrhonously
 ### Common Parameters
 * `:url` - URL of the request.
 * `:headers` - Hash of headers to send with the request.
-* `:callback` - Callback action to execute when the request is done.
+* `:callback` - Callback action to execute when the request is done. This must be a controller action.
 * `:callback_param` - (optional) Parameters to send to the callback. Parameters values should be url encoded:
 
         :callback_param => "action=text&title=#{Rho::RhoSupport.url_encode(@params['page_title'])}"

data/doc/device-caps.txt

@@ -34,6 +34,7 @@ Rhodes provide access to device specific capabilities such as GPS, PIM, camera,
 	<tr><td class='cap'>Native Maps</td><td>1.4</td><td class='tbd'>3.5</td><td class='tbd'>TBD</td><td>1.4</td><td>1.5</td><td class='tbd'>3.5</td><td class='tbd'>TBD</td></tr>
 	<tr><td class='cap'>Alerts/Audio File Playback</td><td>1.2</td><td>1.5</td><td class='tbd'>TBD</td><td>1.2</td><td>1.2</td><td>3.1</td><td class='tbd'>TBD</td></tr>
 	<tr><td class='cap'>Ringtones</td><td>3.5</td><td>1.5</td><td class='tbd'>TBD</td><td>1.5</td><td>1.5</td><td class='tbd'>3.5</td><td class='tbd'>TBD</td></tr>
+	<tr><td class='cap'>Printing</td><td>3.4</td><td>3.4</td><td class='tbd'>TBD</td><td class='tbd'>TBD</td><td class='tbd'>TBD</td><td class='tbd'>TBD</td><td class='tbd'>TBD</td></tr>
 </table>	
 
 ## System class
@@ -120,9 +121,16 @@ Set application icon badge (number) - only for iPhone. set badge to 0 (zero) for
 	:::ruby
 	System.set_application_icon_badge(badge_number)
 
-Switch locale at runtime:
+Switch application locale at runtime:
 	:::ruby
     System::set_locale('es') #set current locale to Spanish
+    
+This call does not change OS Locale, it will change only LocalizationSimplified locale used in helper methods. See [Localization](/device-caps#localization) for more information.
+
+To get current application Locale:
+	:::ruby
+    LocalizationSimplified::get_cur_locale #get current application locale
+
 
 ### Sample
 See layout.erb of [System API Sample application](http://github.com/rhomobile/rhodes-system-api-samples/tree/master/app/layout.erb)  for some of the examples of how to use System class. There is also [system test](http://github.com/rhomobile/rhodes-system-api-samples/tree/master/app/SystemTest/controller.rb) which demonstrate System class usage.
@@ -201,7 +209,7 @@ Rhodes will update location using network data until the GPS signal has been rec
 There are two ways to use GeoLocation.
 
  * Synchronous call to GeoLocation module for particular value.
- * Set GeoLocation notification and track location by call back. In this case all location values are passed to notification as parameters.
+ * Set GeoLocation notification (geoLocation.set_notification) and track location by the notification callback. In this case all location values are passed to notification as parameters in a @param variable.
 
 Note that GeoLocation is switched off automatically when the application goes into the background, and is switched on as the application goes back to foreground.
 However it is possible to switch on location services as usual while the application is in background.
@@ -243,40 +251,32 @@ Set callback to track location changes.
 
 	:::ruby
 	GeoLocation.set_notification(
-		callback, callback_param="", ping_gpssystem_timeout=0)
+		callback, callback_param="", ping_gpssystem_interval=0)
 
-* callback - callback url; after the callback has been called once, it will be automatically called repeatedly with the current location coordinates passed to the callback as parameters. (You need not reset the callback within the callback.)
-* callback_param: known_position, latitude, longitude, available, status, error_code, accuracy
-* ping_gpssystem_timeout - optional, if 0 system timeout used, use to redefine timeout in sec for gps system reading
+* callback - url for the notification callback; after the callback has been called once, it will automatically be called repeatedly with the current location coordinates passed to the callback in the @params variable. (You need not reset the callback within the callback.)
+* callback_param: this string will be added to the body of the callback url. You can use it to identity who is setting up the callback, such as "my_tag=55". In general you do not set callback_param (leave it blank as in "").
+* ping_gpssystem_interval – Optional. If 0, the system interval is used; the callback is executed when the GPS system processes a location update (dependent on the mobile platform). If set to a number (such as 3), the callback is executed at an interval of this number of seconds (such as every three seconds).
 
-Here are the callback parameters for the set_notification callback.
+When the GeoLocation.set_notification callback is called, it will receive a variable called @params, just like a normal Rhodes controller action. Here are the parameters included in the @params variable.
 
-* known_position - 1 or 0.
+* known_position - 1 or 0
 * latitude
 * longitude
-* available - 1 or 0. Availability of GeoLocation: not only does the hardware exist, but also the user can turn GPS off in phone settings, or not allowed GPS activity on iPhone, etc.)
+* available - 1 or 0. This is the availability of GeoLocation: not only does the hardware exist, but also the user can turn GPS off in phone settings, or not allow GPS activity on iPhone, etc.
 * status - 'error' or 'ok'
 * error_code - from RhoError.
 * accuracy - horizontal radius in meters; iOS and Android.
 
-**NOTE: You should call GeoLocation.set_notification only once. The current behavior of the callback is that it will be called forever until it is stopped; you need to call `GeoLocation.turnoff` to stop it. The previous behavior was that the callback was called once and needed to be reset.**
+**NOTE: You only need to call GeoLocation.set_notification once. The current behavior of the callback is that it will be called forever until it is stopped; you need to call `GeoLocation.turnoff` to stop it. The previous behavior was that the callback was called once and needed to be reset.**
 
-Also there are two parameters you can set in rhoconfig.txt:
-
-GeoLocation update period (in seconds): `gps_ping_timeout_sec`. Used as the default value for the third parameter (ping_gpssystem_timeout) of GeoLocation.set_notification method. This value is passed to OS API and behaviour and is OS dependent (it should be used by system as a tip on how often to call notification back). Ignored on iOS.
-
-	gps_ping_timeout_sec = 30
-
-GeoLocation inactivity timeout (in seconds): `geo_location_inactivity_timeout`. This parameter controls the time after that location service is switched off in case there are no calls to the service. It is also used as the time period to drop cached location value.
-	
-	geo_location_inactivity_timeout = gps_ping_timeout_sec * 10
+**NOTE: We do not have a timeout parameter to automatically turn off the GPS system. If you want to turn off the GPS system, call GeoLocation.turnoff.**
 
 Turn off GeoLocation. 
 
 	:::ruby
 	GeoLocation.turnoff
 
-**NOTE: GeoLocation.turnoff - after GPS is switched off, you might still receive a few callbacks (this depends on the platform; iOS does not receive callbacks after turnoff).**
+**NOTE: When you call GeoLocation.turnoff, after the GPS is switched off, you might still receive a few callbacks (this depends on the platform; iOS and Android does not receive callbacks after turnoff).**
 
 Get the distance between two points in miles.
 	:::ruby
@@ -304,7 +304,7 @@ You may decide to keep track of your position right after application starts. To
     class AppApplication < Rho::RhoApplication
       def on_activate_app
         #start geolocation
-        GeoLocation.set_notification("/app/Settings/geo_callback", "")
+        GeoLocation.set_notification("/app/Settings/geo_callback", "", 3)
       end
     end
 
@@ -402,6 +402,8 @@ For these selectors an additional params hash may be used. The next keys and val
 * :offset - offset from begin of contacts' list
 These two parameters are used to paginate contacts list. If used with :count exact number of returned contacts can be determined (for example for last page).
 
+:max_results - used with :count. maximum number of contacts to be returned.
+
 The next parameters are available at Android only.
 
  * :select - list of contact properties have to be selected from phonebook (Use it to enchance query performance)
@@ -413,11 +415,11 @@ Return hash of all properties of the contact identified by the provided id (show
 	:::ruby
 	Rho::RhoContact.find(@params['id'])
 
-Create new contact in the phonebook, set properties of the contact passed as parameter hash, and save created phonebook record (create). 
+Create new contact in the phonebook, set properties of the contact passed as parameter hash, and save created phonebook record (create). Return the new contact as a hash.
 	:::ruby
-	Rho::RhoContact.create!(@params['contact'])
+	created_contact = Rho::RhoContact.create!(@params['contact'])
 
-Find contact record in the phonebook, update record properties from the has passed as parameter and save updated record. Contact id passed in the hash (update):
+Find contact record in the phonebook, update record properties from the hash passed as parameter, and save updated record. Contact id passed in the hash (update):
 	:::ruby
 	Rho::RhoContact.update_attributes(@params['contact'])
 
@@ -546,7 +548,7 @@ Return hash of all properties of the events found by specified parameters (index
 	* 'occurring' searches for events that have any part of the event occurring during the period specified by start_date and end_date. 
 * include_repeating -  if false then only search based on an Event's START and END values and do not calculate repeating occurrences of the event; if true then repeating occurrences of an Event are included during the search. 
  
-Create new event in the calendar, set properties of the event(excluding 'id', which is generated) from passed as parameter hash, and save created calendar event (create), also return hash of all properties of the created event(include 'id' property):
+Create new event in the calendar, set properties of the event(excluding 'id', which is generated) from passed as parameter hash, and save created calendar event (create), also return hash of all properties of the created event (include 'id' property):
 	:::ruby
 	created_event = Rho::RhoEvent.create!(@params['event'])
 
@@ -642,15 +644,21 @@ Take a picture:
 	:::ruby
 	Camera::take_picture('/app/model/camera_callback', options_hash)
 
+Choose a picture from Image Gallery (currently supported only on iPhone):
+	:::ruby
+	Camera::choose_picture('/app/model/camera_callback', options_hash)
+
+
 options_has - hash contain additional parameters :
 
 * "camera_type" - "default"(is the same with "main"), "main", "front". Default value = "default"
 * "desired_width" - number, desired width in pixels. Default value = max camera width
 * "desired_height" - number, desired height in pixels. Default value = max camera height
 * "color_model" "RGB", "Grayscale". Default value = "RGB"
-* "format" "jpg", "png". Default value = "jpg"
+* "format" "jpg", "png". Default value = "jpg" If you do not define this property when use choose_picture, then on iOS type of image in Gallery will recognize and use the same (JPG or PNG) for save image to applications data.
 * "enable_editing" - boolean, enable post photo capture image customize (supported only on iPhone !). Default value = true. If you enable this, image will captured reduced to screen size (not full size)!
 * "flash_mode" - string, supported only on Android ! Values : "off", "on", "auto", "red-eye", "torch".
+* "save_to_shared_gallery" - boolean, supported for iOS. if true, picture you take will be added to the camera roll. Default value = false.
 
 Additional parameters in camera callback :
 
@@ -994,6 +1002,35 @@ Halt playing of a ringtone
 ### Sample
 See controller and view in the /app/Ringtones folder of the [System API Samples application](http://github.com/rhomobile/rhodes-system-api-samples/tree/master/app/Ringtones/controller.rb) for more information.
 
+
+## Printing
+
+### Printing on iOS
+iOS inlude printing support. You should prepare File for printing and open it by standart platform - use:
+	:::ruby
+	System.open_url(file_full_path)
+
+We recommend prepare PDF. You can use PDF-Writer pure Ruby library for it - we include it into rhodes - just include "pdf-writer" and "thread" extensions to your application extension list in build.yml :
+	:::yaml
+	extensions: ["pdf-writer", "thread"] 
+
+See example in our [System API Samples application Generate PDF example](http://github.com/rhomobile/rhodes-system-api-samples/tree/master/app/GeneratePDF/controller.rb) application.
+
+
+### Printing on Android
+Android do not support printing. You can use any third-party application for printing, for example Google Cloud Print application for print by using of Google Cloud Print web service.
+You should prepare file for printing and open it by standart platform - use:
+	:::ruby
+	System.open_url(file_full_path)
+Android platfrom open that file in application registered for file extension or show select dialog for manually choose application if there are more than one application registered for this extension.
+
+We recommend prepare PDF. You can use PDF-Writer pure Ruby library for it - we include it into rhodes - just include "pdf-writer" and "thread" extensions to your application extension list in build.yml.
+	:::yaml
+	extensions: ["pdf-writer", "thread"] 
+
+See example in our [System API Samples application Generate PDF example](http://github.com/rhomobile/rhodes-system-api-samples/tree/master/app/GeneratePDF/controller.rb) application.
+
+
 ## PUSH Notifications
 Push notification support is currently available for Android, Blackberry and iPhone. 
 

data/doc/extensions.txt

@@ -1342,7 +1342,7 @@ See [Rhodes-System-Api-Samples](http://github.com/rhomobile/rhodes-system-api-sa
 
 See [/app/NativeView/controller.rb](http://github.com/rhomobile/rhodes-system-api-samples/blob/master/app/NativeView/controller.rb) and [/app/NativeView/index.erb](http://github.com/rhomobile/rhodes-system-api-samples/blob/master/app/NativeView/index.erb) for details how to call native view from your controller.
 
-** NOTE:  Windows Mobile: Visual Studio 2005 has issues with long paths. If you have problems with building rainbow extension, move your rhodes folder to a shorter path. **
+** NOTE:  Windows Mobile: Visual Studio 2008 has issues with long paths. If you have problems with building rainbow extension, move your rhodes folder to a shorter path. **
 
 * To navigate to rainbow view in your controller, call `WebView.navigate('rainbow_view:red')`. In your url schema indicates view type you want to open and rest of the url (red) passed to the after it was created. 
 
@@ -1386,4 +1386,16 @@ Examples of how to use the url_for_nativeview method:
 
 ## Using LineaSDK in Rhodes (with using special Linea native extension)
 
-Please see the documentation at [LineaSDK as native extension in Rhodes applications](linea).
+Please see the documentation at [LineaSDK as native extension in Rhodes applications](linea).
+
+## Add registry setting in cab file om Windows Mobile/Windows CE
+
+In ext.yml file you should add rgeistry sections 
+
+    regkeys:
+      - key1
+      - key2
+
+Every key should be created as wrote in MSDN
+
+    http://msdn.microsoft.com/en-us/library/ms933191.aspx

data/doc/install.txt

@@ -1,24 +1,31 @@
 # Install Rhodes
 
+## Important note!
+
+Don't mix standalone ruby installation with ruby installation under rvm control. If you need just only version of ruby, then feel free to install it as standalone. If you need to install additional version of ruby, then uninstall standalone ruby and install all needed ruby versions under control of rvm.
+In case you have mixed standalone and rvm-controlled ruby installation they may conflict and produce runtime issues in Rhodes applications.
+
 ## Mac OS
 
-If you're running Mac OS, download the latest [RhoStudio for Macintosh](http://rhomobile.com/rhostudio-mac). This contains the [Ruby stack](http://www.ruby-lang.org/en/), [Redis](http://redis.io/), [RhoConnect](/rhoconnect/introduction) and [Rhodes](/rhodes/introduction).
+If you're running Mac OS, download the latest [Motorola RhoMobile Suite Installer for Macintosh](http://rhomobile.com/rhostudio-mac). This contains [Redis](http://redis.io/), [RhoConnect](/rhoconnect/introduction) and [Rhodes](/rhodes/introduction).
 
-Click on the RhoStudioInstaller for Mac download file to open it. You will get a window similar to this:
+Mac OS has [Ruby](http://www.ruby-lang.org/en/) installed. It is recommended that you install [Ruby Version Manager](https://rvm.io//) and install Ruby version 1.9.3.
 
-<img src="http://rhodocs.s3.amazonaws.com/rhodes-devel/rhostudio-mac-install.png" alt="RhoStudioInstaller Mac" />
+Click on the RhoMobileSuiteInstaller for Mac download file to open it. You will get a window similar to this:
 
-Run the install gems script appropriate for you. You can run "Install gems." If you have Ruby Version Manager, you can run "Install gems on rvm." A terminal window will open; wait for the gems install process to complete.
+<img src="http://rhodocs.s3.amazonaws.com/rhodes-devel/rhostudio-mac-install.png" alt="RhoStudioInstaller Mac" />
 
-Then drag RhoStudio to the Applications folder.
+Run the install gems script appropriate for you. If you have Ruby Version Manager, you can run "Install gems on rvm." A terminal window will open; wait for the gems install process to complete.
 
-You can also install Rhodes without RhoStudio by [installing Ruby and the Rhodes gem](/rhodes/install#rhodes-gem-for-linux-and-non-rhostudio). 
+Then drag Motorola RhoStudio to the Applications folder. 
 
 ## Windows
 
-If you're running Windows, download the latest [RhoStudio for Windows](http://rhomobile.com/rhostudio-windows). This installs the [Ruby stack](http://www.ruby-lang.org/en/), [Redis](http://redis.io/), [RhoConnect](/rhoconnect/introduction) and [Rhodes](/rhodes/introduction).
+If you're running Windows, download and run the latest [Motorola RhoMobile Suite Installer for Windows](http://rhomobile.com/rhostudio-windows) and run it. This installs the [Ruby stack](http://www.ruby-lang.org/en/), [Redis](http://redis.io/), [RhoConnect](/rhoconnect/introduction) and [Rhodes](/rhodes/introduction).
+
+If you are running Windows 64-bit, you need to use 32-bit Java when you run RhoStudio. You can include the 32-bit Java in the PATH, or you can run RhoStudio with a link to 32-bit Java:
 
-If you are running Windows 64-bit, you need to [install Ruby and the Rhodes gem](/rhodes/install#rhodes-gem-for-linux-and-non-rhostudio). If you also want RhoStudio, you need to have 64-bit Eclipse, and then you [install RhoStudio as a plugin for Eclipse](/rhodes/rhostudio-eclipse).
+	C:\RhoStudio\eclipse\RhoStudio.exe -vm "<32-bit java path>\bin\javaw.exe"
 
 Once the installer has completed, and you have installed the Java Development Kit, you can skip to the [Setup Rhodes section](#setup-rhodes).
 
@@ -32,34 +39,34 @@ The Sun JDK for Windows or Linux is available [here](http://java.sun.com/javase/
 
 For Mac OS 10.6 and earlier, the JDK is already installed. For Mac OS 10.7, Java is not automatically installed. Download the Java for Mac Installer from [Apple support](http://support.apple.com/kb/DL1421) and install Java.
 
+NOTE: To build for Android it is required JDK 1.6 (JDK 1.7 is not supported)
+
 ### Setting the JDK Path
 
 On Windows installs for RhoMobile, go to RhoStudio Preferences (Windows -> Preferences) and set the JDK path in the rhobuild.yml file. On Windows 64-bit installations, you must set this path to the 32-bit version of the JDK, such as `C:/Program Files (x86)/Java/jdk1.7.0_01/bin`.
 
 On Mac OS, the path to the JDK is automatically set once Java is installed.
 
-For non-RhoStudio installations, set the JDK path on the JAVA_HOME variable in your PATH.
+For Linux and for Rhodes installs from the command line, set the JDK path in JAVA_HOME and PATH.
 
-## Rhodes Gem for Linux and non-RhoStudio
+## Installing Rhodes from the Command Line
 
-For Linux installations, and for Windows or Mac OS installations that are not using RhoStudio, you need to install the Rhodes gem. Download and install:
+To install Rhodes on Linux, and to install Rhodes on Windows or Mac OS using the command line (this does not install RhoStudio), you need to install the Rhodes gem. Download and install:
 
-1. [Ruby v1.8.7](http://www.ruby-lang.org/en/downloads/) (On Windows, [RubyInstaller](http://rubyinstaller.org) is a convenient way to install Ruby.)
+1. [Ruby v1.9.3](http://www.ruby-lang.org/en/downloads/) (On Windows, [RubyInstaller](http://rubyinstaller.org) is a convenient way to install Ruby; you should check "Add Ruby executables to your PATH" and "Associate .rb and .rbw files with this Ruby installation".)
 
-2. [RubyGems](http://rubygems.org/pages/download) (RubyGems offers a .tgz, a .zip, and a .gem download. You want the .zip.) NOTE: Windows doesn't come with the necessary build tools to install gems ('make', for example). There are various ways to get these tools, but the GnuWin32 project at http://gnuwin32.sourceforge.net/ provides the tools, and can be conveniently installed via the GetGnuWin32 installer at http://sourceforge.net/projects/getgnuwin32/files/.
-
-3. Install the Rhode Gem.
-
-Run this command to install.
+2. Install the Rhodes Gem. Run this command to install.
 
 	:::term
   	$ [sudo] gem install rhodes
 
 NOTE: If you get any `no such file to load -- something` messages while running the rake tasks or rhodes commands, this can usually be resolved by putting "sudo" in front of the command, as in `sudo gem install something`.
 
-RhoSimulator, which comes with RhoStudio for Mac and Windows, does not work with Linux.
+NOTE: Windows doesn't come with the necessary build tools to install gems ('make', for example). There are various ways to get these tools, but the GnuWin32 project at http://gnuwin32.sourceforge.net/ provides the tools, and can be installed via the GetGnuWin32 installer at http://sourceforge.net/projects/getgnuwin32/files/. You should follow the GetGnuWin32 instructions carefully.
 
-You can [install RhoStudio as a plugin for Eclipse](rhostudio-eclipse) if you are not using RhoStudio for Macintosh or RhoStudio for Windows.
+You can [install RhoStudio as a plugin for Eclipse](rhostudio-eclipse).
+
+RhoSimulator, which comes with RhoStudio for Mac and Windows, does not work with Linux.
 
 ## Setup Rhodes
 
@@ -74,4 +81,6 @@ This will prompt you for where you installed the SDKs for the various platforms.
 
 If you are using RhoStudio, you can either run rhodes-setup, or you can set the SDK paths in RhoStudio Preferences.
 
+## Setting the Location of the RhoStudio Workspace Directory
 
+When you start RhoStudio, you can set the location of the workspace directory. The path to the workspace directory should not contain space symbols: if the path has spaces, a RhoConnect application created with RhoStudio will not work properly.