                 Plugin "Block Processor 2.11"  for FAR Manager
                 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

                *** I would like to thank to my wife Jaruska ***
                 ***  that  she  tolerates  my *FAR* hobby. ***

Plugin version:  2.11 (build 003)
Min FAR version: 1.70 beta 5  (build  1634)
Author:          Ondrej Brablc
Place:           Germany, Frankfurt am Main
Email:           mailto:far@brablc.com?Subject=BlockPro
Web:             http://far.brablc.com

Please read:

 - "WhatsNew.txt" if you have used this plugin before.
 - "License.txt" if you want to use this plugin.
 - "Todo.txt" before you submit your wishes.

Use F1 when working with plugin, there is also help for some examples. This help
can be invoked only when the dialog window of this example is opened.

This distribution contains four sets of examples in "Reg" subdirectory:

ExamplesNative.reg ........ 15
ExamplesJScript.reg .......  7
ExamplesPerl.reg .......... 27

Native examples uses command line programs of your Windows  (DOS)  and  BlockPro
native plugins and therefore these examples can be imported by anyone.  For  the
remaining two example sets you  need  proper  interpreter.  JScript  is  usually
already installed on most Windows installations as a component of Windows Script
Host. This plugin requires 5.5 version of WSH or 5.1 when Internet Explorer  5.5
or better is installed. You can try to import and test  these  examples  if  you
will  get  an   error   you   should   upgrade   your   WSH   to   5.5   version
http://msdn.microsoft.com/scripting/.

The rest (and also the best) of the examples are interpreted by Perl.  The  Perl
can be dowloaded from http://aspn.activestate.com/ASPN/Downloads/ActivePerl/. It
is free and the installation/uninstallation process is  painless  -  no  restart
needed.

Please import "Reg\History.reg" in order to initialize  default  values  of  the
examples.

The functionality of the  following  plugins  is  replaced  by  above  mentioned
examples distributed along with this plugin:

 - "Align Block"
 - "Append Block"
 - "Block Indent"
 - "Clipboard Summator"
 - "Edit Case"
 - "Context-dependent help and Activator" or "EXTHELP"
 - "External Filter"
 - "Open in new window"
 - "Renumber Lines"
 - "Runglish"
 - "String sorting"
 - "The statistic for selected text"

Only the core functionality (what I  use)  from  some  plugins  above  has  been
implemented in the example scripts. I welcome all hints and improvements of  the
example scripts and the plugin itself. Please feel free to send me your  scripts
I will consider to put them into the next release of the plugin.

There are some other examples that might cover another plugins or that might  be
new. The list is not complete it only shows  the  examples  with  biggest  added
value:

 - "Find Duplicate Files": do you have a thousand of pictures and some  of  them
   are duplicate? Try this example, it compares the size of files (even  recurse
   in subdirectories) and if the size is the same then it compares it binary. If
   the files are identical then they are listed in user customized format.
 - "Split & Glue": File is too big and already compressed? No problem  split  to
   several parts and glue together either by  append  from  FAR  or  using  this
   example again.
 - "Word frequency": get  unique  words  from  the  document  along  with  their
   frequency.
 - "Context help for Java API docs": install  Java  DOCS  and  set  up  path  to
   allclasses-frame.html  file for  command  "Development/Context  help/Java All
   classes API docs". Proper html page will be displayed on help activation.

Tested on Windows NT, Windows 2000 Professional, Windows 98 (partially).
