rhodes 3.0.2 → 3.1.0.beta.1

data/doc/release.txt

@@ -147,90 +147,134 @@ Same procedure as for plug-in
 
     git clone git@github.com:rhomobile/rhodes.git
 
-1.CHANGELOG
+1. CHANGELOG
 
-2.Make sure the major.minor.patch version
+2. Make sure the major.minor.patch version
    match what you want to release:
 
-     $ rake get_version
+       $ rake get_version
 
    Use set_version to update if it is not correct:
 
-     $ rake set_version[2.3.1]
+       $ rake set_version[2.3.1]
 
-3.Edit rhodes.gemspec, set s.version :
+3. Edit rhodes.gemspec, set s.version :
 
-BETA:
-	s.version = "2.3.1.beta.1"
+    BETA:
+	   s.version = "2.3.1.beta.1"
 
-RELEASE:
-	s.version = Rhodes::VERSION
+    RELEASE:
+	   s.version = Rhodes::VERSION
 
-4.Build RhoSimulator:
+4. Build RhoSimulator:
 
     rake build:win32:rhosimulator
 
-4.1 Zip files in folder 'rhodes\platform\win32\RhoSimulator' and copy to :
-http://rhosimulator.s3.amazonaws.com/RhoSimulator
+    1. Zip files in folder 'rhodes\platform\win32\RhoSimulator' and copy to:
+    http://rhosimulator.s3.amazonaws.com/RhoSimulator
 
-5.Build IronRuby:
+5. Build IronRuby:
 
-    rake build:wp:ironruby
+	   rake build:wp:ironruby
 
-6.Push changes to git
-     git commit -m "bumping version for release"
-     git push
+6. Push changes to git
 
-7.Put tag:
+	   git commit -m "bumping version for release"
+	   git push
 
-    git tag -m "rhodes release" 2.3.1 0548dea055f0aa00642a66c18ea207bd7344dda7
-    git push --tags
+7. Put tag:
+
+	   git tag -m "rhodes release" 2.3.1 0548dea055f0aa00642a66c18ea207bd7344dda7
+	   git push --tags
 
 ### cijoe steps:
-1.Run commands:
-    ssh rhomobile@cijoe.rhomobile.com
 
-    cd ~/rhodes-release
+1. Run commands:
+
+	   ssh rhomobile@cijoe.rhomobile.com
 
-    rm -rf * 
-    git reset --hard
-    git pull
+	   cd ~/rhodes-release
 
-2.Copy 'rhodes\platform\wp7\IronRuby\bin\Silverlight3Release' to cijoe from local computer
-3.Copy 'rhodes\platform\win32\RhoSimulator' to cijoe from local computer
+	   rm -rf * 
+	   git reset --hard
+	   git pull
 
-4.Build and push gem:
+2. Copy 'rhodes\platform\wp7\IronRuby\bin\Silverlight3Release' to cijoe from local computer
+3. Copy 'rhodes\platform\win32\RhoSimulator' to cijoe from local computer
+4. Copy 'rhodes\platform\osx\bin\RhoSimulator\Rhosimulator.app
+
+5. Build and push gem:
     rake gem
     gem push rhodes-<version>.gem
 
 ##Build Eclipse plug-in
 
-0.download Eclipse for RAP/RPC developer
+0. download Eclipse for RAP/RPC developer
+
+1. clone git repository (git@github.com:rhomobile/rhostudio.git)
 
-1.download git repository (git@github.com:rhomobile/rhostudio.git)
+2. Import project into Eclipse (File/Import/'Existing project into Workspace')
 
-2.Import project into Eclipse (File/Import/'Existing project into Workspace')
+3. Install DLTK 2.0
 
-3.Install DLTK 2.0
+4. Import into workspace DLTK plugins
 
-4.Import into workspace next DLTK plugins
+    Select 'Pluigns and Fragments' item in Import Dialog and going to 'Selection' page. 
+    In left list of plugins select items with names:
 
     org.eclipse.dltk.debug
     org.eclipse.dltk.ruby.ui
     org.eclipse.dltk.ui
+    org.eclipse.dltk.console.ui
+    org.eclipse.dltk.console
+    org.eclipse.dltk.core
+    org.eclipse.dltk.debug.ui
 
