This program is FREEWARE. It may be freely copied, as long as no files are changed and no files are added (expect foreign language translations), especially viruses are forbidden :-)
It may be freely used.
It my NOT be passed on by public domain libraries or as gift for commercial product (such as magazines, computers etc.) without permission by me.
The author is in no way responsible for any damage caused by 'HelpDiff' or 'HelpDiff Frontend'.
Purpose:
========
To calculate the difference between two StrongHelp help files. The created difference file may then be used to update StrongHelp files, using HelpUpdate.
Distributing the (normally) much smaller difference file will save time and money, especially when using a phone line.
Installation:
=============
HelpDiff
--------
needs no installation.
HelpDiff Frontend
-----------------
HelpDiff should lie inside a directory along Run$Path, eg. for usage with Make, or stay inside the application directory.
The command for starting HelpDiff may be changed inside the file 'Messages', see tag 'COMMAND'. It is by default set to 'TaskWindow "HelpDiffRun:helpdiff %0 %1 %2"'. This may be changed, eg. to run the program faster, outside Taskwindow. Another possibility is to use !Virtual, but this is not tested. The parameters '%0 %1 %2' must not be changed and must follow 'HelpDiff' immediately. HelpDiffRun: is set to "<Obey$Dir>.,<Run$Path>" and should suit most cases.
The language the program uses may be configured, if the automatically selected one does not suit. See below, 'ResFind'.
Usage:
=====
HelpDiff
--------
Call: HelpDiff <old> <new> <diff>
All parameter must name directories - in the case of the third parameter, <diff>, it do not need to exist - containig StrongHelp help files, 'HelpData' and 'Index'. HelpDiff takes the <old> directory, calculates all differences to the <new> directory and writes the result into the <diff> directory.
HelpDiff Frontend
-----------------
The Frontend is a WIMP-Application. It will be started with a double-click and opens a window in the middle of the screen. The three lines correspond to the three parameters of HelpUpdate. Old Help: and New Help: may be set by dragging the directories onto the writeable icons. Difference: can be set in the usual way with a save dialogue box, that pops up after clicking SELECT on the arrow to the right. All values may be entered by hand, of course. Clicking SELECT on the OK button starts HelpDiff (see installation). Clicking SELECT on th RESET button resets all values. The program quits with closing the window or by selecting Quit in the menu.
!HelpDiff adapts automatically to the configured language if the corresponding messages etc. are available. For this purpose a Resources directory is contained in the application in which a subdirectory for each language supported resides. If the language you need isn't in there, please feel free to duplicate any of these language directories and translate the contents.
When you run the program a utility called ResFind is called which reads the language your computer is configured to and then looks for the corresponding language directory. If this fails the program will run in English (UK). By setting several system variables (best done in your system's !Boot file) you can change the language looked for. With this you can make sure a program runs in a certain language, e.g. to avoid a weird translation. Furthermore it is possible to name several languages you prefer to English.
This is controlled by three system variables:
HelpDiff$Language, ResFind$LanguagesPref und ResFind$Languages$Suff.
When running the application ResFind looks for the first language supported along the following list of languages:
1. Contents of the variable HelpDiff$Language
2. Contens of the variable ResFind$LanguagesPref
3. The configured language
4. Contens of the variable ResFind$LanguagesSuff
5. UK
Take a Norwegian user for example (lots of great programs come from there) whose computer is configured to 'Norway'. Since this language isn't too common in Europe most programs won't support it - except for Norwegian ones. But our user is pretty good in German and French but not too fond of English. Therefore he prefers these languages to UK and would thus put the following line in his system's !Boot file:
*Set ResFind$LanguagesSuff Germany,France
Running an applications (such as this one) using ResFind the list of languages looked for is 'Norway,Germany,France,UK'.
In case this user hat an application calles !Pete supporting the language 'Humor' the line
*Set Pete$Language Humor
in the !Boot file makes sure !Pete will run humorous.
Credits
=======
The HelpDiff frontend is created using the GAG-C-Library.
