dragonleo/NSIS
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

typo fix backported from 3.2

Browse source 
git-svn-id: https://svn.code.sf.net/p/nsis/code/NSIS/trunk@5625 212acab6-be3b-0410-9dea-997c60f758d6
This commit is contained in:
kichik 2008-05-02 20:14:39 +00:00
parent bfe7fef294
commit 32f97201db
1 changed files with 333 additions and 333 deletions
Download patch file Download diff file Expand all files Collapse all files

666
Contrib/VPatch/Readme.html
View file

@ -1,341 +1,341 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"> <html xmlns="http://www.w3.org/1999/xhtml">
<head> <head>
<title>VPatch 3</title> <title>VPatch 3</title>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
<style type="text/css"> <style type="text/css">
/*<![CDATA[*/ /*<![CDATA[*/
body body
{ {
padding: 10px; padding: 10px;
background-color: #F0F0F0; background-color: #F0F0F0;
font-family: Verdana, Arial, Helvetica, sans-serif; font-family: Verdana, Arial, Helvetica, sans-serif;
font-size: 13px; font-size: 13px;
font-weight: normal; font-weight: normal;
text-align: left; text-align: left;
} }
p, li p, li
{ {
font-size: 13px; font-size: 13px;
} }
.center .center
{ {
text-align: center; text-align: center;
} }
table table
{ {
margin: auto; margin: auto;
font-size: 13px; font-size: 13px;
background-color: #FFFFFF; background-color: #FFFFFF;
} }
.maintable .maintable
{ {
border: 2px solid #376EAB; border: 2px solid #376EAB;
} }
.parameter .parameter
{ {
font-weight: bold; font-weight: bold;
color: #6586AC; color: #6586AC;
} }
h1 h1
{ {
font-size: 30px; font-size: 30px;
color: #333333; color: #333333;
font-weight: normal; font-weight: normal;
text-align: center; text-align: center;
margin-top: 20px; margin-top: 20px;
} }
h2 h2
{ {
font-size: 20px; font-size: 20px;
color: #7A7272; color: #7A7272;
font-weight: normal; font-weight: normal;
} }
h3 h3
{ {
font-size: 17px; font-size: 17px;
font-weight: bold; font-weight: bold;
color: #303030; color: #303030;
} }
pre { pre {
font-size: 13px; font-size: 13px;
} }
div div
{ {
margin: 20px; margin: 20px;
} }
a:link, a:visited, a:active a:link, a:visited, a:active
{ {
color: #294F75; color: #294F75;
text-decoration: none; text-decoration: none;
} }
a:hover a:hover
{ {
color: #182634; color: #182634;
text-decoration: underline; text-decoration: underline;
} }
/*]]>*/ /*]]>*/
</style> </style>
</head> </head>
<body> <body>
<table width="750" class="maintable" cellspacing="0" cellpadding="0" align="center"> <table width="750" class="maintable" cellspacing="0" cellpadding="0" align="center">
<tr> <tr>
<td> <td>
<h1>VPatch 3.1</h1> <h1>VPatch 3.1</h1>
<div> <div>
<h2>Introduction</h2> <h2>Introduction</h2>
<div> <div>
<p>VPatch allows to create a patch file to update previous versions <p>VPatch allows to create a patch file to update previous versions
of your software. The GenPat utility generates the patch file. The of your software. The GenPat utility generates the patch file. The
plug-in can use the patch to update a file. Using a patch, you can plug-in can use the patch to update a file. Using a patch, you can
reduce the download size of your updates, because only the differences reduce the download size of your updates, because only the differences
between the files are included in the patch file.</p> between the files are included in the patch file.</p>
</div> </div>
<h2>How to use</h2> <h2>How to use</h2>
<div> <div>
<h3>Generate the patch file</h3> <h3>Generate the patch file</h3>
<div> <div>
<p>Make sure you have the source file (original version) and the target <p>Make sure you have the source file (original version) and the target
file (version to update to). For example, DATA.DTA (currently on user file (version to update to). For example, DATA.DTA (currently on user
system) and DATA_20.DTA (version 2.0 of this data file). Now call system) and DATA_20.DTA (version 2.0 of this data file). Now call
the command line tool GenPat.exe:</p> the command line tool GenPat.exe:</p>
<pre> <pre>
GENPAT oldfile.txt newfile.txt patch.pat GENPAT oldfile.txt newfile.txt patch.pat
</pre> </pre>
<p>Now, the patch will be generated, this will take some time.</p> <p>Now, the patch will be generated, this will take some time.</p>
<p>Using the /B=(BlockSize) parameter of the GenPat utility (put it <p>Using the /B=(BlockSize) parameter of the GenPat utility (put it
after the filenames), you can use a different block size. A smaller after the filenames), you can use a different block size. A smaller
block size may result in a smaller patch, but the generation will block size may result in a smaller patch, but the generation will
take more time (the default blocksize is 64).</p> take more time (the default blocksize is 64).</p>
<p>If you have trouble using this command-line utility, you can download <p>If you have trouble using this command-line utility, you can download
a GUI (graphical user interface) for VPatch from its own website: a GUI (graphical user interface) for VPatch from its own website:
<a href="http://www.tibed.net/vpatch">http://www.tibed.net/vpatch</a>.</p> <a href="http://www.tibed.net/vpatch">http://www.tibed.net/vpatch</a>.</p>
</div> </div>
<h3>Update the file during installation</h3> <h3>Update the file during installation</h3>
<div> <div>
<p>Use the VPatch plug-in to update a file using a patch file:</p> <p>Use the VPatch plug-in to update a file using a patch file:</p>
<pre> <pre>
vpatch::vpatchfile "patch.pat" "oldfile.txt" "temporary_newfile.txt" vpatch::vpatchfile "patch.pat" "oldfile.txt" "temporary_newfile.txt"
</pre> </pre>
<p>The result of the patch operating will be added to the stack and <p>The result of the patch operating will be added to the stack and
can be one of the following texts:</p> can be one of the following texts:</p>
<ul> <ul>
<li>OK</li> <li>OK</li>
<li>OK, new version already installed</li> <li>OK, new version already installed</li>
<li>An error occurred while patching</li> <li>An error occurred while patching</li>
<li>Patch data is invalid or corrupt</li> <li>Patch data is invalid or corrupt</li>
<li>No suitable patches were found</li> <li>No suitable patches were found</li>
</ul> </ul>
<p>Check <a href="../../Examples/VPatch/example.nsi">example.nsi</a> for an example. You <p>Check <a href="../../Examples/VPatch/example.nsi">example.nsi</a> for an example. You
should check whether the stack string starts with &quot;OK&quot; should check whether the stack string starts with &quot;OK&quot;
because then the patch has succeeded and you can rename &quot;temporary_newfile.txt&quot; because then the patch has succeeded and you can rename &quot;temporary_newfile.txt&quot;
to &quot;oldfile.txt&quot; to replace the original, if you want.</p> to &quot;oldfile.txt&quot; to replace the original, if you want.</p>
</div> </div>
<h3>Multiple patches in one file</h3> <h3>Multiple patches in one file</h3>
<div> <div>
<p>GenPat appends a patch to the file you specified. If there is already <p>GenPat appends a patch to the file you specified. If there is already
a patch for the same original file, with the same CRC, in the patch file, a patch for the same original file, with the same CRC/MD5, in the patch file,
the patch will be replaced. For example, if you want to be able to upgrade the patch will be replaced. For example, if you want to be able to upgrade
version 1 and 2 to version 3, you can put a 1 &gt; 3 and 2 &gt; 3 patch in version 1 and 2 to version 3, you can put a 1 &gt; 3 and 2 &gt; 3 patch in
one file.</p> one file.</p>
<p>You can also put patches for different files in one patch file, for <p>You can also put patches for different files in one patch file, for
example, a patch from file A version 1 to file A version 2 and a patch example, a patch from file A version 1 to file A version 2 and a patch
from file B version 1 to file B version 2. Just call the plug-in multiple from file B version 1 to file B version 2. Just call the plug-in multiple
times with the same patch file. It will automatically select the right times with the same patch file. It will automatically select the right
patch (based on the file CRC).</p> patch (based on the file CRC).</p>
</div> </div>
<h3>Patch generator (GenPat) exit codes</h3> <h3>Patch generator (GenPat) exit codes</h3>
<div> <div>
<p>In version 3 the following exit codes (known as error levels in <p>In version 3 the following exit codes (known as error levels in
the DOS period) can be returned by GenPat. GenPat will return an the DOS period) can be returned by GenPat. GenPat will return an
exit code based on success of the patch generation. Here is a list exit code based on success of the patch generation. Here is a list
of the possible exit codes:</p> of the possible exit codes:</p>
<table width="547" border="0" cellspacing="0" cellpadding="0"> <table width="547" border="0" cellspacing="0" cellpadding="0">
<tr> <tr>
<td><b>Exit code</b></td> <td><b>Exit code</b></td>
<td><b>Description</b></td> <td><b>Description</b></td>
</tr> </tr>
<tr> <tr>
<td>0</td> <td>0</td>
<td>Success</td> <td>Success</td>
</tr> </tr>
<tr> <tr>
<td>1</td> <td>1</td>
<td>Arguments missing</td> <td>Arguments missing</td>
</tr> </tr>
<tr> <tr>
<td>2</td> <td>2</td>
<td>Other error</td> <td>Other error</td>
</tr> </tr>
<tr> <tr>
<td>3</td> <td>3</td>
<td>Source file already has a patch in specified patch file (ERROR), <td>Source file already has a patch in specified patch file (ERROR),
use /R switch to override</td> use /R switch to override</td>
</tr> </tr>
</table> </table>
<p>These exit codes can be useful when you generate patch files through <p>These exit codes can be useful when you generate patch files through
a NSIS script.</p> a NSIS script.</p>
</div> </div>
</div> </div>
</div> </div>
<div> <div>
<h2>Source code</h2> <h2>Source code</h2>
<div> <div>
<p>Source code is available in the original package and in the SVN repository of NSIS.</p> <p>Source code is available in the original package and in the SVN repository of NSIS.</p>
<h3>NSIS plug-in (C++)</h3> <h3>NSIS plug-in (C++)</h3>
<div> <div>
<p>The source of the NSIS plug-in that applies patches can be found <p>The source of the NSIS plug-in that applies patches can be found
in the Source\Plugin folder.</p> in the Source\Plugin folder.</p>
</div> </div>
<h3>Patch Generator (C++)</h3> <h3>Patch Generator (C++)</h3>
<div> <div>
<p>The most interesting part of VPatch, the actual patch generation <p>The most interesting part of VPatch, the actual patch generation
algorithm, can be found in Source\GenPat\PatchGenerator.cpp. The algorithm, can be found in Source\GenPat\PatchGenerator.cpp. The
header of that file contains a brief explanation of the algorithm header of that file contains a brief explanation of the algorithm
as well.</p> as well.</p>
</div> </div>
<h3>User interface (Delphi)</h3> <h3>User interface (Delphi)</h3>
<div> <div>
<p>A user interface is included as well, which you will have to build <p>A user interface is included as well, which you will have to build
yourself because the GUI executable was too large to include. Besides yourself because the GUI executable was too large to include. Besides
Borland Delphi 6 or higher (you can use the freely available Personal Borland Delphi 6 or higher (you can use the freely available Personal
edition), you will also need to install the <a href= edition), you will also need to install the <a href=
"http://www.delphi-gems.com">VirtualTreeView</a> component by Mike Lischke.</p> "http://www.delphi-gems.com">VirtualTreeView</a> component by Mike Lischke.</p>
</div> </div>
<h3>Test framework (Python)</h3> <h3>Test framework (Python)</h3>
<div> <div>
<p>Run the <i>VPatch_tests.py</i> script (if you have <a href="http://www.python.org">Python</a> <p>Run the <i>VPatch_tests.py</i> script (if you have <a href="http://www.python.org">Python</a>
installed) to perform basic functionality tests on VPatch. The <i>testExtended</i> installed) to perform basic functionality tests on VPatch. The <i>testExtended</i>
test is known to fail if a set of big test files is not installed, test is known to fail if a set of big test files is not installed,
you can safely ignore this.</p> you can safely ignore this.</p>
</div> </div>
</div> </div>
<h2>Version history</h2> <h2>Version history</h2>
<div> <div>
<ul> <ul>
<li>3.1 <li>3.1
<ul> <ul>
<li>GenPat now compiles on POSIX platforms (MinGW/GCC), Visual <li>GenPat now compiles on POSIX platforms (MinGW/GCC), Visual
C++ 6 and Borland C++.</li> C++ 6 and Borland C++.</li>
<li>More test cases to verify functionality of GenPat.</li> <li>More test cases to verify functionality of GenPat.</li>
</ul> </ul>
</li> </li>
<li>3.0 <li>3.0
<ul> <ul>
<li><b>Final</b>: Updates to the GUI, installer</li> <li><b>Final</b>: Updates to the GUI, installer</li>
<li><b>RC8</b>: GenPat will now flag replacement of a patch (e.g. <li><b>RC8</b>: GenPat will now flag replacement of a patch (e.g.
the source file has the same contents as a previous patch inside the source file has the same contents as a previous patch inside
a patch file) as an error. You can specifically allow it using a patch file) as an error. You can specifically allow it using
the /R switch. Added license to source files.</li> the /R switch. Added license to source files.</li>
<li><b>RC7</b>: Fixed critical bug in GenPat with multiple patches <li><b>RC7</b>: Fixed critical bug in GenPat with multiple patches
in a single file. Fixed serious bug in stand-alone EXE runtime: in a single file. Fixed serious bug in stand-alone EXE runtime:
process kept on running forever. Included case testing through process kept on running forever. Included case testing through
a Python script to test common usage (and prevent bugs like a Python script to test common usage (and prevent bugs like
the one in GenPat in the future).</li> the one in GenPat in the future).</li>
<li><b>RC6</b>: Upgraded to non-beta compiler. Added /A switch <li><b>RC6</b>: Upgraded to non-beta compiler. Added /A switch
to change block match limit and /O to deactivate the limit. to change block match limit and /O to deactivate the limit.
Updated GUI to support the /O switch.</li> Updated GUI to support the /O switch.</li>
<li><b>RC4a to RC5a</b>: input block size is now checked for power <li><b>RC4a to RC5a</b>: input block size is now checked for power
of 2 and fixed if incorrect. When patch file does not yet exist, of 2 and fixed if incorrect. When patch file does not yet exist,
no longer forgets to create the header. No longer tries to allocate no longer forgets to create the header. No longer tries to allocate
memory when there are no chunks. Fixed memory leaks.</li> memory when there are no chunks. Fixed memory leaks.</li>
<li>Target file date is now preserved inside a patch and restored <li>Target file date is now preserved inside a patch and restored
on the user system.</li> on the user system.</li>
<li>MD5 checksums are now used instead of CRC32 checksums, unless <li>MD5 checksums are now used instead of CRC32 checksums, unless
existing patches in a file already are in CRC32 mode.</li> existing patches in a file already are in CRC32 mode.</li>
<li>The patch generator, GenPat, has been completely rewritten <li>The patch generator, GenPat, has been completely rewritten
in C++. It no longer needs to keep the entire files in memory, in C++. It no longer needs to keep the entire files in memory,
instead memory usage is a certain percentage of the source file instead memory usage is a certain percentage of the source file
size. The percentage is based on the block size, larger block size. The percentage is based on the block size, larger block
sizes will reduce memory usage.</li> sizes will reduce memory usage.</li>
<li>All runtimes now share a common codebase, perform proper error <li>All runtimes now share a common codebase, perform proper error
checking and don't leave behind files if the input file was checking and don't leave behind files if the input file was
already up to date.</li> already up to date.</li>
<li>Bug Fix: The patch generator algorithm no longer reduces to <li>Bug Fix: The patch generator algorithm no longer reduces to
a quadratic runtime if there are many blocks with the same content a quadratic runtime if there are many blocks with the same content
in the files to patch.</li> in the files to patch.</li>
<li>Bug Fix: The documentation of the command-line utilities was <li>Bug Fix: The documentation of the command-line utilities was
incorrect and no warnings would be given by the runtimes, causing incorrect and no warnings would be given by the runtimes, causing
the patch not to work (this does not apply to NSIS patches).</li> the patch not to work (this does not apply to NSIS patches).</li>
</ul> </ul>
</li> </li>
<li>2.1 <li>2.1
<ul> <ul>
<li>Added argument checking and error handling to GenPat. Now <li>Added argument checking and error handling to GenPat. Now
returns exit codes as well to indicate success/failure (and returns exit codes as well to indicate success/failure (and
the reason for failure). Only GenPat has changed in this version the reason for failure). Only GenPat has changed in this version
compared to 2.0 final.</li> compared to 2.0 final.</li>
<li>Bug Fix: GenPat no longer gives an Access Violation when attempting <li>Bug Fix: GenPat no longer gives an Access Violation when attempting
to patch a file smaller than 64 bytes into a file larger than to patch a file smaller than 64 bytes into a file larger than
64 bytes.</li> 64 bytes.</li>
</ul> </ul>
</li> </li>
<li>2.0 final <li>2.0 final
<ul> <ul>
<li>Cleaned up source code for the patch generator, which is now <li>Cleaned up source code for the patch generator, which is now
included (this code is written in Borland Delphi 6 and compiles included (this code is written in Borland Delphi 6 and compiles
with the freely available Personal edition).</li> with the freely available Personal edition).</li>
</ul> </ul>
</li> </li>
<li>2.0 beta 2 <li>2.0 beta 2
<ul> <ul>
<li>All new algorithm used in the patch generator: much faster <li>All new algorithm used in the patch generator: much faster
(up to 90%) while using smaller block sizes (higher compression)</li> (up to 90%) while using smaller block sizes (higher compression)</li>
<li>Created a NSIS 2 plugin</li> <li>Created a NSIS 2 plugin</li>
<li>Works with small files</li> <li>Works with small files</li>
<li>Replaces existing patch in file if original file CRC is identical</li> <li>Replaces existing patch in file if original file CRC is identical</li>
</ul> </ul>
</li> </li>
</ul> </ul>
</div> </div>
<h2>Credits</h2> <h2>Credits</h2>
<div> <div>
<p>Written by Koen van de Sande<br /> <p>Written by Koen van de Sande<br />
C plug-in initially by Edgewize, updated by Koen van de Sande<br /> C plug-in initially by Edgewize, updated by Koen van de Sande<br />
New documentation and example by Joost Verburg and Koen van de Sande</p> New documentation and example by Joost Verburg and Koen van de Sande</p>
</div> </div>
<h2>License</h2> <h2>License</h2>
<div> <div>
<pre> <pre>
Copyright (C) 2001-2005 Koen van de Sande / Van de Sande Productions Copyright (C) 2001-2005 Koen van de Sande / Van de Sande Productions
This software is provided 'as-is', without any express or implied This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages warranty. In no event will the authors be held liable for any damages
arising from the use of this software. arising from the use of this software.
Permission is granted to anyone to use this software for any purpose, Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute including commercial applications, and to alter it and redistribute
it freely, subject to the following restrictions: it freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; 1. The origin of this software must not be misrepresented;
you must not claim that you wrote the original software. you must not claim that you wrote the original software.
If you use this software in a product, an acknowledgment in the If you use this software in a product, an acknowledgment in the
product documentation would be appreciated but is not required. product documentation would be appreciated but is not required.
2. Altered versions must be plainly marked as such, 2. Altered versions must be plainly marked as such,
and must not be misrepresented as being the original software. and must not be misrepresented as being the original software.
3. This notice may not be removed or altered from any distribution. 3. This notice may not be removed or altered from any distribution.
</pre> </pre>
</div> </div>
</div> </div>
</td> </td>
</tr> </tr>
</table> </table>
</body> </body>
</html> </html>