*************************************************************************** Find & Replace It! - Installation Instructions Copyright(c) 2007-2010, dProg - Philippe Docourt *************************************************************************** *************************************************************************** Supported Platforms *************************************************************************** Here is a list of supported platforms: MS Windows: Windows 2000 [not tested] Windows XP Windows Vista Windows 7 (32-bit and 64-bit) Mac OS X Intel: Mac OS X 10.4 Mac OS X 10.5 "Leopard" Mac OS X 10.6 "Snow Leopard" Mac OS X PPC: Mac OS X 10.4 [not tested] Mac OS X 10.5 "Leopard" Linux: Fedora 13 (32-bit) Ubuntu 10.04 (32-bit and 64-bit) Kubuntu 10.04 (32-bit and 64-bit) NOTES: - The platforms noted as [not tested] in the list, are platforms on which the software should work but with no warranty. All development tools used in this software are certified on these non-tested platforms but we didn't check by ourself. Most of these platforms are pretty old, that's why there are not actively supported. - The Linux installer requires the following commands: bzip2, lzma, xdg-mime, xdg-desktop-menu, xdg-icon-resource. If one of them is missing, the installation will stop and you might have to manually remove the installation folder. - On Linux you must have the libicu42 package installed to run the application. - All modern 64-bit Linux platforms should be supported. However the only tested platforms are Ubuntu 10.04 64-bit and Kubuntu 10.04 64-bit. *************************************************************************** Install *************************************************************************** Windows: -------- 1. Run the FindReplaceIt-x.y.z-setup.exe application. 2. Select the language to use for the installation and click 'OK'. 3. When the welcome screen is displayed, click on 'Next' to continue with the installation. 4. Read carefully the End User License Agreement. If you accept it, click on the checkmark and then 'Next'. 5. Select the destination folder, and click 'Install' to proceed with the installation. 6. When the installation is done, you can choose to run Find & Replace It! from the installer. You'll find a shortcut for launching Find & Replace It! in the Start Menu. The application is located in the 'dProg/Find & Replace It! ' sub-menu. Linux: ------ 1. Open a terminal 2. Make the installer executable: chmod u+x FindReplaceIt-x.y.z-setup-.bin 3. Execute the installer: ./FindReplaceIt-x.y.z-setup-.bin 4. When the welcome screen is displayed, click on 'Next' to continue with the installation. 5. Read carefully the End User License Agreement. If you accept it, click on the checkmark and then 'Next'. 6. Select the destination folder, and click 'Install' to proceed with the installation. 7. When the installation is done, you can choose to run Find & Replace It! from the installer. You'll find a shortcut for launching Find & Replace It! in the Application Menu. The application is located in the 'Accessories' sub-menu. NOTE: This will create the MIME-types associated to Find & Replace It! as well as apropriate menu entries. If you have a previous installation of the software, this installer will override previous the MIME-types associations and menu entries. Therefore we strongly suggest that you remove any previous version before installing a new one. Mac OS X: --------- 1. Open the FindReplaceIt-x.y.z-setup.dmg 2. Read carefully the End User License Agreement (License.rtf). 3. Drag & drop 'Find & Replace It!.app' into your '/Applications' folder or wherever you want. 4. You can run 'Find & Replace It!.app' by simply double-clicking on it. *************************************************************************** Customizing Install *************************************************************************** In order to use Qt's libraries that are installed on your system instead of those distributed alongside the application, you have to: * on Mac OS X: remove the Qt private frameworks located in 'FindReplaceIt.app/Contents/Frameworks/' (i.e. Qtxxx.framework folders + phonon.framework) * on Windows: remove the Qt dll files from the '' folder (i.e. Qtxxx4.dll + phonon.dll) * on Linux: remove the Qt so files from the '/lib/' folder (i.e. libQtxxx.so.4 + phonon4.dll) If you want to use your own version of Qt's libraries without modifying your system, you can replace the appropiate files in the locations mentioned above. Your are free to change the icons by replacing those distributed alongside the application, in the resources folder. On Windows and Linux the icons are located in /res/images. On Mac OS X, they are located in '/Find & Replace It!.app/Contents/Resources/images' *************************************************************************** Uninstall *************************************************************************** Generalities: ------------- When using this software, some settings files might be generated. Settings file location varies with the platform. All these files and directories are prefixed by either 'dProg' or 'FindReplaceIt'. The following files and folders might be used used on Unix and Mac OS X: $HOME/.config/dProg/FinReplaceIt* $HOME/.config/dProg* /etc/xdg/dProg/FinReplaceIt* /etc/xdg/dProg* On Windows, the following files and folders might be used: %APPDATA%\dProg\FinReplaceIt* %APPDATA%\dProg* %COMMON_APPDATA%\dProg\FinReplaceIt* %COMMON_APPDATA%\dProg* NOTE: These files are not removed automatically during uninstallation. They are indeed preserved for future installation or upgrades. If you dont need it anymore, please remove them manually. Windows: -------- To remove Find & Replace It! from your computer, go to the Start menu, search for 'dProg/Find & Replace It! ' folder into the program list, then click 'Unistall'. Linux: ------ Find & Replace It! can be removed trhough the uninstall script: 1. Open a terminal 2. Type: /uninstal.sh (where is your installation directory) NOTE: This will remove all MIME-types associated to Find & Replace It! as well as menu entries. If you have many installations of the software in different locations, this script will remove the software only from the current installation directory . The others installations will be left untouched even if MIME-types associations are removed anyway. Mac OS X: --------- To remove Find & Replace It! from your computer, simply drag & drop the installed bundle ('Find & Replace It!.app') to the trash. Optionnaly, you might remove the package receipt located in '/Library/Receipts/FindReplaceIt.pkg'. This file was only used when doing an installation to detect previous installations. It is not used anymore since version 1.0.