reslog change log

2005-05-08	version 3.05
	Bug fix.
	 1. STDIN and STDERR are checked for availability first, and create
	    dummy ones if they are not available.  This fixed the bugs that on
	    MSWin32 when STDIN is not opened, redirecting unopened STDIN
	    caused error.  This is the situation running "make test" in
	    CPANPLUS.

2005-05-08	version 3.04
	 1. Fixed a typo when loading File::MMagic that prevent itself from
	    loading File::MMagic

2005-05-08	version 3.03
	 1. flock() policy is redesigned.  Now all the file handles that are
	    not opened to ordinary files are not locked.  Lock is released when
	    when file handle is accessed with a foreign program.  Files handles
	    are always locked when opened to ordinary files and accessed
	    internally, even for anonymous temporary files.  This simplified
	    the locking problem.  How foreign programs access file handles are
	    not an issue anymore.
	 2. Makefile.PL: MY pacakge is added.  Makefile target "upgrade" is
	    added to remove the old files.  constants() and manifypods()
	    methods are added to alter the default install location.  Now we
	    default to install to /sbin directory and as manpage section 8.
	    That is what I want.
	 3. BUGS and TODO section of the embedded POD document updated.

2005-05-02	version 3.02
	 1. _private::Resolver and _private::Resolver::Threaded are added.
	    Resolver is independent from the main program so that other log
	    file filter can use the same code with least modification (GeoIP,
	    for example).
	 2. Help text on temporary working file updated.
	 3. Unsupported file format error message was using $type, which
	    should be $_.  This is fixed.
	 4. Test 31-39 added to test --suffix and --trim-suffix.
	 5. Tested with cygwin.
	 6. Quotes added to the test suite to avoid problem when make test
	    in directories whose names may contain spaces.
	 7. Required Perl version changed to 5.8.0.  5.7.2 is a development
	    version.  It's meaningless to require that.

2005-05-01	version 3.0102
	 1. check_magic(), check_gzip() and check_bzip2() now check the return
	    value of eval() directly, instead of saving it in $ok and check
	    that.
	 2. %CONF is introduced to save the configuration.
	 3. $THIS_FILE, $SHORTHELP and $VERBOSE are moved from
	    "use vars qw(...)" to "our (...)", to ease program management.
	 4. DEFAULT_PROGBAR is introduced to handle the default display status
	    of the progress bar.

2005-05-01	version 3.0101
	Labours' Day!
	 1. Package name changed from ResLog to main, to avoid polluting the 
	    CPAN namespace.
	 2. Class names changed from ResLog::* to _private::*, to avoid
	    polluting the CPAN namespace.
	 3. check_io() returns an I/O interface object instead of an I/O type
	    constant, so that the I/O handler object can be generated from it
	    directly.  new_read(), new_write() and new_append() now returns an
	    I/O handler object generated from the I/O interface object.
	 4. use_flock() is added to IO::* I/O handlers to see if flock() is
	    to be used on I/O handlers, to replace run-time checks.  Currently
	    bzip2 on MSWin32 should not use flocks().
	 5. The constants IO_* are removed.
	 6. whereis() now uses ExtUtils::MakeMaker MM->maybe_command() to find
	    the executable.  This is inspired from CPAN::FirstTime.

2005-04-26
	 1. Changes: File edited to widen line limit from 60 columns to 79
	    columns, to ease reading.

2005-04-26	version 3.01
	Bug fix.
	 1. --suffix and --trim-suffix was not working.  I mistakenly put
	    $_[0] instead of $_[1] in the GetOptions() and this wasn't tested!
	    ^^;  This is fixed.
	 2. Correct a typo in the documentation ("rewrite" should be
	    "rewrote").
	 3. Fixed a mistake that Changes.zh-tw was not updated with
	    Changes.zh-cn.

2005-04-26	version 3.00
	 1. README updated
	 2. HTML documentation updated.
	 3. Uploaded to CPAN.
	 4. HTML documents updated to conform to W3C Web Content Accessibility
	    Guide 1.0 Triple-A now.

2005-04-26	version 2.9901
	 1. INSTALL rewritten.
	 2. UPGRADE added.

