1.3.7 "stable"

AUTHORS

@@ -0,0 +1,7 @@
+Dmitry Kirsanov <dmitry@kirsanov.com> designed Fresh Eye
+and implemented original MS-DOS version in 1995.
+
+Vadim Penzin <penzin@attglobal.net> rewrote and ported Fresh Eye to 
+Linux, FreeBSD, OpenBSD and Win32 in 1999-2000.
+
+$Id: AUTHORS,v 1.2 2002/06/07 03:45:54 vadimp Exp $

BUGS

@@ -0,0 +1,55 @@
+This file describes known deficiencies of Fresh Eye.
+
+* Fresh Eye imposes no artificial limitations neither on the size of
+  input files nor on the length of lines. Nevertheless, Fresh Eye by itself
+  is helpless if your system has small memory. In extremely rare, although
+  possible conditions of insufficient memory, Fresh Eye makes no attempts of
+  graceful recovery - it aborts processing. There are five ways to overcome
+  such situations:
+
+  - If the input file has many enormously long lines ('long' means more than
+    tens or hundreds of kilobytes, which is quite possible with
+    machine-generated HTML or texts having big paragraphs, which were
+    exported from word processors like Microsoft Word), it definitely makes
+    sense to re-format the file. While re-formatting, bear in mind that
+    Fresh Eye makes certain assumptions about text formatting, which affect
+    its computations. Please consult program documentation for details.
+
+  - Split input file into smaller pieces. This will always help.
+
+  - Try smaller context length (see --context-size option). This will make
+    Fresh Eye less precise.
+
+  - Use larger swap space (or 'virtual memory', in Win32 parlance).
+
+  - Buy more RAM.
+
+* Messages issued by Fresh Eye are a mess - part of them in English,
+  part of them in Russian. 
+
+* Fresh Eye ignores locale settings, using its own default encoding for
+  Russian messages.
+
+* If resume is enabled (--resume=y) and fresheye.log contains information
+  about more than one pass over the same particular file then fe uses
+  information of the first pass for resuming.
+
+* Fresh Eye does not detect encoding of its log files, assuming they are
+  encoded using its own default encoding. It means that a log file produced
+  on Win32 using CP-866 cannot be processed "as is" on UNIX, where KOI8-R
+  is the default encoding - Fresh Eye will skip over all entries found in
+  this file.
+
+* 'ce' code page conversion utility cannot be used for general conversion
+  tasks because it ignores non-letters, for instance, it does not attempt to
+  convert pseudo-graphic characters.
+
+Please send suggestions for improvements or new features to
+Dmitry Kirsanov <dmitry@kirsanov.com>. Please make sure there are words
+'Fresh Eye' in the Subject: line.
+
+If you think that you discovered a bug, please report it to
+Vadim Penzin <penzin@attglobal.net>. Please make sure there are words
+'Fresh Eye' in the Subject: line.
+
+$Id: BUGS,v 1.2 2002/06/08 18:32:01 vadimp Exp $

ChangeLog

