things Files

UTF-8	README@AZ.TXT : general information of @ARCHIVER
T Ç12	============= ┬ª+23-03-15 | subdocument = REVISION@AZ.TXT
¯ ¯¯¯\ PDF-formatter : UTF-8 text as Tabloid, font = "Consolas" on size 12   ____
  ____ ¯¯¯           + '┬ª' = "anno domini" of the date by '¦'(0166)-char on ECHO
• SITE = https://sourceforge.net/projects/a-things
- root of the subsites
* HOME = SITE/files : https://sourceforge.net/projects/a-things/files
= download site  ____________
* FE_W = %windir%\explorer.exe : file explorer of OS_W
- OS_W = OS_W<7..10> : any of OS Windows® <...>
* PROJECTS = HOME/Projects : subsite of the projects
+ AZ_SITE = PROJECTS/@Archiver : zip-files of the project
- AZ_ZIP = "@Archiver{7z}+Files.zip" : "@Archiver_7z_+Files.zip" opened directly by FE_W
# AZ_7Z  =  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯.7z opened by 7zFM.exe of 7-Zip removed. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
= console interface of 7-Zip : 7Z.EXE = command line version
  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯            ¯¯¯¯¯¯\ 7-zip_site = https://www.7-zip.org
* 7-zip_site(2) ..
• http://7-zip.org/a/7z1801-x64.exe : installers ..
• http://7-zip.org/a/7z1801-x64.msi                  ____
+ documents of AZ_<ZIP,7Z> in @AZ+Docs.zip opened by FE_W
  ___________   7-Zip /¯¯ *.7z are opened by 7zFM.exe
* description of @ARCHIVER ..                ¯¯¯¯¯¯¯¯
- general format of abbreviated scripts( subroutines of @ARCHIVER )
   __________ _ _ _/¯¯¯¯¯¯¯¯¯¯¯\ _ __________
§ <SUBROUTINE>_CMD = @Archiver{7z-<Subroutine>}.cmd
+ e.g. HATS_CMD = @Archiver{7z-Hats}.cmd : overlined or underlined ascii text
   ________/ = $ARCHIVER in the documents
* _ARCHIVER_ = @Archiver{7z} : symbol of the file name
+ @ARCHIVER = %AZ-PATH%\@Archiver{7z}.cmd
~ §AZ=%@ARCHIVER% ::! §IENV        ___
* @ARCHIVER+ = %AZ-PATH%\@Archiver{zip}.cmd as caller of %§AZ%
+ ___          ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
~ §Z+=%@ARCHIVER+% ::! §IENV
- ZIP_OPT of %7Z% is set by %§Z+% on call of %§AZ%
* FE_LIST = the file list window of FE_W
+ NOTE : Click of a script within FE_LIST should not cause a harm,
uninitialized variables not exist until defined causing that a subroutine
will automatically stop by the checks of OS . Non-existent parameters to 7ZIP
return an error code except the default info that shows options for the commands.
  ___________           _________________________   ___________
- 7z-Info.txt : default info of 7ZIP made by link = 7z-Info.lnk,
  command line of the file : "%ComSpec% /K 7Z-PATH\7Z.EXE > 7z-Info.txt"
  ¯¯¯¯¯¯¯¯¯¯¯¯\ in 7z-Info.lnk, 7Z-PATH = installation folder of 7-Zip.
                   ¯¯¯¯¯¯¯¯¯¯¯  ¯¯¯¯¯¯¯   ¯¯¯¯¯¯¯¯¯¯¯¯¯          ¯¯¯¯¯
+ click of @ARCHIVER in a disk shows the quick info and opens
  the help file of 7-Zip.

~ THE_DATE=%THE+DATE%	::! latter as version defined in CAPTION_CMD of @ARCHIVER
- THE_DATE_ is defined in the callers( @Archiver{<zip,utf-8.utf-16>}.cmd )
  ¯¯¯¯¯¯¯¯¯¯¯¯ shown at exit of the script with the message of %ComSpec%

