rhodes 3.4.2 → 3.5.1.12

data/doc/extensions.txt

@@ -689,6 +689,102 @@ This sample listing of ext_build.files shows that it already lists the generated
 	:::term
 	ext/yourextension/platform/android/src/com/yourextension/Yourextension.java
 
+### Make changes to application AndroidManifest.xml
+
+You can specify changes to AndroidManifest.xml in the ext.yml file as a path to the files with the changes.
+There are three formats recognized by the build system, depending on the file extension:
+
+* .xml - xml file with common AndroidManifest.xml format; its tags will be merged into the final manifest.
+* .erb - ruby templates which will be injected into the final manifest.
+* .rb - ruby script which will run by manifest erb generator.
+
+	android:
+	  manifest_changes:
+	  - ext/yourextension/platform/android/AndroidManifestAdds.xml
+	  - ext/yourextension/platform/android/ApplicationTagAdds1.erb
+	  - ext/yourextension/platform/android/ApplicationTagAdds2.erb
+	  - ext/yourextension/platform/android/ManifestTagAdds.erb
+	  - ext/yourextension/platform/android/AndroidManifestScript.rb
+
+#### XML
+
+This is the simplest way, if you know how your manifest has to look. Add the final AndroidManifest.xml to the extension and specify it in ext.yml.
+The build system will try to merge all the tags from the file into the final AndroidManifest.xml. Tags which exist in both Rhodes and extension manifest will be overwritten from the extension manifest.
+
+	android:
+	  manifest_changes: ext/yourextension/platform/android/AndroidManifest.xml
+
+#### ERB template
+
+There are two common levels where additional definitions can be injected into AndroidManifest.xml.
+
+* Application tag
+* Manifest tag
+
+To add additional definitions to the Application tag, the template name must fit the file name mask of `Application*.erb`, such as `ApplicationManifestAdds.erb`.
+
+To add additional definitions to Manifest tag, the template name must fit the file name mask of `Manifest*.erb`.
+
+There may be a number of templates of each type.
+In the template, you may access manifest generator fields which holds common values used to generate the manifest. 
+Below is example of a broadcast receiver definition added to 'application' tag by rhoconnect-push extension:
+
+	:::xml
+	<receiver android:name="com.motsolutions.rhomobile.services.ans.test3.ANSBroadcastReceiver"
+	          android:permission="com.motsolutions.cto.services.ans.permission.RECEIVE"
+	          android:enabled="true">
+	    <!-- Receive actual messages -->
+	    <intent-filter>
+	        <action android:name="com.motsolutions.cto.services.ans.action.RECEIVE" />
+	        <category android:name='<%=@appPackageName%>' />
+	    </intent-filter>
+	    <!-- Receive registration ids -->
+	    <intent-filter>
+	        <action android:name="com.motsolutions.cto.services.ans.action.REGISTRATION" />
+	        <category android:name='<%=@appPackageName%>' />
+	    </intent-filter>
+	</receiver>
+
+
+#### RB script
+
+In case the methods listed above are not enough, you can write your own script that will change the values used to generate the manifest.
+You can hove a single script per extension.
+
+In the script, you may access the ERB generator instance as a local variable.
+
+	:::ruby
+	generator.permissions["#{generator.appPackageName}.permission.ANS"] = 'signature'
+	generator.usesPermissions << "#{generator.appPackageName}.permission.ANS"
+	generator.usesPermissions << 'com.motsolutions.cto.services.ans.permission.REGISTER'
+
+#### ERB Manifest Generator
+
+The following generator fields may be accessed from erb templates or scripts.
+
+* javaPackageName - read-only string
+* appPackageName - read-only string
+* versionName - read-write string
+* versionCode - read-write string
+* installLocation - read-write string
+* minSdkVer - read-write string
+* maxSdkVer - read-write string
+* permissions - hash of permission name/protectionLevel pairs
+* usesPermissions - array of permission names
+* usesLibraries - hash of library name/isRequired pairs
+* screenOrientation - read-write string
+* debuggable - read-write string (allows two values: 'true' or 'false')
+* rhodesActivityIntentFilters - array of hashes with filter values. Each hash can contain next keys:
+** :act - string, intent action name
+** :cat - array of strings with category names
+** :data - hash with data tag attributes (name/value pairs)
+* manifestManifestAdds - array of strings with full paths to erb templates for 'manifest' tag
+* applicationManifestAdds - array of strings with full paths to erb templates for 'application' tag
+
+For more details about the values for the generator fields, refer to [Android Developer Documentation](http://developer.android.com/guide/topics/manifest/manifest-intro.html).
+
+You may also look in your Rhodes installation under /platform/android/Rhodes/AndroidManifest.xml.erb to study how these values are used.
+
 ## Rewriting the Generated Native Extension Source Code for Windows Mobile
 
 The Windows Mobile generated native extension code is contained in the following structure.
@@ -1210,19 +1306,22 @@ Build your application as usual. It will call the build script for your extensio
 
 If you want to use any resources in your code, use com.rhomobile.rhodes.R instead of just R. This will make all resources (include your additonal resources) accessible from this R file.
 
-### Calling JNI Functions
+### Calling JNI Functions at Android
 
 If you need to call JNI functions from your native code, you need to retrieve the `JNIEnv *env` variable. To get it, include the file `RHO_ROOT/platform/android/Rhodes/jni/include/rhodes.h` in your C/C++ files. The global function `JNIEnv *jnienv()` is defined in this file, so use it anywhere when `JNIEnv *` needed.
 
-### Using Java Code in Native Extension
+### Using Java Code at Android
+
+Prepare a text file with list of your java files to build (one file with path per line) and set relative path to the file in ext.yml.
 
-If your native extension uses Java code, your build script should create file ext_build.files in the TARGET_TEMP_DIR. This file should contain java source file names (full names, with path) - one by line. Rhodes will include all of them to the final build.
+	android:
+	  source_list: ext/rhoconnect-push/platform/android/ext_build.files
 
-**NOTE: We recommend you use new android_additional_sources_list parameter from ext.yml config - just prepare file with list of your java files for build and set up that parameter.
+Also it is possible to prebuild jar library yourself and include it to build. See [Using Prebuilt Libraries (jars)](#using-prebuilt-libraries-jars)
 
 ### Using Prebuilt Libraries (jars)
 
-If your native extension uses prebuilt libraries (jars), your build script must copy all such jar files to the TARGET_TEMP_DIR. The jar files must have the extension '.jar'. Rhodes will include these files in the final build.
+If your native extension uses prebuilt libraries (jars), your build script has to copy all such jar files to the TARGET_TEMP_DIR. The jar files must have the extension '.jar'. Rhodes will include these files in the final build.
 
 ### Creating Native Threads
 

data/doc/install.txt

@@ -1,89 +1,45 @@
 # Install Rhodes
 
-## Mac OS
+## Installing Rhodes with RhoStudio
 
-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).
+The most common way to install Rhodes on a Windows or Macintosh platform is to install RhoMobile Suite. The RhoMobile Suite installer installs Rho products, such as Rhodes, RhoConnect, RhoElements, and RhoStudio. RhoStudio is an Eclipse installation that facilitates development of native smartphone applications.
 
-Although Mac OS has [Ruby](http://www.ruby-lang.org/en/) installed, the official way to install Ruby for RhoStudio is to install [Ruby Version Manager](https://rvm.io//) and then install Ruby version 1.9.3.
+[Click here for the RhoMobile Suite installation instructions](/rhomobile-install). 
 
-Click on the Motorola RhoMobile Suite Installer for Mac download file to open it. You will get a window similar to this:
-
-<img src="http://rhodocs.s3.amazonaws.com/rhodes-devel/rhostudio-mac-install.png" alt="RhoStudioInstaller Mac" />
-
-Run "Install gems" (this requires that you have installed Ruby Version Manager). A terminal window will open; wait for the gems install process to complete.
-
-Then drag Motorola RhoStudio to the Applications folder.
-
-**NOTE: Installing Ruby into the System folder is not supported by RhoMobile; the official RhoMobile way to install and use Ruby on the Macintosh is with Ruby Version Manager.**
-
-## Windows
-
-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:
-
-	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).
-
-## Java Development Kit (JDK)
-
-You need to have the Java Development Kit (JDK) installed for RhoStudio. If you are planning to build for Blackberry or Android, make sure you have JDK version 1.6.0_2 or higher installed; the 32-bit Windows version of the JDK is required for Blackberry tools.
-
-### Installing the Java Development Kit
-
-The Sun JDK for Windows or Linux is available [here](http://java.sun.com/javase/downloads/index.jsp). For Windows, install the 32-bit version of the JDK; RhoStudio needs the 32-bit version.
-
-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/jdk<version number>/bin`.
-
-On Mac OS, the path to the JDK is automatically set once Java is installed.
-
-For Linux and for Rhodes installs from the command line, set the JDK path in JAVA_HOME and PATH.
+NOTE: The rest of this chapter consists of instructions for installing Rhodes from the command line, without using the RhoMobile Suite installer. You do not need to perform those instructions if you installed using the RhoMobile Suite installer.
 
 ## Installing Rhodes from the Command Line
 
-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:
+To install Rhodes on Linux, and to install Rhodes on Windows or Mac OS using the command line (this does not install the RhoStudio IDE), you need to install the Rhodes gem. Download and install:
+
+1. [Ruby v1.9.3](http://www.ruby-lang.org/en/downloads/).
 
-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".)
+	* 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".
+    
+	* On Macintosh, Ruby is already installed, but this version is outdated and isn't compatible with RhoStudio: install [Ruby Version Manager](https://rvm.io//) (RVM) and then use RVM to install Ruby version 1.9.3.
 
 2. Install the Rhodes Gem. 
 
-Run this command to install the Rhodes Gem.
+	Run this command to install the Rhodes Gem.
 
-	:::term
-  	$ [sudo] gem install rhodes
+		:::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`.
 
 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.
 
-**NOTE: Installing RhoStudio as a plugin for Eclipse is currently disabled.**
-
-RhoSimulator, which comes with RhoStudio for Mac and Windows, does not work with Linux.
-
-## Setup Rhodes
+## Setup Rhodes SDKs
 
 Once you have Rhodes, you will need the SDKs for the platform you want to build your app on. These instructions are found [here](build).
 
-If you are not using RhoStudio, after you install the gem and your desired SDKs, you need to run:
+After you install the gem and your desired SDKs, you need to run:
 
 	:::term
 	$ rhodes-setup
 
 This will prompt you for where you installed the SDKs for the various platforms.  The installation script will display its best guess as to where the SDK is. You can then enter a new location, or leave it blank to use the suggestion. If you are not building for a specific platform (for example, you can't build for the iPhone on Windows), you can leave that SDK location blank. You can find prerequisites for each platform [here](build#all-platforms-prerequisites).
 
-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
+## Setting the JDK Path in Command Line Installations
 
-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.
-
-## Standalone Ruby Installation and Ruby Version Manager
-
-Do not install Ruby as a standalone if you also use Ruby Version Manager (rvm) to install Ruby. If you need only one version of Ruby, you can install Ruby as a standalone. If you need more than one version of Ruby, you should uninstall standalone Ruby and then install Ruby with Ruby Version Manager. Mixed standalone Ruby and rvm-controlled Ruby installations can conflict and cause runtime issues in Rhodes applications.
+For Linux and for Rhodes installs from the command line, set the JDK path in JAVA_HOME and PATH.

data/doc/linea.txt

@@ -19,7 +19,7 @@ Ruby interface located in [https://github.com/rhomobile/linea-rhodes/blob/master
 	#
 	#   Ruby interface of LineaSDK.
 	#   see LineaSDK.h and Linea documentation for details
-	#   This main class Linea have the very simiilar interface with main Linea class in objective-C LineaSDK
+	#   This main class Linea have the very similar interface with main Linea class in objective-C LineaSDK
 	#   All constants and methods have the same name and practically the same results/parameters (with little Ruby specific)
 	#   All method can raise Ruby exception like methods of Linea objective-C class
 	#
@@ -195,7 +195,7 @@ Ruby interface located in [https://github.com/rhomobile/linea-rhodes/blob/master
 	# Prints EAN128 optimized barcode. Supported only on PP-60, DPP-350 and DPP-250 printers, it makes the barcode lot smaller especially when numbers only are used
 		BAR_PRN_EAN128AUTO = 11
 
-	# Barcode Text Positopn
+	# Barcode Text Position
 		BAR_TEXT_NONE = 0
 		BAR_TEXT_ABOVE = 1
 		BAR_TEXT_BELOW = 2
@@ -257,7 +257,7 @@ Ruby interface located in [https://github.com/rhomobile/linea-rhodes/blob/master
 	# Encryption key, if set magnetic card data will be encrypted
 		KEY_ENCRYPTION  = 1
 
-	  # Creates and initializes new Linea class instance or returns already initalized one. Use this function, if you want to \
+	  # Creates and initializes new Linea class instance or returns already initialized one. Use this function, if you want to \
 	  # access Linea from multiple classes
 	  # return instance of Linea device class (Linea)
 	  def self.sharedDevice
@@ -539,7 +539,7 @@ Ruby interface located in [https://github.com/rhomobile/linea-rhodes/blob/master
 	  def barcodeEngineWriteString?(data)
 	  end	
 
-	  # max_length - int with maximum length of readed data in bytes
+	  # max_length - int with maximum length of read data in bytes
 	  # timeout - float
 	  # return array of bytes or nil if nothing
 	  def barcodeEngineRead(max_length, timeout)
@@ -579,7 +579,7 @@ This is simple example of ruby code where you can see how LineSDK is used in rub
 		begin
 		  Linea.sharedDevice.connect
 		rescue
-		  puts 'Linea exception catched : '+$!.to_s
+		  puts 'Linea exception caught : '+$!.to_s
 		end
 	  end
 
@@ -587,7 +587,7 @@ This is simple example of ruby code where you can see how LineSDK is used in rub
 		begin
 		  Linea.sharedDevice.disconnect
 		rescue
-		  puts 'Linea exception catched : '+$!.to_s
+		  puts 'Linea exception caught : '+$!.to_s
 		end
 	  end
 
@@ -595,7 +595,7 @@ This is simple example of ruby code where you can see how LineSDK is used in rub
 		begin
 		  Linea.sharedDevice.startScan
 		rescue
-		  puts 'Linea exception catched : '+$!.to_s
+		  puts 'Linea exception caught : '+$!.to_s
 		end
 	  end
 
@@ -603,7 +603,7 @@ This is simple example of ruby code where you can see how LineSDK is used in rub
 		begin
 		  Linea.sharedDevice.stopScan
 		rescue
-		  puts 'Linea exception catched : '+$!.to_s
+		  puts 'Linea exception caught : '+$!.to_s
 		end
 	  end
 
@@ -611,7 +611,7 @@ This is simple example of ruby code where you can see how LineSDK is used in rub
 		begin
 		  Linea.sharedDevice.msStartScan
 		rescue
-		  puts 'Linea exception catched : '+$!.to_s
+		  puts 'Linea exception caught : '+$!.to_s
 		end
 	  end
 
@@ -619,7 +619,7 @@ This is simple example of ruby code where you can see how LineSDK is used in rub
 		begin
 		  Linea.sharedDevice.msStopScan
 		rescue
-		  puts 'Linea exception catched : '+$!.to_s
+		  puts 'Linea exception caught : '+$!.to_s
 		end
 	  end
 
@@ -627,7 +627,7 @@ This is simple example of ruby code where you can see how LineSDK is used in rub
 		begin
 			Linea.sharedDevice.enableBarcode(Linea::BAR_ALL, true)
 		rescue
-		  puts 'Linea exception catched : '+$!.to_s
+		  puts 'Linea exception caught : '+$!.to_s
 		end
 	  end
 

data/doc/nfc.txt

@@ -2,7 +2,7 @@
 
 The Near Field Communications (NFC) API allows you to use NFC functionality in your Rhodes application. With the NFC API, you can check to see if the mobile device supports NFC, and if so, have it listen for an NFC tag and register a callback if it finds one. You can also have your device push out an NFC tag. 
 
-**NOTE: As of Rhodes version 3.3.3, the NFC API is removed from Rhodes. This feature is only supported in Motorola RhoMobile Suite. If you wish to use this feature, you will need to [upgrade to RhoMobile Suite](/rhoelements/rhoelements-install). Your application's build.yml will also need to be modified to [indicate the application type is 'Rhoelements']( /rhoelements/rhoelements2-native#enabling-motorola-device-capabilities). Additionally, a [RhoElements license](/rhoelements/licensing) is required.**
+**NOTE: As of Rhodes version 3.3.3, the NFC API is removed from Rhodes. This feature is only supported in Motorola RhoMobile Suite. If you wish to use this feature, you will need to [upgrade to RhoMobile Suite](/rhomobile-install). Your application's build.yml will also need to be modified to [indicate the application type is 'Rhoelements']( /rhoelements/rhoelements2-native#enabling-motorola-device-capabilities). Additionally, a [RhoElements license](/rhoelements/licensing) is required.**
 
 Example Code
 -----------
@@ -56,7 +56,7 @@ You can use the method NFCManager.is_supported to see if NFC is supported on you
 
 If your method is going to read or write NFC tags, it also needs to set the callback methods that process the NFC tag. The NFCManager.set_nfc_tech_callback is for reading and writing NFC tags (when the Android ACTION_TECH_DISCOVERED event is processed). NFCManager.set_nfc_callback is for peer-to-peer communication (when the Android ACTION_NDEF_DISCOVERED or ACTION_TAG_DISCOVERED events are processed).
 
-For NFCManager.set_nfc_tech_callback (the Android ACTION_TECH_DISCOVERED event), set up your list of techs in a resource file : [Rhodes ROOT]/lib/extensions/nfc/ext/nfc/platform/android/additional_files/res/xml/filter_nfc.xml. Refet to the Android documentation - [Android ACTION_TECH_DISCOVERED description](http://developer.android.com/reference/android/nfc/NfcAdapter.html#ACTION_TECH_DISCOVERED). Here is an example.
+For NFCManager.set_nfc_tech_callback (the Android ACTION_TECH_DISCOVERED event), set up your list of techs in a resource file : [Rhodes ROOT]/lib/extensions/nfc/ext/nfc/platform/android/additional_files/res/xml/filter_nfc.xml. Refer to the Android documentation - [Android ACTION_TECH_DISCOVERED description](http://developer.android.com/reference/android/nfc/NfcAdapter.html#ACTION_TECH_DISCOVERED). Here is an example.
 
 	:::xml
 	<?xml version="1.0" encoding="utf-8"?>
@@ -1283,7 +1283,7 @@ None.
 
 ### NFCManager.enable
 
-The enable method enables NFC event processing on your mobile device. Your nfc and nfc_tech callback methods are executed only if Rhodes NFC is enabled. On Android, when Rhodes NFC is enabled and the application activity is in the foreground, the activity gets high priority for NFC events. Android will not show additional UI for the select Activity for Tag processing; the Rhodes applciation will processed the tag.
+The enable method enables NFC event processing on your mobile device. Your nfc and nfc_tech callback methods are executed only if Rhodes NFC is enabled. On Android, when Rhodes NFC is enabled and the application activity is in the foreground, the activity gets high priority for NFC events. Android will not show additional UI for the select Activity for Tag processing; the Rhodes application will process the tag.
 
 #### Returns
 

data/doc/release.txt

@@ -66,7 +66,7 @@ Run on Platform Simulator from 'mytest' folder.
     - Date and Time: you should see 2 fields Date, Time
     - Date only: only date should be displayed
     - Time only: only time should be displayed
-    Setting date/time should be processed without reload page. When you reopen DateTime Picker you should see date time from field (previosly setted).
+    Setting date/time should be processed without reload page. When you reopen DateTime Picker you should see date time from field (previously set).
 * Alerts: select each link. you should see corresponding actions
 * Ringtones: all phone ring-tones should be listed. Select 2 of them  - you should listen some sound. On second press [stop], sound should     stopped immediately
 * AsyncHttpTest: Apache license page should be displayed
@@ -83,7 +83,7 @@ Run on Platform Simulator from 'mytest' folder.
    - press 'Test back with alert', enter some text to edit, when press Back button - you should see<br/> Alert with message 'Do you want to leave?'. Press No - text from edit should not disappear. <br/>Press back again, on alert press Yes - you should return to dynamic menu test
    - press 'Test back with close', when press Back button - application should exit
 * Rho tests: press on each link, you should see corresponding page with message
-* Barcode recognize test: open "My Barcode recognize ..." press [scan] under image - see Alert with correct recognized code. Press [Take Picture] for make shot of barcode by camea and see Alert with recognized code or "[]" if not recognized.
+* Barcode recognize test: open "My Barcode recognize ..." press [scan] under image - see Alert with correct recognized code. Press [Take Picture] for make shot of barcode by camera and see Alert with recognized code or "[]" if not recognized.
 * Bluetooth Chat Demo: 
   1. Phone and external Bluetooth device (for example external GPS Bluetooth device) - for Android, Windows Mobile and Blackberry only.
      - pair device with phone
@@ -222,7 +222,7 @@ Same procedure as for plug-in
 
 4. Import into workspace DLTK plugins
 
-    Select 'Pluigns and Fragments' item in Import Dialog and going to 'Selection' page. 
+    Select 'Plugins and Fragments' item in Import Dialog and going to 'Selection' page.
     In left list of plugins select items with names:
 
     org.eclipse.dltk.debug
@@ -245,7 +245,7 @@ Same procedure as for plug-in
 8. Export. Select File/Export/Plugin Development
 
 8.1 For update site need select - Deployable features
-8.2 For installer (or for export only Rhostudio plugin) need select Deplyable plugin and fragments
+8.2 For installer (or for export only Rhostudio plugin) need select Deployable plugin and fragments
 
 ##Build Rhodes Eclipse
 

data/doc/rhom.txt

@@ -55,7 +55,7 @@ This will generate a file called `product.rb` which looks like:
 	  # Uncomment the following line to enable sync with Product.
 	  # enable :sync
 
-	  #add model specifc code here
+	  #add model specific code here
 	end
 	
 There are several features you can enable or disable in the model, below is a complete list:
@@ -70,7 +70,7 @@ There are several features you can enable or disable in the model, below is a co
 	  enable :sync 
 
 	  # Set the type of sync this model
-	  # will use (default :incrmental).
+	  # will use (default :incremental).
 	  # Set to :bulk_only to disable incremental
 	  # sync and only use bulk sync.
 	  set :sync_type, :bulk_only 
@@ -171,7 +171,7 @@ Below is a full list of options available to fixed schema models:
 	  enable :sync 
 
 	  # Set the type of sync this model
-	  # will use (default :incrmental).
+	  # will use (default :incremental).
 	  # Set to :bulk_only to disable incremental
 	  # sync and only use bulk sync.
 	  set :sync_type, :bulk_only 
@@ -626,7 +626,7 @@ Name of the source.
 	  #=> "Product"
 	
 ### `last_updated`
-Last time the source was successfully synchronzied (in `Time.at` format).
+Last time the source was successfully synchronized (in `Time.at` format).
 
 	:::ruby
 	@source.last_updated.to_s
@@ -895,7 +895,7 @@ To use number comparison conditions in find use CAST :
         
 ## Database Encryption
 
-**NOTE: As of Rhodes version 3.3.3, [Rhom data encryption](/rhodes/rhom#database-encryption) is removed from Rhodes. This feature is only supported in Motorola RhoMobile Suite. If you wish to use this feature, you will need to [upgrade to RhoMobile Suite](/rhoelements/rhoelements-install). Your application's build.yml will also need to be modified to [indicate the application type is 'Rhoelements']( /rhoelements/rhoelements2-native#enabling-motorola-device-capabilities). Additionally, a [RhoElements license](/rhoelements/licensing) is required.**
+**NOTE: As of Rhodes version 3.3.3, [Rhom data encryption](/rhodes/rhom#database-encryption) is removed from Rhodes. This feature is only supported in Motorola RhoMobile Suite. If you wish to use this feature, you will need to [upgrade to RhoMobile Suite](/rhomobile-install). Your application's build.yml will also need to be modified to [indicate the application type is 'Rhoelements']( /rhoelements/rhoelements2-native#enabling-motorola-device-capabilities). Additionally, a [RhoElements license](/rhoelements/licensing) is required.**
 
 If your application requires that the local database is encrypted on the filesystem, you can enable it by setting a flag in `build.yml`:
 
@@ -923,8 +923,8 @@ If your application requires that the local database is encrypted on the filesys
 	bb:   
 	  use_sqlite: 0
 	  
-## Perfomance Tips
-* Before test application for perfomance set warning log level in rhoconfig.txt(MUST set for Blackberry testing):
+## Performance Tips
+* Before test application for performance set warning log level in rhoconfig.txt(MUST set for Blackberry testing):
 
         MinSeverity = 3
     

data/doc/rhostudio-test-plan.txt

@@ -6,7 +6,7 @@ RhoStudio is a multi-platform application and should act identically on all plat
 The only process that differs from platform to platform is an installation. So the installation tests are
 described separately for each platform. All other tests should be performed on all platforms and yield the identical results.
 
-Any deviation from the described behaviour is a possible bug and should be reported to the developers.
+Any deviation from the described behavior is a possible bug and should be reported to the developers.
 
 ## On Virtual Machines
 
@@ -42,17 +42,17 @@ It is recommended to run all tests on virtual machines (e.g. using freeware [Ora
 
    NOTE: Pay attention to `System > Processor > Processors` property -- if you plan to connect USB devices directly to virtual machine, set the number of processors strictly to 1
    (this is a workaround for the bug in VirtualBox). Also for USB pass-thru you need to install [VirtualBox Extension Pack](https://www.virtualbox.org/wiki/Downloads) and,
-   if VirtualBox is installed on Linux host, then you need to add all users runnung virtual machines to `vboxusers` group.
+   if VirtualBox is installed on Linux host, then you need to add all users running virtual machines to `vboxusers` group.
 
 2. Install desired operating system to virtual machine using original installation media (CD or DVD) and product license key
    (see VirtualBox help and documentation for details on guest operating systems installation).
 
 3. Install all updates, service packs and official patches for installed OS.
 
-4. Install all latest avaiable SDKs for supported mobile platforms:
+4. Install all latest available SDKs for supported mobile platforms:
 
    1. Install latest Android SDK and NDK. Do not forget to run Android SDK Manager to download and install all latest tools, platforms and APIs.
-      Don't use path with spaces, install SDK and NDK to something like `C:\Anrdoid\android-sdk` and `C:\Anrdoid\android-ndk` on Windows
+      Don't use path with spaces, install SDK and NDK to something like `C:\Android\android-sdk` and `C:\Android\android-ndk` on Windows
       and to something like `/Developer/SDKs/android-sdk` and `/Developer/SDKs/android-ndk` on Mac.
    2. On Windows: install Visual Studio 2008 and Windows Mobile 6 Professional SDK Refresh
       (don't forget to run Microsoft Update after Visual Studio installation to apply all latest updates, service packs and fixes).
@@ -78,7 +78,7 @@ It is recommended to run all tests on virtual machines (e.g. using freeware [Ora
 Thus you will always have an up-to-date clean fresh installation of each operating system with all required SDKs for testing purposes.
 
 NOTE: Never create a snapshot of crashed or abnormally exited virtual machine! Always restore previous good state
-from latest snapshot, install neccesary updates/service-packs/patches, create new snapshot, and delete previous snapshot.
+from latest snapshot, install necessary updates/service-packs/patches, create new snapshot, and delete previous snapshot.
 
 NOTE: Deletion of previous snapshots lets you save a lot of free disk space on a physical (host) machine especially for Windows virtual machines (guests).
 
@@ -121,14 +121,14 @@ Take a fresh clean installation of Mac OS X with all available Software Updates
 
 ### Installation failure test on Mac OS X without Xcode
 
-1. Open 'Install gems' shorcut. The Terminal window will appear.
+1. Open 'Install gems' shortcut. The Terminal window will appear.
 2. If asked for a password, enter the password.
 3. The message will appear: "Please install building tools"
 
 ### Installation failure test on Mac OS X without Java
 
 1. Install latest available Xcode with iOS SDK.
-2. Open 'Install gems' shorcut again.
+2. Open 'Install gems' shortcut again.
 3. If asked for a password, enter the password.
 4. The message will appear: "Please install java development kit"
 
@@ -141,7 +141,7 @@ Take a fresh clean installation of Mac OS X with all available Software Updates
 
    The window will appear asking you about installation of Java -- agree and proceed JDK installation.
 
-2. Open 'Install gems' shorcut again.
+2. Open 'Install gems' shortcut again.
 
 3. If asked for password, enter your password.
 
@@ -203,7 +203,7 @@ When you open the RhoStudio it asks a path to create (or open existing) `workspa
 4. Expand 'Rhomobile' node.
 5. 'RhoStudio' should be grayed out -- that means the latest version is already installed.
 6. To double-check this write down the version number of RhoStudio available from the update site (that is displayed in this list).
-7. Click 'What is <u>alreay installed</u>?' link.
+7. Click 'What is <u>already installed</u>?' link.
 8. Switch to 'Plug-ins' tab.
 9. Find plug-in named 'com.rhomobile.rhostudio' and write down its version number.
 10. The version numbers written down on step 6 and step 9 should be the same -- if not, the RhoStudio installer contains
@@ -277,7 +277,7 @@ RET: 0
 2.6. Check that project with given name appeared at `Project Explorer` view.
 2.7. Check project files in `Project Explorer` view item.
 
-3. RhoMoile Application project creation from existing sources test
+3. RhoMobile Application project creation from existing sources test
 
 3.1. Create application outside of workspace by hand.
 3.2. Go to `File > New > Project` in the top menu.
@@ -288,7 +288,7 @@ RET: 0
 3.6. Check that project with given name appeared at `Project Explorer` view.
 3.7. Check project files in `Project Explorer` view item.
 
-4. RhoMoile Application project creation from existing sources in workspace test
+4. RhoMobile Application project creation from existing sources in workspace test
 
 4.1. Create application in workspace by hand.
 4.2. Go to `File > New > Project` in the top menu.
@@ -306,7 +306,7 @@ RET: 0
 3. Enter the correct path to `bin` folder of the installed JDK (typically `/Library/Java/Home/bin` on Mac,
    and the `bin` folder of JDK installed during installation tests on Windows, e.g. `C:\Program Files\Java\jdk1.7.0\bin`).
 4. Expand `Rhomobile` node and enter correct paths to 'Android SDK' and 'Android NDK' on `Android` tab,
-   e.g. `C:\Anrdoid\android-sdk` and `C:\Anrdoid\android-ndk` on Windows
+   e.g. `C:\Android\android-sdk` and `C:\Android\android-ndk` on Windows
    and `/Developer/SDKs/android-sdk` and `/Developer/SDKs/android-ndk` on Mac.
 5. On Windows go to `Windows Mobile` tab and set a correct path to 'Cab wizard'.
 6. Click `OK` to finish editing and apply changes.