///////////////////////////////////////////////////////////////////////////////////
//
//  Total Updater v0.8 BETA3
//  Total Commander & plugin updater utility.
//
//  Copyright (C) 2011-2013 Bluestar
//  - dev.bluestar [@] hotmail.com -
//
//
//  License to copy, use, and redistribute this software for any purpose is
//  granted provided that this notice may not be removed from this document.
//
//  This free software is distributed in the hope that it will be useful, but
//  WITHOUT ANY WARRANTY. In no event will the author or any other contributor
//  be held liable for any damages arising from the use of this software.
//
///////////////////////////////////////////////////////////////////////////////////


01. About
_________

Total Updater is a small tool that helps you to keep your Total Commander &
its plugins up-to-date. If you are using dozens of plugins for TC / always wants
to be sure that you are using the latest version of our beloved filemanager,
then this software is definitely for you.


02. Main Features
_________________

 - List all the installed plugins, addons, utilities & search their latest updates
 - Built-in multilingual support (Chinese Simplified, Czech, Danish, Dutch, English,
   French, German, Hungarian, Italian, Lithuanian, Polish, Russian, Slovak, Spanish,
   Swedish, Ukrainian) 
 - Advanced version detection routine: detect version based on history/readme file
   even if embedded verinfo field doesn't exists 
 - Advanced version compare routine: compare the files based on local&online version
   and date (if update found), to minimize the number of false alarms
 - Download selected / marked plugins quickly & easily
   (just double click on an item in the Download dialog to open the url in case a
   download fails for any reason [ssl connection, redirections, etc])
 - Download files through SSL connection (in case the server forces it):
   just download the latest zip from the following site & unzip the files
   "libeay32.dll" and "ssleay32.dll" to Total Updater's dir:
   http://indy.fulgan.com/SSL/
 - Internal Plugin Database (IPD), which makes available for the utility to
   properly detect the plugin packages based on filename 
 - You can add custom new items to UserDB (just search their ID on totalcmd.net,
   and they're going to override the matching original IPD [database] entry)
 - Simply press right-click in the plugin list, and click on "Marked items" ->
   "Confirm updatable item(s) as latest" to avoid false alarms, if there are any
 - Display additional info of every plugin by double-clicking on it
   (in English / Russian language - based on system's current locale) 
 - Infobox feature - display verinfo & icon of each plugin
   (right click on the list & choose Show Infobox, or press Ctrl + Q) 
 - Exclude from list option (file / directory) 
 - Full Unicode support 
 - ... and much more!


03. Compatibility
_________________

Basically any Total Commander version (heavily tested under 7.57a & 8.01)


04. Translation
_______________

If you'd like to translate Total Updater to your native language, you can
download the latest English language file from the following link:

 - http://bluesoft.hu/system/download/dl.php?id=7

Please check the homepage or the ghisler.ch forum for more instructions.


05. Todo list
___________________________

 - Unpacking & the actual installing of the plugins is coming soon!


06. Contact
___________

 - Official support thread (bugreports, feature requests, etc):
   http://www.ghisler.ch/board/viewtopic.php?t=36309

 - You can also find the plugin on TOTALCMD.net:
   http://www.totalcmd.net/plugring/totalupdater.html

 - Homepage of the plugin (hotkeys, instructions):
   http://totalupdater.bluesoft.hu

 - Contact me by e-mail:
   dev.bluestar [@] hotmail.com


07. History
___________

See the "whatsnew.txt" file.


08. Currently available hotkeys
_______________________________

- F2                   : Refresh local version information of the selected items
- F5 / Ctrl + R        : Refresh the whole plugin list & reload the database
- Alt + Enter          : Open the addon information dialog (double-click on item)
- Space                : Mark (tick) the selected item
- Ctrl + S             : Search / filter the list of plugins
- Ctrl + C             : Copy the selected items information to the clipboard
- Ctrl + Shift + C     : Copy the selected items information to the clipboard
                         (debug mode including CRC32 values)
- Ctrl + G             : generate checksum entries in ini-like structure for the
                         selected items & copy to clipboard
- Ctrl + Shift + Enter : Visit the current item's website if it exists
- Ctrl + Shift + W     : Visit the author website of the current item if it exists
- Ctrl + Num+          : Mark (tick) all the selected items in the list
- Ctrl + Num-          : Unmark (untick) all the selected items in the list
- Ctrl + Up            : Jump to the currently selected item(s) by opening new tab
                         (redirected to Total Commander)
- Ctrl + PageDown      : Jump to the currently selected item(s)
                         (redirected to Total Commander)
- Ctrl + D             : Download the currently selected file(s)
- Ctrl + Z             : Show the Internal Plugin Database / add current item to UserDB
                         (in case it doesn't exists in the IPD)
- Ctrl + X             : Exclude the selected file(s) from the list
- Ctrl + Q             : Show / hide the Infobox panel


09. Configuration parameters
____________________________

There are some special option / key that can't be set from inside Total Updater,
but they can be very handy in various situations. Below you can see the list
of the available keys you can add to "TotalUpdater.ini" by editing it in notepad.

[GUI]
AllowResize=False                                                (default : True )
                       Set this to "False" to disable resizing of the main window

JumpToFirstUpd=False                                             (default : True )
           If set to "False", TU will not jump to the first updatable item after a
                                 successful search in case any update can be found


[Plugins]
SecondaryPlgDir=c:\path\to\your\tc\addons                        (default :  -   )
 You can set any folder in which your additional (installed) plugins can be found

ForceSecondary=True                                              (default : False)
          Set this to "True" to only load the plugins inside the "SecondaryPlgDir"

ForceUseOfFN=True                                                (default : False)
         Set this to "True" to see the plugins filename (without extension) in the
    list instead of their real online package name (if "OnlineNameCorr" is enabled)
    or their corrected ProductName

OnlineNameCorr=False                                             (default : True )
                         Set this to "False" to disable the online name correction
              (by default the utility automatically tries to retrieve the matching
	                                              online name of the packages)

VerCorrOnDateMatch=False                                         (default : True )
      Set this to "False" to disable the automatic correction of the local version
         of the plugins in case their date matches the one of their online package
 (by default these values are automatically saved under [OverridePlugVer] section) 

ChecksumDBstate=0                                                (default :   2  )
       You can set this key to 0/1/2 to disable/enable/enable (force using of) the
                      additional checksum database (not recommended to turn it off)

TreatDateAsVer=False                                             (default : True )
        You can set this key to "False" to exclude items from the list without any
            real version information but PE TimeDateStamp / last modification date

UpdateDateCheck=False                                            (default : True )
                 You can set this to "False" to disable the additional comparement
         based on the local PE / file modification date & online modification date
	                                          in case a newer version is found

PubDateDiffCorr=0                                               (default :    1  )
          This key is used for the UpdateDateCheck function - many times an update
	  is not released on the same they it is built (PEDate), so the server date
	   is going to be one daynewer than the local one, thus many plugins would
	    show up as updatable in the list. With this key we set a threshold, so
	           by default 1 day difference would mean we are talking about the
		                  same version of the plugin that we have locally.
	

[Configuration]
DatabaseEnabled=False                                            (default : True )
                 You can set this key to "False" in case you'd like to disable the
	         Internal Plugin Database (IPD), which helps the utility to detect
	               the plugins matching online package based on their filename
		                                  (not recommended to turn it off)

UseIniInTCDir=True                                               (default : False)
 Set this to "True" to place the configuration file of utility beside "wincmd.ini"
                 instead of the directory where "TotalUpdater.exe" is running from

SearchEngine=http://google.com/search?q=%s                       (default : <--  )
  You can set it to any string ("%s" will be replaced to the actual search string)
                       to change the default Google search engine to anything else


[OverridePlugVer]
You can find all the plugins marked as latest inside this section (e.g. when the
user choose right click -> "Marked Items" -> "Confirm updatable items as latest").

The structure is the following:
PATH=CRC32(decimal)|version

e.g.:
%COMMANDER_PATH%\plugins\wcx\SomePlugin\filename.wfx=3718047628|1.2.4
 

10. Thanks
__________

For the great Total Commander (ghisler.ch) community for their ideas, bugreports
and contributions. Special thanks goes to Myone (alpha & beta testing, ideas),
and to all of the translators:

 - Chinese    : FeiXJ
 - Czech      : jvh
 - Danish     : petermad
 - Dutch      : Jaap Kramer
 - French     : TieFighter
 - German     : Gerby
 - Italian    : Luciano & Massimo Mula
 - Lithuanian : Dalius Guauskas (Tichij)
 - Polish     : Maciej Bojakowski
 - Nederlands : Jaap Kramer
 - Slovak     : umbra
 - Spanish    : Patxiku
 - Swedish    : Trast
 - Korean     : cmlee
 - Russian    : Dmitriy Vasilyev
 - Ukrainian  : Pavlo Dergunov (LonerD)

Exceptional thanks to Christian Ghisler for creating Total Commander.
... and last, but not least thank you for downloading & using this utility.


11. Copyright notices
_____________________

- Portions of this software are Copyright (c) 1993 - 2003, Chad Z. Hower (Kudzu)
  and the Indy Pit Crew - http://www.IndyProject.org
- RAR Component Copyright (c) by Philippe Wechsler  http://www.PhilippeWechsler.ch
- UnZIP library Copyright (c) 1998 - 2009 Conifer Software - All rights reserved
  (distributed under MPL 1.1 license)


12. WavPack license
___________________

               Copyright (c) 1998 - 2009 Conifer Software
                          All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

    * Redistributions of source code must retain the above copyright notice,
      this list of conditions and the following disclaimer.
    * Redistributions in binary form must reproduce the above copyright notice,
      this list of conditions and the following disclaimer in the
      documentation and/or other materials provided with the distribution.
    * Neither the name of Conifer Software nor the names of its contributors
      may be used to endorse or promote products derived from this software
      without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.



Copyright (C) 2011-2013 Bluestar.