%Extract%    Show Routine Code    Author: Siegfried

Version: 1  -  Date: 2007-02-15

Example call:
%Extract% "wun" "aawsepersonal.exe" "TargetFolderHERE" "InnerFolderHERE" "keep" "CheckFileHERE"

Remarks:
Universal extraction routine for various formats.

Param 1 specifies the extractor:
cab, unzip, 7za, urar, wun, ewise, innounp, isxunpack

If no target folder is given as param 3, target is curr. directory
Param 4 is an inner sub-folder to be removed.
If param 5 is not "keep", the compressed file will be deleted after extraction.
The check file in param 6 is a file that must exist in the target
folder after successful extraction.
This is only required for auto-detection of the right extractor.
If no extractor is specified, all extractors will be tried until success.
The successful extractor is then stored in FUNCs\EXTRACT.ini
and used in that plugin in the future for that file.

NOTE: param 1 is only needed for the extraction of setup-EXEs.
For zip, rar etc. it is derived from the file extension.

If the DWLD routine was called right before %Extract%, the file to be extracted
is already specified there and the setting is used in %Extract%. Param 2 may be empty then.

The xDWLD routine automatically calls %Extract% and will give normally results with
only minimal settings.

Use the "%Exclude% - %ButKeep%" feature to cleanUp the target folder:
set Exclude=Lang\*.awl,
set ButKeep=Lang\%LANG%.awl,
%Extract% "wun" "pllangs.exe" "Files" "" "keep" ""

This will only keep "Files\Lang\german.awl" on a german system.
The Exclude/ButKeep feature provides a simple way to remove any unwanted files from the target folder.
Specify any number of exclusions delimited by comma ",".
%ButKeep% can only be used together with %Exclude%. It is used to define one or several exceptions for a bulk-exclusion. A typical usage is in the context of language files cleanup.

The Exclude/ButKeep feature is available for the following routines:
%GetFolder%, %xDWLD% and %Extract%