~ ZIP_NAME=@Archiver	::! prefix of the file name
~ ZIP_ID=7z		::! {substring} ...
~ ZIP_VER=1.1		::! optional associated to THE_DATE
  __________
~ _ARCHIVER_=%~n0	::! of @ARCHIVER, file name without extension(*.???)
~ @ARCHIVER=%_ARCHIVER_%.cmd	::! console interface of 7ZIP
~ §AZ=AZ-PATH\%@ARCHIVER%	::! %0 as @ARCHIVER with full path
- AZ-PATH = installation of @ARCHIVER
+ __________ @Archiver{zip}
~ _ARCHIVER+=%~n0	::! as @ARCHIVER+, caller of @ARCHIVER
~ §Z+=AZ-PATH\%~nx	::! %~dpnx as ..._/¯¯¯¯¯¯
~ ZIP+ID=zip		::! of _ARCHIVER+.cmd
  ________
~ ARCHIVER=7z.exe	::! command line version of 7-Zip
* 7Z-PATH = path of installed 7-Zip
~ §7Z=7Z-PATH\7z.exe ::! ARCHIVER with full path in §IENV
- 7ZIP = %§7Z% in the documents
  _________
+ documents ..
* @AZ_PDF = %_ARCHIVER_%.pdf : document of @ARCHIVER
* @AZ_PROLOG = "%_ARCHIVER_% Prolog.pdf" : introduction of @AZ_PDF
  ___________
* CAPTION_CMD = @Archiver{7z-Caption}.cmd
- date and caption of CON
~ THE*DATE_=*<dd.mm.yyyy> ::! fragmented format
~ THE+DATE_=+<yyyy-mm-dd> ::! growing format
~ THE<*,+>DATE=%THE<..>DATE_% 
+ derived ~ THE_DATE=%THE+DATE%
  ________
* INIT_CMD = @Archiver{7z-Init}.cmd ..
- ZIP_WEBSITE = https://www.7-zip.org : download site of 7ZIP
- ZIP_HELP = 7Z-PATH\7-zip.chm : 7CHM in the documents
  _________
* FLAGS_CMD = @Archiver{7z-Flags}.cmd ..
• user defined settings for enable or disable navigation to the sites
  defined in THEMES_CMD = @Archiver{7z-Themes}.cmd :
* at the end of file:
~/A zipfTheme_=zipfTheme<Off,On> ::! navigation enabled by zipfThemeOn
- zipfTheme_ = default value( 0 or 1 ) of the used zipfTheme flag
  ¯¯¯¯¯¯¯¯¯¯   ¯¯¯¯¯¯¯        ¯    ¯          ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
+ navigation according to the result of 7ZIP :
- code of 7ZIP	site to navigate on _TRUE_(1) of zipfTheme
  ------------	---------------- in THEMES_CMD = @Archiver{7z-Themes}.cmd
. 0 : ok 	THEME_SITE          ¯¯¯¯¯¯¯¯¯¯   ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
. 1 : warn	WARN_THEMESITE  : operation completed with a warning
. 2 : fatal	FATAL_THEMESITE : fatal error of 7ZIP on <compress(&)extract>
# 3 : error	ERROR_THEMESITE : fatal code(#) of @ARCHIVER on extract( clarified )
#13 : code for test, finally not used in @ARCHIVER
+ other codes handled as fatal = 2
* optional cases for M of [H,Y,M,N]? on PROMPT
- ZIP_THEMESITE : default on OK
- HYMN_THEMESITE : background theme for selection of the list
- CUSTOM_THEME : a list of music ..
  https://www.youtube.com/playlist?list=PLx1cCSsTo_XaYHFIKhc2cIlbfacwe1gjP"
= about same as the list of @Themes.html in the HOME site.
+ FUN_THEMESITE : set something comfortable to yourself !
  ________
§ settings for copying the <filelist>.afl cleaned from the input <filelist>.7zl( %3 )
  to usable @<filelist>.pfl of 7-zip : control flag = zipfPure ..                   _________ by xcopy of OS
