1Upgrade Instruction
2
3    Here are a few hints for people upgrading from 3.10 or earlier:
4
5* The Default Installation Location Is at /usr/bin
6
7    Also, the man page is at /usr/share/man/man1/reslog.1.  This is to follow
8Perl's standard convension, and to avoid breaking ExtUtils::MakeMaker with
9future versions.
10
11    When you run "perl Makefile.PL" or "perl Build.PL", it will hint a list of
12old files found to be removed.  Please delete them manually.
13
14    If you saved them in other places, you have to delete them yourself.
15
16    Also, if you have any scripts or cron jobs that are running reslog, remember
17to modify your script for the new reslog location.  Of course, you can copy
18reslog to the original location.  It will still work.
19
20
21    Here are a few hints for people upgrading from 3.02 or earlier:
22
23
24* The Script Name is Changed from reslog.pl to reslog
25
26    This is obvious.  If you have any scripts or cron jobs that are running
27reslog, remember to modify your script for the new name.  Of course, you can
28rename reslog to reslog.pl.  It will still work.
29
30    The reason I changed the script and project name is that:  A dot "." in
31the project name is not valid everywhere.  At least SourceForge don't accept
32it.  Besides, "reslog" is enough for a script name under UNIX.  The ".pl" file
33name suffix/extension may be convienent for MS-Windows, but MS-Windows users
34won't run it with explorer file name association anyway, and there is a pl2bat
35to convert "reslog" to "reslog.bat", which would make more sense.  The only
36disadvantage is that I use UltraEdit, which depends on the file name extension
37for the automatic syntax highlighting rules.  But this is not much trouble.  I
38can manuall set it anyway.
39
40
41* You Need Perl 5.8.0 or Above
42
43    reslog now has threading to speed up resolving, which requires Perl's
44ithreads threading module support that's only available since 5.8.0.  You can
45still disable threading if it causes troubles to you, but the code itself need
46it.  If you are using a Perl before 5.8.0, please upgrade it.  You can run
47"perl -v" to see your current Perl version.
48
49
50* The Default Keep Mode is Now "delete"
51
52    The documentation said the default keep mode is "delete", but the script
53actually did a "restart". :p  This is fixed.  If you are running with the
54default keep mode, remember to fix it.
55
56
57* The Argument of --keep and --override Options Are Required Now
58
59    Support for omitting --keep or --override argument is removed.  This helps
60avoiding confusion for the log file name and the option arguments.
61
62
63* Specifying STDIN Will No Longer Trigger STDOUT
64
65    When resolving multiple files, STDIN can output to STDOUT now, with other
66files output to where they should be.  Specifying an STDIN will no longer
67automatically trigger outputing everything to STDOUT.  If you want to output
68everything to STDOUT, be sure to add the --stdout option.
69
70
71imacat
722007-11-26
73imacat@mail.imacat.idv.tw
74http://www.imacat.idv.tw/
75