FAR  2.0.3
About: FAR (Find And Replace) is a simple tool for search and replace operations over multiple files.
  Fossies Dox: FAR-2.0.3-sources.tar.gz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

FAR Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies FAR-2.0.3-sources.tar.gz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).
FAR - Find And Replace 2.0.3 (20-11-2020)

A GUI for find and replace operations across multiple files in entire directory trees. 
With or without regular expressions. Special support for expressions spanning multiple lines.


System Requirements:
You need Java 1.6 or later to compile the sources and to run FAR. 

Library Depencies:
-- commons-logging-1.1.jar
-- log4j-1.2.7.jar (or equivalent logging implementation for commons-logging)
-- junit-3.8.1.jar (optional)
These libraries are not part of the source distribution (but included in the binary distribution).

To create windows binaries with Ant, you will furthermore want to get launch4j from
http://launch4j.sourceforge.net. See the Ant integration instructions below.

Unpacking the Sources:
Extract the tarball into a directory of you choice. It will create a subdirectory "far" that
contains the sources. You can extract source and binary version into the same directory but
you are not encouraged to do so.

You will get a Maven style source tree:


IDE integration:
To compile the sources, you must put the libraries and everything from src/main/java
and src/main/resources into the classpath. To compile and run the tests, add JUnit and the 
two test source directories src/test/java and src/test/testfiles to the classpath.

The executable main class is net.pandoragames.far.ui.swing.FindAndReplace.

Running Ant
To run the Ant build script, you may need to change the library pathes in the first lines
of the build script. If you use a Maven style repository, just set the "repository.dir" 
property to the location of that directory. 
Otherwise set it to your "lib" directory and adapt the values of the "commons-logging.lib"
and the "log4j.lib" property (you will want to remove the directory path in front of
the jar file name).

To create windows binaries with Ant (target win-bin), get launch4j from 
http://launch4j.sourceforge.net, unpack it and set the Ant property "launch4j.dir" accordingly.

Note that the default target "release" creates all binary variants plus the source release.
You will most likely rather want to call one of the other targets: win-bin, x-bin or mac-bin.

There is a subtle difference between the build file from SVN and the build file from the 
tarball: The SVN build file will ask you interactively to specify a version number, while
the tarball build file uses a fixed version.