-5.add imported plugins to java build paths (Project properties/Java build path/Libraries/Add JAR)
+    After import procedure in workspace should appears seven plugin projects.
 
-6.select imported plugins in Project properties/Java build path/Libraries/Order and Export 
+5. Add imported plugins to java build paths (Project properties/Java build path/Libraries/Add JAR).
 
-5.build and run Eclipse configuration
+6. Select imported plugins in Project properties/Java build path/Libraries/Order and Export 
+
+5. Build and run Eclipse configuration
 
 ##Build Rhodes Eclipse
 
-1.Install (http://www.eclipse.org/egit/)
+1. Install (http://www.eclipse.org/egit/)
+
+2. import plugin org.eclipse.platform
+
+3. Start export product (File/Export/Plugin development/Eclipse product)
+
+4. Select destination folder and export
+
+##Build &amp; Test RhoSimulator for Mac
+
+1. Download and install Qt Libraries for Mac:
+
+   * Go to [http://qt.nokia.com/downloads](http://qt.nokia.com/downloads)
+   * Jump to `Qt libraries`
+   * Select [Qt libraries 4.7.3 for Mac](http://qt.nokia.com/downloads/qt-for-open-source-cpp-development-on-mac-os-x)
+   * Download [Cocoa: Mac binary package](http://get.qt.nokia.com/qt/source/qt-mac-opensource-4.7.3.dmg) (206 MB)
+   * Install Qt libraries for Mac
+
+2. Build RhoSimulator for Mac:
+
+	   $ cd <rhodes>
+	   $ rake build:rhosimulator
+
+3. Test RhoSimulator for Mac:
+
+   * Use `rhodes-system-api-samples`
+   * Make sure you have an appropriate `rhosimulator/rhosimconfig.txt`, e.g.:
 
-2.import plugin org.eclipse.platform
+	     rhodes_path='...full path to rhodes...'
+	     app_name='rhodes-system-api-samples'
+	     debug_port=9000
+	     debug_host='127.0.0.1'
+	     platform='APPLE'
 
-3.Start export product (File/Export/Plugin development/Eclipse product)
+   * Run RhoSimulator for Mac:
 
-4.Select destination folder and export
+	     cd <rhodes-system-api-samples>
+	     rake run:rhosimulator

data/doc/rhom.txt

@@ -85,7 +85,12 @@ There are several features you can enable or disable in the model, below is a co
 	  # Default is disabled, only changed attributes
 	  # are sent.
 	  enable :full_update 
-	
+
+      # RhoSync provides a simple way to keep data out of redis. 
+      # If you have sensitive data that you do not want saved in redis, 
+      # add the pass_through option in settings/settings.yml for each source.
+      # Add pass_through to client model definition
+	  enable :pass_through 
 	
 	  # model settings
 	
@@ -182,6 +187,11 @@ Below is a full list of options available to fixed schema models:
 	  # are sent.
 	  enable :full_update 
 
+      # RhoSync provides a simple way to keep data out of redis. 
+      # If you have sensitive data that you do not want saved in redis, 
+      # add the pass_through option in settings/settings.yml for each source.
+      # Add pass_through to client model definition
+	  enable :pass_through 
 
 	  # model settings
 

data/doc/simulator.txt

@@ -18,6 +18,17 @@ Alternatively you may [build](#build-rhosimulator) your own customized version o
 
 To run application in RhoSimulator just run in rhodes or application folder:
 
+    #run RhoSimulator to simulate specific platform:
+    rake run:android:rhosimulator 
+    rake run:iphone:rhosimulator
+    
+    #bbver from build.yml will be used as System.get_property('os_version')
+    rake run:bb:rhosimulator
+    
+    rake run:wm:rhosimulator
+    rake run:wp:rhosimulator
+
+    #run RhoSimulator to simulate 'UNKNOWN' platform:
     rake run:win32:rhosimulator
 
 If you modified Rhodes application sources, just press 'Refresh' in RhoSimulator to reload application, i.e. generally no RhoSimulator restart is required.
@@ -60,9 +71,8 @@ Follow these instructions to build your own customized version of RhoSimulator.
 * First build the Qt libraries for VS 2005:
     * Download the Qt source:
         * Go to [http://qt.nokia.com/downloads](http://qt.nokia.com/downloads)
-        * Choose the open source LGPL version
-        * Under the Framework Only section choose Qt libraries for Windows (VS 2008)
-        * Cancel automatically started download, and download the [source code](http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.7.3.zip)
+        * Jump to `Qt libraries`
+        * Download the [source code as a zip](http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.7.3.zip) (236 MB)
         * Extract the downloaded archive, e.g. into `C:\Qt\4.7.3-msvc2005`
     * Prepare to build the OpenSSL library:
         * Download [v0.9 source code](http://www.openssl.org/source/openssl-0.9.8r.tar.gz) from [www.openssl.org](http://www.openssl.org/) and extract the downloaded archive, e.g. into `C:\Qt\openssl-0.9.8r`
@@ -109,8 +119,8 @@ To run Rhodes applications in custom built RhoSimulator, please ensure that no `
 
 * Open the solution:
   `C:\Rhomobile\rhodes\platform\wm\rhodes\rhodes.vcproj`
-* Build solution for the configuration `EmulatorRelease|Win32`
+* Build solution for the configuration `SimulatorRelease|Win32`
 * Specify the path to custom built RhoSimulator at `rhobuild.yml`:
         env: 
           paths:    
-            rhosimulator: platform/wm/bin/Win32/rhodes/EmulatorRelease
+            rhosimulator: platform/wm/bin/Win32/rhodes/SimulatorRelease

data/doc/synchronization.txt

@@ -183,15 +183,20 @@ has to be handled in sync callback. Otherwise sync will stop on this model. To f
     * action - May be :delete or :recreate. :delete just remove object from client, :recreate will push this object to server again at next sync.
 
 #### update-error
+If not handled, local modifications, which were failing on server, will never sync to server again.
+So sync will work fine, but nobody will know about these changes.
 
 	:::ruby
-	SyncEngine.on_sync_update_error( src_name, objects, action )
-	Model.on_sync_update_error( objects, action )
+	SyncEngine.on_sync_update_error( src_name, objects, action, rollback_objects = nil )
+	Model.on_sync_update_error( objects, action, rollback_objects = nil)
     
     * objects - One or more error objects
-    * action - May be :retry - will push update object operation to server again at next sync.
+    * action - May be :retry or :rollback. :retry will push update object operation to server again at next sync, :rollback will write rollback_objects to client database.
+    * rollback_objects - contains objects attributes before failed update and sends by server. should be specified for :rollback action.
 
 #### delete-error
+If not handled, local modifications, which were failing on server, will never sync to server again.
+So sync will work fine, but nobody will know about these changes.
 
 	:::ruby
 	SyncEngine.on_sync_delete_error( src_name, objects, action )
@@ -207,6 +212,8 @@ For example:
 
     SyncEngine.on_sync_update_error( @params['source_name'], 
         @params['server_errors']['update-error'], :retry)
+    SyncEngine.on_sync_update_error( @params['source_name'], 
+        @params['server_errors']['update-error'], :rollback, @params['server_errors']['update-rollback'] )
         
     SyncEngine.on_sync_delete_error( @params['source_name'], 
         @params['server_errors']['delete-error'], :retry)
@@ -490,14 +497,17 @@ Clears the sync notification for a given source id.
 * objects - One or more error objects
 * action - May be :delete or :recreate. :delete just remove object from client, :recreate will push this object to server again at next sync.
 
-### `on_sync_update_error( src_name, objects, action )`
+### `on_sync_update_error( src_name, objects, action, rollback_objects = nil )`
 
 	:::ruby
     SyncEngine.on_sync_update_error( @params['source_name'], 
         @params['server_errors']['update-error'], :retry)
+    SyncEngine.on_sync_update_error( @params['source_name'], 
+        @params['server_errors']['update-error'], :rollback, @params['server_errors']['update-rollback'] )
     
 * objects - One or more error objects
-* action - May be :retry - will push update object operation to server again at next sync.
+* action - May be :retry or :rollback. :retry will push update object operation to server again at next sync, :rollback will write rollback_objects to client database.
+* rollback_objects - contains objects attributes before failed update and sends by server. should be specified for :rollback action.
 
 ### `on_sync_delete_error( src_name, objects, action )`
 
@@ -583,6 +593,8 @@ Call search on the RhoSync application with given parameters.  See the [search s
 	#
 	# :progress_step	(optional) Define how often search callback 
 	#					will be executed with 'in_progress' state. 
+	# :sync_changes     (optional)  - true or false(default). Define should client changes send to server before search.
+	
 	Contact.search(
 	  :from => 'search',
 	  :search_params => { 
@@ -593,7 +605,8 @@ Call search on the RhoSync application with given parameters.  See the [search s
 	  :offset => page * page_size,
 	  :max_results => page_size,
 	  :callback => url_for(:action => :search_callback),
-	  :callback_param => ""
+	  :callback_param => "",
+	  :sync_changes => false
 	)
 
 ### `search(*args) (multiple sources)`
@@ -613,7 +626,8 @@ For example:
 	  :offset => page * page_size,
 	  :max_results => page_size,
 	  :callback => url_for(:action => :search_callback),
-	  :callback_param => ""
+	  :callback_param => "",
+	  :sync_changes => false
 	)
 
 

data/doc/ui.txt

@@ -208,6 +208,10 @@ Since 1.2.2 WebView.navigate supports an optional index parameter (defaults to 0
 	:::ruby
 	WebView.navigate(url, index)
 
+Force WebView navigate to previouse page using Browser back
+	:::ruby
+	WebView.navigate_back
+
 Get location (url) of the currently displayed page
 	:::ruby
 	WebView.current_location 

data/installer/rhostudio.nsi

@@ -0,0 +1,464 @@
+;======================================================
+; Include
+ 
+  !include "MUI.nsh"
+  !include "LogicLib.nsh"
+  !include "EnvVarUpdate.nsh"
+ 
+;======================================================
+; Installer Information
+ 
+  Name "RhoStudio"
+  OutFile "rhostudio.exe"
+  InstallDir C:\RhoStudio
+  BrandingText " "
+;======================================================
+; Modern Interface Configuration
+ 
+  !define MUI_ICON "icon.ico" 
+  !define MUI_UNICON "icon.ico"     
+  !define MUI_HEADERIMAGE
+  !define MUI_ABORTWARNING
+  !define MUI_COMPONENTSPAGE_SMALLDESC
+  !define MUI_HEADERIMAGE_BITMAP_NOSTRETCH
+  !define MUI_FINISHPAGE_SHOWREADME $INSTDIR\README.html
+  !define MUI_FINISHPAGE
+  !define MUI_FINISHPAGE_TEXT "Thank you for installing Rhodes, RhoSync and RhoStudio. \r\n\n\n"
+ 
+ 
+;======================================================
+; Pages
+ 
+  !insertmacro MUI_PAGE_WELCOME
+  !define MUI_PAGE_HEADER_TEXT "RhoSync License Agreement"
+  !define MUI_PAGE_HEADER_SUBTEXT "Please review the RhoSync license terms before installing Instant Rhodes."
+  !insertmacro MUI_PAGE_LICENSE "RHOSYNC-LICENSE.txt"
+  !insertmacro MUI_PAGE_COMPONENTS
+  !insertmacro MUI_PAGE_DIRECTORY
+  !insertmacro MUI_PAGE_INSTFILES
+  !insertmacro MUI_PAGE_FINISH
+ 
+;======================================================
+; Languages
+ 
+  !insertmacro MUI_LANGUAGE "English"
+ 
+;======================================================
+; Reserve Files
+ 
+  ;ReserveFile "configUi.ini"
+  ;!insertmacro MUI_RESERVEFILE_INSTALLOPTIONS
+ 
+;======================================================
+; Sections
+
+# start default section
+section
+
+    ReadRegStr $0 HKEY_LOCAL_MACHINE "SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\javaws.exe" "Path"
+              
+    StrCmp $0 "" jreCheck   
+     
+    # set the installation directory as the destination for the following actions
+    setOutPath $INSTDIR
+ 
+    # create the uninstaller
+    writeUninstaller "$INSTDIR\uninstall.exe"
+ 
+    SetOutPath "$SMPROGRAMS\RhoStudio"
+    # create a shortcut named "new shortcut" in the start menu programs directory
+    # point the new shortcut at the program uninstaller
+    createShortCut "$SMPROGRAMS\RhoStudio\Uninstall RhoStudio.lnk" "$INSTDIR\uninstall.exe"
+    createShortCut "$SMPROGRAMS\RhoStudio\RhoStudio.lnk" "$INSTDIR\eclipse\RhoStudio.exe"
+    
+    Goto finishSection
+    
+    jreCheck:
+        MessageBox MB_OK|MB_ICONINFORMATION|MB_DEFBUTTON1 "Java Runtime Environment could be found on your computer. Please install Java Runtime Environment before RhoStudio."
+        Quit 
+
+    finishSection: 
+sectionEnd
+ 
+# uninstaller section start
+section "uninstall"
+ 
+    # first, delete the uninstaller
+    delete "$INSTDIR\uninstall.exe"
+ 
+    # second, remove the link from the start menu    
+    delete "$SMPROGRAMS\RhoStudio\Uninstall RhoStudio.lnk"
+    delete "$SMPROGRAMS\RhoStudio\RhoStudio.lnk"
+    delete "$SMPROGRAMS\RhoStudio"
+
+    # remove env vars
+    Push "PATH" 
+    Push "R" 
+    Push "HKLM" 
+    Push "$INSTDIR\ruby\bin"
+    Call un.EnvVarUpdate
+    Pop $R0
+
+    Push "PATH" 
+    Push "R" 
+    Push "HKLM" 
+    Push "$INSTDIR\make-3.81\bin"
+    Call un.EnvVarUpdate
+    Pop $R0
+
+    Push "PATH" 
+    Push "R" 
+    Push "HKLM" 
+    Push "$INSTDIR\redis-2.2.2"
+    Call un.EnvVarUpdate
+    Pop $R0
+
+    Push "REDIS_HOME" 
+    Push "R" 
+    Push "HKLM" 
+    Push "$INSTDIR\redis-2.2.2"
+    Call un.EnvVarUpdate
+    Pop $R0
+
+    # remove $INSTDIR
+    RMDir /r /REBOOTOK $INSTDIR
+
+# uninstaller section end
+sectionEnd
+
+Section "Ruby, Rubygems, Rhodes, and RhoSync" rubySection
+ 
+  SetOutPath $INSTDIR
+ 
+  File /r "ruby"
+  File /r "make-3.81"
+  File "README.html"
+  File "RHOSYNC-LICENSE.txt"
+ 
+  ;add to path here
+
+  Push "PATH" 
+  Push "P" 
+  Push "HKLM" 
+  Push "$INSTDIR\ruby\bin"
+  Call EnvVarUpdate
+  Pop $R0
+
+  Push "$INSTDIR\binfileoutput.txt" # output file - unused paramter
+  Push "*." # filter
+  Push "$INSTDIR\ruby\bin" # folder to search in
+  Call FixScriptFilesInDir
+  Pop $R0
+
+  Push "$INSTDIR\binfileoutput1.txt" # output file - unused paramter
+  Push "*.bat" # filter
+  Push "$INSTDIR\ruby\bin" # folder to search in
+  Call FixScriptFilesInDir
+  Pop $R0
+
+  Push "$INSTDIR\binfileoutput2.txt" # output file - unused paramter
+  Push "*.rb" # filter
+  Push "$INSTDIR\ruby\bin" # folder to search in
+  Call FixScriptFilesInDir
+  Pop $R0
+
+  delete "$INSTDIR\binfileoutput.txt"
+  delete "$INSTDIR\binfileoutput1.txt"
+  delete "$INSTDIR\binfileoutput2.txt"
+
+SectionEnd
+
+Section "Redis" redisSection
+ 
+  SetOutPath $INSTDIR
+ 
+  File /r "redis-2.2.2"
+ 
+  ;add to path here
+
+  Push "PATH" 
+  Push "P" 
+  Push "HKLM" 
+  Push "$INSTDIR\redis-2.2.2"
+  Call EnvVarUpdate
+  Pop $R0
+
+  Push "REDIS_HOME" 
+  Push "P" 
+  Push "HKLM" 
+  Push "$INSTDIR\redis-2.2.2"
+  Call EnvVarUpdate
+  Pop $R0
+
+SectionEnd
+
+Section "Git 1.7.3.1" gitSection
+
+  SetOutPath $INSTDIR
+  
+  File "Git-1.7.3.1-preview20101002.exe"
+ 
+  ExecWait "$INSTDIR\Git-1.7.3.1-preview20101002.exe"
+
+  delete "$INSTDIR\Git-1.7.3.1-preview20101002.exe"
+
+SectionEnd
+
+#Section "Java SE Runtime Environment 6 Update 26" javaSection
+
+#  SetOutPath $INSTDIR
+  
+#  File "jre-6u26-windows-i586.exe"
+ 
+#  ExecWait "$INSTDIR\jre-6u26-windows-i586.exe"
+
+#  delete "$INSTDIR\jre-6u26-windows-i586.exe"
+
+#SectionEnd
+
+Section "GNU Make" gnumakeSection
+
+  SetOutPath $INSTDIR
+ 
+  File /r "make-3.81"
+
+  Push "PATH" 
+  Push "P" 
+  Push "HKLM" 
+  Push "$INSTDIR\make-3.81\bin"
+  Call EnvVarUpdate
+  Pop $R0
+
+SectionEnd
+
+Section "RhoStudio" studioSection
+ 
+  SetOutPath $INSTDIR
+ 
+  File /r "eclipse"
+
+SectionEnd
+;======================================================
+;Descriptions
+ 
+  ;Language strings
+  LangString DESC_InstallRhostudio ${LANG_ENGLISH} "This installs Eclipse with RhoStudio."
+  LangString DESC_InstallRuby ${LANG_ENGLISH} "This installs ruby 1.8.7, rubygems 1.3.7, Rhodes and RhoSync gems."
+  LangString DESC_InstallRedis ${LANG_ENGLISH} "This installs redis 2.2.2 (required to run RhoSync)."
+  LangString DESC_InstallGit ${LANG_ENGLISH} "This installs Git (which includes the Git Bash)."
+  LangString DESC_InstallGnuMake ${LANG_ENGLISH} "This installs GNU Make (sometimes required to update gems)."
+#  LangString DESC_InstallJava ${LANG_ENGLISH} "This installs Java SE Runtime Environment."
+  
+  
+  ;Assign language strings to sections
+  !insertmacro MUI_FUNCTION_DESCRIPTION_BEGIN
+  !insertmacro MUI_DESCRIPTION_TEXT ${studioSection} $(DESC_InstallRhostudio)
+  !insertmacro MUI_DESCRIPTION_TEXT ${rubySection} $(DESC_InstallRuby) 
+  !insertmacro MUI_DESCRIPTION_TEXT ${redisSection} $(DESC_InstallRedis)
+  !insertmacro MUI_DESCRIPTION_TEXT ${gitSection} $(DESC_InstallGit)
+  !insertmacro MUI_DESCRIPTION_TEXT ${gnumakeSection} $(DESC_InstallGnuMake)
+#  !insertmacro MUI_DESCRIPTION_TEXT ${javaSection} $(DESC_InstallJava)    
+  !insertmacro MUI_FUNCTION_DESCRIPTION_END
+
+;======================================================
+;Functions
+
+Function FixScriptFilesInDir
+Exch $R0 #path
+Exch
+Exch $R1 #filter
+Exch
+Exch 2
+Exch $R2 #output file
+Exch 2
+Push $R3
+Push $R4
+Push $R5
+Push $R6
+ ClearErrors
+ FindFirst $R3 $R4 "$R0\$R1"
+  FileOpen $R5 $R2 w
+
+ Push $INSTDIR
+ Push "\"
+ Call StrSlash
+ Pop $R6 
+
+ Loop:
+ IfErrors Done
+  StrCmp $R4 "." gotoNextFile
+  StrCmp $R4 ".." gotoNextFile
+
+  ;replace package folder with INSTDIR
+  Push C:/dev/rhodesinstaller
+  Push $R6
+  Push all
+  Push all
+  Push "$R0\$R4"
+  Call AdvReplaceInFile
+  FileWrite $R5 "$R0\$R4$\r$\n"
+  FindNext $R3 $R4
+  Goto Loop
+
+ gotoNextFile:
+  FindNext $R3 $R4
+  Goto Loop
+
+ Done:
+  FileClose $R5
+ FindClose $R3
+Pop $R6
+Pop $R5
+Pop $R4
+Pop $R3
+Pop $R2
+Pop $R1
+Pop $R0
+FunctionEnd
+
+
+
+Function AdvReplaceInFile
+Exch $0 ;file to replace in
+Exch
+Exch $1 ;number to replace after
+Exch
+Exch 2
+Exch $2 ;replace and onwards
+Exch 2
+Exch 3
+Exch $3 ;replace with
+Exch 3
+Exch 4
+Exch $4 ;to replace
+Exch 4
+Push $5 ;minus count
+Push $6 ;universal
+Push $7 ;end string
+Push $8 ;left string
+Push $9 ;right string
+Push $R0 ;file1
+Push $R1 ;file2
+Push $R2 ;read
+Push $R3 ;universal
+Push $R4 ;count (onwards)
+Push $R5 ;count (after)
+Push $R6 ;temp file name
+ 
+  GetTempFileName $R6
+  FileOpen $R1 $0 r ;file to search in
+  FileOpen $R0 $R6 w ;temp file
+   StrLen $R3 $4
+   StrCpy $R4 -1
+   StrCpy $R5 -1
+ 
+loop_read:
+ ClearErrors
+ FileRead $R1 $R2 ;read line
+ IfErrors exit
+ 
+   StrCpy $5 0
+   StrCpy $7 $R2
+ 
+loop_filter:
+   IntOp $5 $5 - 1
+   StrCpy $6 $7 $R3 $5 ;search
+   StrCmp $6 "" file_write2
+   StrCmp $6 $4 0 loop_filter
+ 
+StrCpy $8 $7 $5 ;left part
+IntOp $6 $5 + $R3
+IntCmp $6 0 is0 not0
+is0:
+StrCpy $9 ""
+Goto done
+not0:
+StrCpy $9 $7 "" $6 ;right part
+done:
+StrCpy $7 $8$3$9 ;re-join
+ 
+IntOp $R4 $R4 + 1
+StrCmp $2 all file_write1
+StrCmp $R4 $2 0 file_write2
+IntOp $R4 $R4 - 1
+ 
+IntOp $R5 $R5 + 1
+StrCmp $1 all file_write1
+StrCmp $R5 $1 0 file_write1
+IntOp $R5 $R5 - 1
+Goto file_write2
+ 
+file_write1:
+ FileWrite $R0 $7 ;write modified line
+Goto loop_read
+ 
+file_write2:
+ FileWrite $R0 $R2 ;write unmodified line
+Goto loop_read
+ 
+exit:
+  FileClose $R0
+  FileClose $R1
+ 
+   SetDetailsPrint none
+  Delete $0
+  Rename $R6 $0
+  Delete $R6
+   SetDetailsPrint both
+ 
+Pop $R6
+Pop $R5
+Pop $R4
+Pop $R3
+Pop $R2
+Pop $R1
+Pop $R0
+Pop $9   
+Pop $8
+Pop $7
+Pop $6
+Pop $5
+Pop $0
+Pop $1
+Pop $2
+Pop $3
+Pop $4
+FunctionEnd 
+
+
+; Push $filenamestring (e.g. 'c:\this\and\that\filename.htm')
+; Push "\"
+; Call StrSlash
+; Pop $R0
+; ;Now $R0 contains 'c:/this/and/that/filename.htm'
+Function StrSlash
+  Exch $R3 ; $R3 = needle ("\" or "/")
+  Exch
+  Exch $R1 ; $R1 = String to replacement in (haystack)
+  Push $R2 ; Replaced haystack
+  Push $R4 ; $R4 = not $R3 ("/" or "\")
+  Push $R6
+  Push $R7 ; Scratch reg
+  StrCpy $R2 ""
+  StrLen $R6 $R1
+  StrCpy $R4 "\"
+  StrCmp $R3 "/" loop
+  StrCpy $R4 "/"  
+loop:
+  StrCpy $R7 $R1 1
+  StrCpy $R1 $R1 $R6 1
+  StrCmp $R7 $R3 found
+  StrCpy $R2 "$R2$R7"
+  StrCmp $R1 "" done loop
+found:
+  StrCpy $R2 "$R2$R4"
+  StrCmp $R1 "" done loop
+done:
+  StrCpy $R3 $R2
+  Pop $R7
+  Pop $R6
+  Pop $R4
+  Pop $R2
+  Pop $R1
+  Exch $R3
+FunctionEnd