Using PatchOnClick

poc-header

 

A Guide to Using HashOnClick

 

PatchOnClick is very simple to use.  The main Interface has four buttons and a progress bar:

 

 

poc-main-interface

 

Create a patch file: This button runs a wizard process to create a patch file.

 

Patch a file: This button runs a wizard process to patch a file.

 

Progress bar: The progress bar shows the current process of patching or applying a path to a file.

 

Help: The help button will open the PatchOnClick section in the OnClick Utilities help file.

 

Exit: Closes the program.

 

Creating a Patch File

 

Creating a patch file is an easy three step process with PatchOnClick.

 

note

Note that you will need two "source" files to create a patch. The first is your original file which you have already distributed, the second is your modified file. Creating a patch file will make a file with the extension .poc. This new file will be the differences between you original file and your modified file.

 

patching-files

 

Firstly click the Create a patch file button:

 

poc-create-patch

 

A new window will open allowing you to choose the original file using an explorer interface. The example below shows the file "My Word Document.doc" has been selected.

 

note

Note how PatchOnClick shows the current purpose of the window in text at the top left. The first window is titled "Original file".

 

poc-create-patch-1

 

Now click the Open button. A new window will open asking you to select the modified file. In this example the file "Updated My Word Document.doc" has been selected:

 

poc-create-patch-2

 

Click the Open button. You will now be asked to browse to the location to save your patch file.

 

note

Note how in the example below the file name ends with the .poc extension:

 

poc-create-patch-3

 

Click the Save button. The progress bar will appear as the task is completed by the program.

 

For small patches the window will only briefly appear as PatchOnClick completes the patching process very quickly. The example below shows the progress for a relatively large patch file:

 

poc-progress

 

An informational window will now appear summarizing the patch you have created:

 

poc-create-patch-5

 

Congratulations! You have now created a patch file.

 

If you browse to the location where you saved your patch file you will see the new POC file which is significantly smaller than the updated document:

 

poc-create-patch-4

 

Patching a File

 

To patch a file simply click the Patch a file button on the main program interface:

 

poc-patch-file

 

A window will open asking you to select the file to be patched. The example below shows we are patching the "My Word Document.doc" file:

 

poc-patch-file-1

 

Click the Open button.

 

A new window will open asking you to select a patch file:

 

poc-patch-file-2

 

Click the Open button.

 

You will now need to enter a name for the file you wish to create. By default PatchOnClick  prefixes the file name with "Patched" as shown in the example below:

 

poc-patch-file-3

 

Click the Save button.

 

Congratulations! You have patched a file.

 

If a file already exists for the patched file you are creating a warning dialog window will open which shows the following message:

 

poc-document-exists

 

 

Frequently Asked Questions

 

FAQs about using PatchOnClick follow on the next page of this help file.