2005-04-25
	 1. Module::Signature SIGNATURE gpg signature file added.  The
	    external gpg signature file is no longer used.
	 2. Test suite added.
	 3. Many bugs fixed, thanks to the test suite.

2005-04-24	version 2.99
	This is a new object-oriented version.  I rewrote the whole script
	from an empty file.
	 1. Rewrite everything in object-oriented style.
	 2. ithread threading support is added.  With threading it can check
	    several IP at the same time, dramatically reducing the time cost.
	    This requires Perl 5.7.2 ithread support.  New option
	    --num-threads is added for this.  You can see the effect by
	    running with -d -d.
	 3. Supports for running gzip executable, running Compress::Bzip2,
	    running bzip2 executable are added.  This is the benefit of
	    object-oriented programming.  Log entry read/write is now done
	    through an uniformed I/O handler API.  This eased the addition of
	    new I/O handlers.
	 4. New option --trim-suffix is added to remove certain file name
	    suffix before appending our suffix, so that reslog can line-up
	    with other log file post-processers.
	 5. file utility can be used instead of File::MMagic if that is not
	    available.
	 6. Term::Size is used to display the progress bar under UNIX.  Under
	    MSWin32 Win32::Console will be used instead.  reslog can run
	    without them, but you won't see the progress bar.
	 7. Instead of resolving line by line, reslog now collects all the IP
	    found on all the source log files first, resolve those IP
	    altogether, and replace the IP with the resolved domain name in
	    the log entries at one time.
	 8. The script and project name changed from "reslog.pl" to "reslog".
	    A dot "." in the project name is not valid everywhere, like
	    SourceForge.  "reslog" is enough for a script name under UNIX.
	    MSWin32 users won't run it with explorer file association anyway,
	    and there is a pl2bat to turn reslog to reslog.bat.
	 9. Installation method is changed from my own Install.PL to Perl's
	    standard ExtUtils::MakeMaker.  Utilizing standard is a good thing.
	    Perl's ExtUtils::MakeMaker is more portable than GNU's autoconf.
	    As a result, reslog is installed into /usr/bin instead of
	    /usr/sbin under UNIX.  Of course, reslog don't need installation
	    at all. :p
	10. Version number is changed from 3 digits (2.1.0) to 2 digits
	    (3.00), according to the Perl module convention.
	11. ChangeLog is renamed as Changes, as what ExtUtils::MakeMaker
	    expects.

2003-01-04
	 1. File handler EOF read checks were fixed with defined().

2002-11-13
         1. Long statistic lines are split for easy reading.
         2. open_src() was rewritten according to open_src() in arclog.pl, in
            order to use comression with gzip and bzip2 binary executables.

2002-11-12
	 1. RELEASE_NOTES was renamed as ChangeLog.
	 2. AUTHORS was added.
	 3. THANKS was added.
	 4. The option checking logic was rewritten.
	 5. Fixed several places where $WORKING_SRC was not locked when
	    created with tempfile.
	 6. Fixed several places where spaces are between function name and
	    its opening parenthesis, according to perlstyle(1).
	 7. Unnecessary parenthesis after slice and catfile were removed.

2002-10-28
	 1. Fixed a bug that $WORKING_RES was not locked when opened.  But it
	    is unlocked when closed.  On some systems (like Linux) you can
	    request unlock on a filehandle that is not previous locked, but on
	    some others (like MSWin32) requesting unlock on a filehande that
	    is not previous locked will cause error.  $WORKING_RES doesn't
	    really need locking at all.  It is an anonymous temporary file
	    handle, that can be accessed by this same working process only.
	    It has no risk of simultaneously writing without threading, and
	    I'm not doing threading here.  I just lock it for a consistent
	    programming style.  (Thanks to Chen-hsiu Huang
	    <chenhsiu@gens.dhs.org> for reporting this.)

2002-09-28
	 1. File::MMagic and file are now used to check the file type, in
	    addition to the file name suffix, with a more preferred order.
	 2. check_file_type() was added to check the file types by either
	    File::MMaagic or file.
	 3. check_gzip() was added to check the gzip method to use.
	 4. check_bzip2() was added to check the bzip2 method to use.

