FourTidy 3.1 build: 9639 released: 2012-01-10 compiled with: Java 1.8.0_131 Jet jet12.0-pro-x86/1.8.0_131 Tidies TCC DESCRIPT.ION files, generates _O_V_E_R_V_I_E_W.txt files. Copyright: (c) 2001-2017 Canadian Mind Products. Java application. Download from: http://mindprod.com/products1.html#FOURTIDY ---- Notes: You must install the Java JRE to use this program. See http://mindprod.com/jgloss/jgloss/jre.html This program can only be used from the command prompt, (or via an command line style icon shortcut) e.g. under Windows command.exe or JPSoft tcmd.exe, formerly called the DOS box. Just clicking the programs in a directory listing will not do anything useful. Just typing the program names at the command prompt will not either. This program requires a manual install! See below. This program works with vanilla text files, (e.g. ASCII files or UTF-8 Unicode files). You will need a text editor to create and view them, not a word processor. e.g. notepad, Visual Slick Edit or other suitable text editor http://mindprod.com/jgloss/editor.html. You must use a monospaced font http://mindprod.com/jgloss/monospacedfonts.html (aka fixed pitch, aka programmer font) to view your files, or they won't look properly aligned. I put out an avalanche of free software into the world, and submit PAD files to hundreds of distribution sites, but I rarely hear back from anyone. What's happening? Does it all just work fine? It is so complicated nobody can figure out how to use it and they give up on it? It is it useful? Since everyone has the source, do people just fix the programs to their liking themselves? Did you have trouble installing? Do I presume you know too much? I would be happy to hear from you about your experiences, positive or negative and your requests for improvements. A one-line email to roedy@mindprod.com would be great. ===> 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 labelled non-military use only. http://mindprod.com/contact/nonmil.html All Java jars and source code are included. If you need the class files or Javadoc, you will have to build them yourself. To streamline the zip downloads, class files and Javadoc have been removed. ---- Prerequisites: This program runs under any OS that supports Java, (e.g.W2K/XP/W2003/Vista/W2008/W7-32/W7-64/W8-32/W8-64/Linux/LinuxARM/LinuxX86 /LinuxX64/Ubuntu/Solaris/SolarisSPARC/SolarisSPARC64/SolarisX86/SolarisX64/OSX/AIX...) so long as you have <><> Java version 1.8 <><> 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 jar 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.exe %JAVA_OPTIONS -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 jar 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.exe -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 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-