. set /A zipfPure=_TRUE_  ::! default state as confirmed copy using the user prompt( Y / N ? )    _______
. REM /A zipfPure=_FALSE_ ::! prompt for copying the file will not shown before the final prompt [H,Y,M,N] ?
. i.e. the shown <filelist>.afl before the final prompt not copied to <filelist>.pfl on _FALSE_ of zipfPure .
  ___________________
• @Archiver{7z}+Files.zip : archive(%2) of @ARCHIVER
- @Archiver{7z} Prolog.pdf : @AZ_PROLOG = introduction of @AZ_PDF
- @Archiver{7z}.pdf : @AZ_PDF = help of @ARCHIVER
+ @Archiver{7z}+Files.afl = cleaned ~.7zl of ~.zip
  _________
• @AZ-Links.zip : test commands of @ARCHIVER by the link files
- %1 = %_AZS_% of @ARCHIVER in the command lines,
  1'st character of %_AZS_% = selector(<a,u,x,e,t,l,h,d,b>) of 7ZIP
- default %2 = @Archiver{7z}+Files.zip for ... /¯¯¯¯¯¯¯¯¯
§ subfolder D:\Programs\§Archiver\ of ~.zip as such like a portable installation
            ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ in computers
+ command lines must be modified according to installation of @ARCHIVER:
~ AZ-PATH=<path> ::! of @ARCHIVER in §IENV = initial environment assigned by the system dialog
~ §AZ="%AZ-PATH%\@Archiver{7z}.cmd" ::! %§AZ% in the command line of a link
+ @AZ-Command_Lines.txt : Command lines of the link files according to installation

* §Zip~Files.zip : 3 versions in the package as simplified @ARCHIVER
  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯ = <@,$,€>±Zip~Files.zip ...  _/¯¯¯¯¯¯¯¯¯¯
  _______________ in the decreased order ..
• @±Zip~Files.zip : @Zip.cmd with the subroutines
= compact @ARCHIVER without the additional feature( Music ).
  ______________
• $±Zip~Files.zip : $Zip.cmd with the subroutines(2) $<Add(&)Clean>.cmd
= simplified @Zip.cmd, can be used without the subroutines if zipfInclude = _FALSE_    _____
+ NOTE : §Zip~Files.zip = _Zip_Files.zip in the site due to the upload problem !   __ <€,@,$>±Zip~Files.zip 
  ______________	  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯\ all 3 variants of %§AZ% = <€,@,$>Zip.cmd by one package
• €±Zip~Files.zip : €Zip.cmd = console interface by the single script
- nested sublists not allowed, shared file $0.byte of $Zip.cmd for cleanup.
  ___________________
• $Zip_TEST~Files.zip : test using the modified copy of $Zip.cmd
§ command line(•) is a test of recursive inclusion of a subfile(-.asl) of the input(%3) ~.7zl list.
• %ComSpec% /K J:\$Zip\$Zip_TEST.cmd u "J:\$TEST\$Zip~Files+recursively.zip" "J:\$TEST\$Zip~Files+recursively.7zl"
="$Zip_TEST~Files+recursively.lnk" of the script = J:\$Zip\$Zip_TEST.cmd : OS_W breaks the "infinite" loop safely.
+ additional information in $Zip_README.txt of the package, the test has been performed in a memory stick (J:).
  Message of CON at the break point exists in the text file = "$Zip_TEST~Files+recursively~J.echo".
  _______
§ AZ_PATH\SHA1.zip ..		   _______________     _     ___
  ____       ________      _______/ output file(%2) = '?' if not used.
* SHA1.cmd : checksum of a file(%1)       _________________
- the value shown in the screen should be same as the value
  shown by the (i) button of each file in the download site.
+ SHA1.zip : the script and the link files for checksum
  ________
¤ Revision history of the updated files in REVISION@AZ.TXT
        __________________ using a fixed width font( Ç12 )
.TXT : "square-ruled paper" - text file.             ¯¯¯