2002-09-18	version 2.1.0dev2
	SourceForge Memorial Release.  It's my first time to apply a project
	from SourceForge.  Mostly are corrections to the documentation.
	SourceForge's project page is added to the available download source
	here.
	 1. reslog.pl's official home page at Tavern IMACAT's was restored.
	 2. The previous version was renamed from 2.1.0-dev1 to 2.1.0dev1, in
	    order to unify the version number theme.
	 3. The project space at SourceForge was applied.  Package files are
	    uploaded to SourceForge now.
	 4. Project virtual host at SourceForge was set up.
	 5. SourceForge was added into the documentation as an official
	    website and download source.
	 6. Documentation were corrected.  Too many places were corrected.
	    Ignored.
	 7. HTML document was rewritten to accommodate
	    XHTML 1.1 recommendation.

2002-08-31	version 2.1.0dev1
	Rewrite after almost 1 year, to be run on the newly-released Perl
	5.8.0.
	 1. Filehandles are now saved and passed in global named variables.
	    This is the way it should be.  The old way (initialize the file
	    handles by duplicate the STDIN and assign them) was just not
	    natural.  It works in Perl 5.6.1, but not in Perl 5.8.0.  The
	    duplicated filehandles are constants, which cannot be assigned new
	    values.
	 2. Indents are changed from 1 tab to 4 columns, to accommodate the
	    Perl style guide documented in perlstyle(1).  This increases the
	    code readability.
	 3. File operation error handlers are now using the
	    low-precedence logical "or", instead of "||",
	    which is recommended in perlop(1).  Excessive
	    parentheses in file operation functions are
	    removed for this.
	 4. Traditional Chinese files are now named with suffix ".zh-tw"
	    instead of ".b5".  Simplified Chinese files are now named with
	    suffix ".zh-cn" instead of ".gb".  This is to accommodate
	    RFC-3066, ISO 639:1988, ISO 3166-1 for language names.
	 5. PGP signatures of distribution files are added.
	 6. bzip2 distribution files are added.

2001-09-03	version 2.0.2
	 1. The bug that taking file handles as private variables and modified
	    them, was fixed.

2001-09-01	version 2.0.1
	 1. The bug that resolved cache %NAMES was not global, was fixed.  The
	    resolved result can be pass between multiple files now.
	 2. A bug that a hyper reference in the English document was not
	    specified as an absolute URL, was fixed.

2001-06-29	version 2.0.0
	First public release.
	 1. Chinese and English standard header were added.
	 2. Getopt::Long was introduced to parse the arguments, in replace of
	    my own argument-parsing routine.
	 3. File::Spec::Functions was introduced to handle the pathnames.
	 4. Cwd was introduced to obtain the current working directory.
	 5. autoflush from IO::Handle was introduced, to autoflush STDOUT
	    solely under debugging mode.
	 6. File::Temp was introduced to handle the temporary working file.
	    Processing is done on temporary working files to reduce the time
	    occupying the source and result files.
	 7. Compress::Zlib was used to read the compressed files.
	 8. rel2abs() was added to convert relative paths to absolute paths.
	 9. progress_bar() was added to display current status graphically.
	10. res_log() was added to loop multiple files.
	11. open_src() and save_res() to open source and save result.
	12. POD documents was added.
	13. Release notes was added.
	14. Readme file was added.
	15. GNU General Public License was added.
	16. Installation guide was added.
	17. Install.PL was added in the distribution.

2001-01-21	version 1.3.1
	 1. autoflush was modified to do only under debugging mode.
	 2. Simple header was changed standard header.

2001-01-07	version 1.3.0
	 1. [current/total] was added in the detailed processing messages.

2000-??-??	version 1.2.0
	 1. Custom parse_args() was added to parse the command line arguments.

2000-??-??	version 1.1.0
	 1. "--usetmp" was added to process temporary working files.
	 2. "--suffix" was added to alter the output suffix.
	 3. "--debug" was added to show detailed processing messages.

2000-12-22	version 1.0.0
	First version.
