Find & Replace It! - Install Instructions

Supported Platforms

Here is a list of supported platforms:

• Windows:
• Windows 2000 [not tested]
• Windows XP
• Windows Vista
• Windows 7 (32-bit and 64-bit)
• Mac OS X Intel:
• Mac OS X 10.5 "Leopard"
• Mac OS X 10.6 "Snow Leopard"
• Mac OS X 10.7 "Lion"
• Linux:
• Ubuntu 12.04 (32-bit and 64-bit)
• Most of the recent Linux distributions (32-bit and 64-bit): Ubuntu 10.04 and up, Kubuntu 10.04 and up, Fedora 13 and up, OpenSUSE 11.2 and up, etc. [not tested]

NOTES:

• The PowerPC architecture support has been dropped since version 1.4.0 of Find & Replace It!. You can still download version 1.3.3 (Universal Binary) on our website.
• The support for Mac OS X 10.4 has been dropped since version 1.4.0 of Find & Replace It!. You can still download version 1.3.3 (Universal Binary) on our website.
• 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.
• Most of the modern Linux platforms should be supported. However the only tested platforms are Ubuntu 10.04 32-bit, and Ubuntu 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! <version> sub-menu.

Linux

1. Open a terminal
2. Make the installer executable: chmod u+x FindReplaceIt-x.y.z-setup-<architecture>.run
3. Execute the installer: ./FindReplaceIt-x.y.z-setup-<architecture>.run
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

If you buy this Software on the App Store from Apple, there is nothing to do to install this Software. It will be automatically installed when you download it for the App Store. Otherwise, you should follow the following instructions.

1. Open the FindReplaceIt-x.y.z-setup.dmg
2. Read carefully the End User License Agreement in Documentation/License.rtf.
3. Drag & drop Find & Replace It!.app into your /Applications folder or wherever you want. You might use the Applications symbolic link provided in the DMG.
4. You can run Find & Replace It!.app by simply double-clicking on it, from the folder where it has been installed.

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 <app/install/dir>FindReplaceIt.app/Contents/Frameworks/ (i.e. Qtxxx.framework folders + phonon.framework)
• On Windows: remove the Qt dll files from the <app/install/dir> folder (i.e. Qtxxx4.dll + phonon.dll)
• On Linux: remove the Qt so files from the <app/install/dir>/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 <app/install/dir>/res/images. On Mac OS X, they are located in <app/install/dir>Find & Replace It!.app/Contents/Resources/images

Uninstall

Generalities

When using this software, some settings files might be generated. The settings files location varies with the platform. All these files and directories are prefixed by either dProg or FindReplaceIt.

Until version 1.3.x the following folders might have been used:

• On Unix and Mac OS X:
  • $HOME/.config/dProg/FindReplaceIt*
  • $HOME/.config/dProg*
  • /etc/xdg/dProg/FindReplaceIt*
  • /etc/xdg/dProg*
• On Windows:
  • %APPDATA%\dProg\FindReplaceIt*
  • %APPDATA%\dProg*
  • %COMMON_APPDATA%\dProg\FindReplaceIt*
  • %COMMON_APPDATA%\dProg*

Since version 1.4.x the following folders might be used:

• On Mac OS X, since 1.4.3:
  • ~/Library/ch.dprog.FindReplaceIt/<version>
• On Mac OS X prior to 1.4.3:
  • $HOME/.config/dProg/FindReplaceIt/<version>/
• On Linux:
  • $HOME/.config/dProg/FindReplaceIt/<version>/
  • /etc/xdg/dProg/FindReplaceIt*
  • /etc/xdg/dProg*
• On Windows:
  • %APPDATA%\dProg\FindReplaceIt\<version>\

• On Mac OS X:
  • ~/Library/ch.dprog.FindReplaceIt/<minor-version>
• On Linux:
  • $HOME/.config/dProg/FindReplaceIt/<minor-version>/
  • /etc/xdg/dProg/FindReplaceIt*
  • /etc/xdg/dProg*
• On Windows:
  • %APPDATA%\dProg\FindReplaceIt\<minor-version>\

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!/<version> 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: <FindReplaceIt/install/dir>/uninstal.sh (where <FindReplaceIt/install/dir> 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 other 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.

Copyright© 2007-2012, dProg - Philippe Docourt