@@ -0,0 +1,218 @@
+2002-06-29  Vadim Penzin  <penzin@attglobal.net>
+
+	* Rewrote interactive "interface" along the lines set by DK. Now there
+	is a help summary and a 'default key' feature.
+	* --resume has no argument anymore and it is off by default.
+	* Fixed description of --context-size in fe's usage: no upper limit,
+	must be 2 at least.
+	* Word dictionary dump is sorted by the number of occurences, in
+	descending order. No unique words in output. Properly handles empty
+	files, as well as files having only one, or only two words in them.
+	If all words are unique, the entire word dictionary is dumped.
+	* Fixed building using Microsoft Developer Studio.
+	* Updated win32/README with information on Cygwin
+	* Merged win32/recode.dsw and win32/fe.dsw into win32/fe.dsw.
+	* Changed version to 1.3.7.
+
+2002-06-28  Vadim Penzin  <penzin@attglobal.net>
+
+	* Added --without-cygwin to configure.in. Since Cygwin does not
+	attempt to determine if debug version of Microsoft Runtime Library
+	is present on the system, --without-cygwin disables --enable-debug
+	and --enable-profile (which are meaningless in this context anyway).
+	* Streamlined getopt_long detection logic and handling.
+	* configure prints settings summary on exit.
+
+2002-06-27  Vadim Penzin  <penzin@attglobal.net>
+
+	* Added --enable-encoding to configure.in. src/fe.c, src/lingtbl.c and
+	src/ui.c are not distributed anymore, configure creates these files from
+	src/fe.koi8-r, src/lingtbl.koi8-r and src/ui.koi8-r.
+	* Added platform detection at the build time.
+	* Fixed src/Makefile.am for Cygwin's $EXEEXT, separated generated files
+	from fe_SOURCES to nodist_fe_SOURCES and added them to MOSTLYCLEANFILES.
+	Now building from CVS requires automake-1.5.
+	* Changed default value of sensitivity threshold to 500.
+	* fe --version and ce --version print information about the platform
+	they were compiled on as well as default encoding which was set using
+	--enable-encoding.
+	* win32/*.dsp are broken for a while, will fix it later.
+
+2002-06-27  Dmitry Kirsanov  <dmitry@kirsanov.com>
+
+	* src/lingtbl.c: changed information values for yo
+	* src/fe.c: broke infor() into two functions, infor_same() and
+	infor_diff()
+	* src/fe.c: in simwords(), added a step to decrease sim based on
+	infor_diff()
+	* src/fe.c: in set_count_coefficient() decreased divisor from 13 to 8
+	to sharpen dependance on wordcount information
+
+2002-06-08  Vadim Penzin  <penzin@attglobal.net>
+
+	* Moved README.win32 to win32/README, added win32/README to
+	EXTRA_DIST in win32/Makefile.am
+	* Removed win32/Makefile.mingw32
+	* Made error message issued when user provides no input more
+	informative, removed message issued when processing of a file begins
+	* Added win32/recode.dsw win32/recode.dsp
+	* Rewrote win32/README
+	* Fixed compilation errors on Win32
+	* Updated BUGS, wrote NEWS and TODO, added them to the distribution.
+
+2002-06-07  Vadim Penzin  <penzin@attglobal.net>
+
+	* Corrected creation year of original Fresh Eye in AUTHORS
+	* Added --enable-debug and --enable-profile for configure
+	* Fixed configure for platforms that do not have getopt_long
+	* Eliminated remaining #includes in headers
+
+2000-10-15  Vadim Penzin  <penzin@attglobal.net>
+
+	* Added automatic generation of config.h. Version changed to 1.3.6
+
+2000-10-07  Vadim Penzin  <penzin@attglobal.net>
+
+        * Added compilation of GNU's getopt on platforms
+	that do not have getopt_long. This change affected
+	configure.in and src/Makfile.am
+
+	* Fixed warnings issued by gcc on FreeBSD in getopt.c
+
+	* Compiles and runs on FreeBSD. Version changed to 1.3.5
+
+2000-10-05  Vadim Penzin  <penzin@attglobal.net>
+
+	* Added support for "yo". The similarity and quantity of
+	information coefficients are *copied* from "ye"
+
+	* Version changed to 1.3.4
+
+2000-10-02  Vadim Penzin  <penzin@attglobal.net>
+
+	* Changed #inclusion policy to "included files do not #include
+	other files".
+
+	* All warnings issued by -Wall eliminated
+
+	* Added dos/fe.dsw, dos/ce.dsp, dos/fe.dsp
+
+	* Compiles with Microsoft Visual C 6.0 without warnings
+
+	* Version changed to 1.3.3
+
+2000-04-30  Vadim Penzin  <penzin@attglobal.net>
+
+	* src/ce.c: Added --strict
+
+1999-07-28  Vadim Penzin  <penzin@attglobal.net>
+
+	* Added wrappers.c, wrappers.h, utilities.c and utilities.h. 
+	All calls to fopen and fclose changed accordingly except for
+	check_log ().
+
+	* Added empty context.c context.h
+
+	* Wrote first version of README.win32
+
+	* All files opened for reading are now closed
+
+1999-07-27  Vadim Penzin  <penzin@attglobal.net>
+
+	* Created dos/Makefile.gcc for use with Mingw32
+
+1999-07-26  Vadim Penzin  <penzin@attglobal.net>
+
+	* Word mode removed, globals wordmode and wordwrap eliminated,
+	fgs (), nextword () and displ_help () changed accordingly.
+
+$Id: ChangeLog,v 1.11 2002/06/29 06:50:54 vadimp Exp $
+2002-06-26  Vadim Penzin  <penzin@attglobal.net>
+
+	* --version prints platform type
+	* Added acconfig.h
+	* Removed src/config.h.in from CVS
+
+2002-06-21  Vadim Penzin  <penzin@attglobal.net>
+
+	* Build fixes for NetBSD 1.5.2
+
+2002-06-08  Vadim Penzin  <penzin@attglobal.net>
+
+	* Moved README.win32 to win32/README, added win32/README to
+	EXTRA_DIST in win32/Makefile.am
+	* Removed win32/Makefile.mingw32
+	* Made error message issued when user provides no input more
+	informative, removed message issued when processing of a file begins
+	* Added win32/recode.dsw win32/recode.dsp
+	* Rewrote win32/README
+	* Fixed compilation errors on Win32
+	* Updated BUGS, wrote NEWS and TODO, added them to the distribution.
+
+2002-06-07  Vadim Penzin  <penzin@attglobal.net>
+
+	* Corrected creation year of original Fresh Eye in AUTHORS
+	* Added --enable-debug and --enable-profile for configure
+	* Fixed configure for platforms that do not have getopt_long
+	* Eliminated remaining #includes in headers
+
+2000-10-15  Vadim Penzin  <penzin@attglobal.net>
+
+	* Added automatic generation of config.h. Version changed to 1.3.6
+
+2000-10-07  Vadim Penzin  <penzin@attglobal.net>
+
+        * Added compilation of GNU's getopt on platforms
+	that do not have getopt_long. This change affected
+	configure.in and src/Makfile.am
+
+	* Fixed warnings issued by gcc on FreeBSD in getopt.c
+
+	* Compiles and runs on FreeBSD. Version changed to 1.3.5
+
+2000-10-05  Vadim Penzin  <penzin@attglobal.net>
+
+	* Added support for "yo". The similarity and quantity of
+	information coefficients are *copied* from "ye"
+
+	* Version changed to 1.3.4
+
+2000-10-02  Vadim Penzin  <penzin@attglobal.net>
+
+	* Changed #inclusion policy to "included files do not #include
+	other files".
+
+	* All warnings issued by -Wall eliminated
+
+	* Added dos/fe.dsw, dos/ce.dsp, dos/fe.dsp
+
+	* Compiles with Microsoft Visual C 6.0 without warnings
+
+	* Version changed to 1.3.3
+
+2000-04-30  Vadim Penzin  <penzin@attglobal.net>
+
+	* src/ce.c: Added --strict
+
+1999-07-28  Vadim Penzin  <penzin@attglobal.net>
+
+	* Added wrappers.c, wrappers.h, utilities.c and utilities.h. 
+	All calls to fopen and fclose changed accordingly except for
+	check_log ().
+
+	* Added empty context.c context.h
+
+	* Wrote first version of README.win32
+
+	* All files opened for reading are now closed
+
+1999-07-27  Vadim Penzin  <penzin@attglobal.net>
+
+	* Created dos/Makefile.gcc for use with Mingw32
+
+1999-07-26  Vadim Penzin  <penzin@attglobal.net>
+
+	* Word mode removed, globals wordmode and wordwrap eliminated,
+	fgs (), nextword () and displ_help () changed accordingly.
+
+$Id: ChangeLog,v 1.11 2002/06/29 06:50:54 vadimp Exp $

Makefile.am

@@ -0,0 +1,7 @@
+# $Id: Makefile.am,v 1.5 2002/06/27 00:44:00 vadimp Exp $
+
+EXTRA_DIST = NEWS TODO BUGS README.Russian
+SUBDIRS = src win32
+
+recode:
+	(cd src; make recode)

NEWS

@@ -0,0 +1,36 @@
+This file describes changes made to Fresh Eye from one release to another.
+
+* Fresh Eye 1.4
+
+  Fresh Eye 1.4 features great performance and feature improvements over
+  its predcessor - Fresh Eye 1.21, released in November 1995:
+
+  - Fresh Eye 1.4 compiles and runs on a variety of platforms: Linux,
+    FreeBSD, OpenBSD, Sun Solaris, Win32, and Cygwin. We believe that
+    Fresh Eye can be compiled with no or little modifications on many
+    other platforms.
+
+  - Fresh Eye 1.4 supports virtually all major single-byte Russian
+    encodings: KOI8-R, CP-1251, CP-866, MacCyrillics, ISO 8859-5.
+
+  - Fresh Eye 1.4 imposes no artificial limitations on its input: length
+    of a word, length of a line, number of lines in a file, size of the
+    word dictionary, size of the context can be anything that fits in
+    computer's memory.
+
+  - Fresh Eye 1.4 is a true 32-bit application that is able to use all
+    available memory found on modern desktop systems.
+
+  - Fresh Eye undergone massive speed optimisations: now it processes
+    its input up to ten times faster than Fresh Eye 1.21 on the same
+    machine.
+
+  - Fresh Eye 1.4 features a better command-line interface, which uses
+    GNU long options, and is able to process several files at once.
+
+  MS-DOS is not supported anymore. The state of OS/2 port made by
+  K. Boyandin is unknown, link to his home page points nowhere.
+  Fresh Eye 1.4 breaks compatibility with the log file format of
+  Fresh Eye 1.21.
+
+$Id: NEWS,v 1.2 2002/06/08 18:32:01 vadimp Exp $

README

@@ -0,0 +1,16 @@
+If you just fetched the source tree from a CVS repository, please use
+the following command to generate files that are needed for building:
+	aclocal && autoconf && autoheader && automake -a
+
+Please refer to the file named INSTALL for building on UNIX or Cygwin.
+
+Please see win32/README for building on Win32.
+
+Please read the file README.Russian for general description of the program,
+the file is encoded using KOI8-R.
+
+Send suggestions for improvements to Dmitry Kirsanov <dmitry@kirsanov.com>
+Report bugs to Vadim Penzin <penzin@attglobal.net>
+Please make sure there are words 'Fresh Eye' in the Subject: line
+
+$Id: README,v 1.3 2002/06/26 00:27:47 vadimp Exp $

TODO

@@ -0,0 +1,21 @@
+This file describes features that we would like to implement in the future,
+in random order:
+
+* Automatic generation of binary packages for various UNIX packaging systems
+  (DEB, RPM etc).
+* Installer for Win32.
+* Unicode support, UTF-8 in particular.
+* Implement '-O' option for changing encoding of output produced by
+  Fresh Eye (Now it is #ifdef'ed out in src/ui.c).
+* Use XML for the log file.
+* Use GNU gettext for message translation and locale-aware functionality.
+  (Can it be done on Win32?)
+* Write a man page and/or texinfo documentation.
+* Embedding API that would allow for integration of Fresh Eye into e-mail
+  clients, text editors and word processors.
+* More ports: Max OS X, HURD.
+
+If you wish to participate, please contact 
+Dmitry Kirsanov <dmitry@kirsanov.com> or Vadim Penzin <penzin@attglobal.net>
+
+$Id: TODO,v 1.1 2002/06/08 18:32:55 vadimp Exp $