FourTidy 3.1 build: 9470 released: 2012-01-10

Tidies TCC DESCRIPT.ION files, generates _O_V_E_R_V_I_E_W.txt files.

Copyright: (c) 2012 Canadian Mind Products.

Java application.
Download from: http://mindprod.com/products1.html#FOURTIDY

===> Free <===
Full source included.
You may even include the source code, modified or unmodified
in free/commercial open source/proprietary programs that you write and distribute.
May be used freely for any purpose but military.
For more details on this restriction, see
http://mindprod.com/contact/nonmil.html
If you include any Canadian Mind Products code in your own applications,
your app too must be labeled non-military use only.
All Java jars and source code are included.

----

Prerequisites:

This program runs under any OS,
(e.g. Win2K/XP/Vista/W7x86/W7-64/OSX/Linux/Solaris/AIX...) so long as you have
<><> Java version 1.5 <><> or later installed (32-bit or 64-bit Java).
See http://mindprod.com/jgloss/installingjava.html for details.

----

Installing on a PC:

Download source and compiled class files to run on your own machine as an application.
First install a recent Java JDK or JVM.
See http://mindprod.com/jgloss/installingjava.html.
To install, extract the zip download with WinZip
(or similar unzip utility) into any directory you please,
often J:\ --  ticking off the "use folder names" option.
To run as an application,type:
java -ea -jar J:\com\mindprod\fourtidy\fourtidy.jar {put any parms here}

adjusting as necessary to account for where the jar file is.

----

Installing on a MacIntosh:

Use Safari to download source and compiled class files to run on your own machine as an application.
Safari will automatically unpack the zip into ~/Downloads (version 10.5)
[or on the Desktop (version 10.4 and earlier)].
First install a recent Java JDK or JVM.
See http://mindprod.com/jgloss/installingjava.html.
You may optionally move the download tree to a permanent home.
I don't have a MacIntosh, just a PC, so I can't test my Java programs for Mac compatibility.
In theory they should work without problems, but in practice that does not always happen.
If you have problems please, let me know, preferably with screenshots and complete verbatim error messages.
To run as an application, without parameters, just double click the jar file.

To run as an application with parameters, in bash shell type:
open Terminal.app
cd ~/Desktop
java -ea -jar com/mindprod/fourtidy/fourtidy.jar {put any parms here}

adjusting as necessary to account for where the jar file is.

----

Rebuilding:

The zip already contains the necessary class and jar files, so unless you modify
the program, there is no need to recompile the source or rebuild the jar.
Configure.java basedir="E:/" in rebuild.xml to the drive where your files are.
Use ANT and rebuild.xml, not build.xml, to recompile and recreate the jar.

----

Use:

To tidy, sort, prune and dedup a JP Software Take Command/4NT/4DOS hidden
DESCRIPT.ION file.  These files are used by the DESCRIBE utility to track
what your various files are for.  See
http://mindprod.com/jgloss/takecommand.html for more information on the
Take Command/TCC command processor.

First make the directory containing the usually-hidden DESCRIPT.ION file
current.  e.g.

C:
cd \env

Then invoke the java program with:

java.exe -jar C:\com\mindprod\fourtidy\fourtidy.jar

There are three possible option switches you can put on the command line:

-d  the default if you don't specify an option. If there are duplicates in the DESCRIPT.ION file,
    fourtidy takes the one with the most detailed longest description.

-f  take first.  If there are duplicates in the DESCRIPTI.ION file, fourtidy takes the first one.
    I use this option to bulk replace descriptions. I insert inserting new ones at the top, and letting fourtidy
    remove duplicate existing ones, without disturbing the other descriptions.

-l  take last. If there are duplicates in the DESCRIPTI.ION file, fourtidy takes the last one.
    When DESCRIBE adds a description, it tacks in on the end.  This technique picks the most recently
    added duplicate.

If you have Excelsior Jet, (http://mindprod.com/jgloss/jet.html/) you can
compile the jar and simplify that long-winded command to:

fourtidy.exe

To save typing, create a *.BAT file on the path containing the command.
You might also want to hide/reveal the DESCRIPT.ION file with:
attrib +h DESCRIPT.ION
attrib -h DESCRIPT.ION

Fourtidy will sort, tidy, and prune duplicates in the DESCRIPT.ION file.
It will also create a non-hidden file called _O_V_E_R_V_I_E_W.txt with the
information about all your files in the directory in aligned human
readable form.

If there are duplicate descriptions for a file in the DESCRIPT.ION file,
it will take the first one and discard the rest.

If you mention a file on a DESCRIBE command already in the description
file, the description on the DESCRIBE file will override the one in the
file.

Why the broom icon?  The broom signify cleaning and tidying up.  the 4 and
the lightning bolt are similar to the 4NT icon.


----

Version History:

 2.0 2001-01-19 initial version

 2.1 2004-05-30 works if manifest.txt does not exist

 2.2 2006-03-05 reformat with IntelliJ, add Javadoc.

 2.3 2006-03-13 move to JDK 1.5 and for:each

 2.4 2007-06-01 handle empty DESCRIPT.ION file. Handle blank lines in DESCRIPT.ION file.

 2.5 2007-12-31 put text results in manifest.txt instead of readme.txt. Automatic describe of manifest.txt and DESCRIPT.ION

 2.6 2008-01-01 fix ConcurrentModificationBug

 2.7 2009-05-11 change name of manifest.txt to _O_V_E_R_V_I_E_W.txt

 2.8 2009-11-18 filter out files not from this dir from the DESCRIPT.ION file.

 2.9 2011-02-01 allow -d -f -l option letter on the command line.

 3.0 2011-11-07 avoid writing files back if nothing has substantially changed.

 3.1 2012-01-10 fix bug in inOrder that caused dups to accumulate.

-30-