Release note of version 1.3.1.9

README.md

@@ -1,73 +1,103 @@
 # MultiPar
 
-v1.3.1.7 is public
+v1.3.1.9 is public
 
- This is minor update version. 
-I changed some for new environments, Windows 10 and Visual Studio 2019. 
-If there is no serious problem, next version will be the last of v1.3.1 tree. 
+  This is the final release of v1.3.1 tree. 
+There would be no serious problem. 
+While I fixed some rare bugs and improved a bit, it's hard to test all possible cases. 
 When you see a bug, odd incident, or strange behavior, please let me know. 
-I will fix before releasing a stable version. 
+I will fix as possible as I can.
 
- Because Visual Studio 2019 supports new CPUs, I removed some obsolate code. 
-It doesn't require par2j_extra.dll or par2j64_extra.dll to use AVX2 feature. 
-It may not require extra memory barrier (_mm_sfence) for multi-threading. 
-But, I'm not sure about the memory barrier. 
-Visual Studio 2008 required them to support new age multi-core CPUs. 
-I think that Visual Studio 2019 should treat those recent CPUs well. 
-Though I tested with Intel i5 CPU on my PC, I don't know other CPUs. 
-If you see "chacksum mismatch" error, please report the incident. 
+  I tested verification of multiple source files on my new PC. 
+From the result, I set max number of threads for NVMe SSD to 4 threads, 
+when CPU has 6 or more logical cores. 
+This will improve speed at verifying complete source files. 
+(It doesn't affect for PAR files nor damaged files.)  
+SATA SSD : It will verify max 2 files at once.  
+NVMe SSD : It will verify max 3 or 4 files at once.
+
+  When many input file slices are same, their checksums become same, too. 
+There was a bug in my sorting function. 
+Nobody found the error for over than 10 years, and I solved this problem at last. 
+Thanks [NilEinne](https://github.com/Yutaka-Sawada/MultiPar/issues/36) for reporting the very rare incident.
+
+  When a file includes duplicated data, it's difficult to find slices in proper position. 
+In old versions, it might ignore overlap of slices for speed. 
+Then, it happend to fail finding some slices. 
+I implemented more complex method, and it will work well in most cases. 
+Thanks [swarup459](https://github.com/Yutaka-Sawada/MultiPar/issues/42) for bug report, offering samples, and many tests.
+
+  It's possible to add PAR2 recovery record to a ZIP file. 
+When I wrote the instructions ago, 4 GB over ZIP file was not common so much. 
+Because recent Windows OS supports ZIP64 format, I updated the text for compatibility. 
+You may read the "Add recovery record" page of MultiPar's Help documents. 
+Or, you may read [the article on my web-site](http://hp.vector.co.jp/authors/VA021385/record.htm). 
+Now, MultiPar supports large ZIP file with ZIP64 format. 
+Thanks [Dwaine Gonyier](https://github.com/Yutaka-Sawada/MultiPar/issues/44) for noticing the potential problem.
 
 
-[ Changes from 1.3.1.6 to 1.3.1.7 ]  
+[ Changes from 1.3.1.8 to 1.3.1.9 ]  
+
+Installer update  
+- Inno Setup was updated from v6.1.2 to v6.2.0.  
 
 GUI update  
 - Change  
-  - Help documents are not compiled, but consist of plain html files.  
-  - More large icons are added for High DPI.  
-  - The installer will send MultiPar.ini to the recycle bin at uninstallation.  
+  - Clickable link to access author's page becomes SSL.  
+  - Appending recovery record supports 2 GB over file size.  
 
-PAR2 client update  
+PAR2 clients update  
 - Change  
-  - AVX2 feature is implemented internally.  
-  - Additional memory barrier is removed.  
+  - When source files are on NVMe SSD, verification may become faster.  
+  - Appending recovery record supports ZIP64 format.  
+
+- Improvement  
+  - Simple verification will find a short slice in a tiny file.  
+
+- Bug fix  
+  - A stack overflow problem in quick sort function was removed.  
+  - A bug of searching slices in a file with repeated content was fixed.  
 
 
 [ Hash value ]  
 
-MultiPar1317.zip  
-MD5: DFC81D79AA0EBF27DA8945C1EECB2019  
-SHA1: AAED4AEF23A8C9643032A3E8D5B652C52AF081C4  
+MultiPar131.zip  
+MD5: EF3486BB39724EF6A4109F5B02D4E027  
+SHA1: D935BFAFF5156C9460FB45639271339D1068F522  
 
-MultiPar1317_setup.exe  
-MD5: 16BC2DF7DF0033EDADF39D6D9F3BD2FE  
-SHA1: FFAA6C11912164F2A8C0305DE6231B7DFD409E56  
+MultiPar131_setup.exe  
+MD5: E2F6EF68AEB9BE0CCDD4D5ABF2A3F318  
+SHA1: C2615960B9B28223BC174FC1175CAAECCC8A713A  
+  To install under "Program Files" or "Program Files (x86)" directory, 
+you must start the installer with administrative privileges by selecting 
+"Run as administrator" on right-click menu.  
 
 
 [ Hash value of other source code packages ]  
- Old versions and source code packages are available at 
+  Old versions and source code packages are available at 
 [GitHub](https://github.com/Yutaka-Sawada/MultiPar/releases) or 
 [OneDrive](https://1drv.ms/u/s!AtGhNMUyvbWOaSo1n_R8awJ_hg0?e=4V0gXu).  
 
-MultiPar_par2j_1317.7z  
-MD5: B46EDD4E3789E65712D50E6B59E355FB  
-SHA1: D951E582EC2B7B6BA6947AA95F4176D816A18044  
+MultiPar_par2j_1319.7z  
+MD5: 9AC4C38762E2DBF64D6D3A738CD7CCD6  
+SHA1: FFC0DA1A0BBCAD08489C5499154DAA0216E10F51  
 
-MultiPar_par1j_1314.7z  
-MD5: E082D8A598A262E64CBAE2C42283488A  
-SHA1: F706A3C1FCCAFCE225677BA0785CDB39870206A1  
+MultiPar_par1j_1318.7z  
+MD5: F66285403BA0AD856BA6A8CCD922EBF5  
+SHA1: 4CF5D819B16E60F1BBD82415D5F68CB46D3F53C3  
 
-MultiPar_sfv_md5_1314.7z  
-MD5: 355B0CC6B9613B422126EF9EDAC15F87  
-SHA1: EFD2CF25C47851B86EB12FD5B709BFEEC73AC36D  
+MultiPar_sfv_md5_1318.7z  
+MD5: 4E6433808625C088E2773C961BBEBBD2  
+SHA1: 68B54D178BA58637F63CC3E0CC656C96D4472A33  
 
-MultiPar_ShlExt_1298.7z  
-MD5: BE0F04DF1A6B936F23F6F01930562248  
-SHA1: 52818266B45ECE135EECFF12D8DA2640A6AD5075  
+MultiPar_ShlExt_1318.7z  
+MD5: 57E79698A53458681CD19842391A202F  
+SHA1: 646145F1B429C1CF592F907614889C98FBE7E756  
 
-MultiPar_ResUI_1315.7z  
-MD5: B8B6A9DA4BD9D418CFA90FD01CCC615A  
-SHA1: E5B4B16DBCAECACA2095A64006C117E04D3C9E74  
+MultiPar_ResUI_1319.7z  
+MD5: E03B90A433466C945D726B5A49B4E547  
+SHA1: E30FB11B8F121D44CC1CC368E8D91F06CFC15551  
 
-MultiPar_Help_1316.7z  
-MD5: 0021DB7D2CA3B75912267E6D5DA70A3D  
-SHA1: AC436E130A112A58C60EA49ED8DCF9E2E19AACC3  
+MultiPar_Help_1319.7z  
+MD5: 37547FA074DC24491D1696F6F0DB7452  
+SHA1: 8069C5745F9C7660236F17E3E087B4F7324382ED