Home Wieso, weshalb, warum Fragen zum Texinfo-Format Fragen zum WinHelp-Format

Fragen zum Turbo-Vision-Help-Format

Dieses Format wird benutzt, um Onlinehilfen für DOS-Programme zu erstellen, die mit Borlands Turbo-Vision-Library geschrieben wurden. Zuständiger Konverter ist das Programm TVHC.EXE, das den Entwicklungssystemen auch im Sourcecode beiliegt.

Da das Turbo-Vision-Help-Format wohl nur für Programmierer interessant sein dürfte, werden hier auch einige Tips gegeben, wie man den TVHC patchen sollte.

Nichtprogrammierer sollten dieses Format meiden, sprich Ihre Hypertexte nicht in diesem Format weitergeben, da es außerhalb der Erstellung von Onlinehilfen für eigene Programme keine Bedeutung hat.

TVHC meldet den Fehler "Unterminated topic reference"!?
 
 
Der mir vorliegende TVHC Version 1.0 beinhaltet einen bösen Fehler, der dazu führt, daß die Quotefunktion — das Aufheben der Funktion der geschweiften Klammr durch doppelte Angabe — nicht funktioniert. Falls der TVHC Ihnen die obige Fehlermeldung präsentiert, so ändern Sie den Sie die Funktion scanForCrossRefs() in tvhc.cpp folgendermaßen um:
 
Original:
 
if (line[i+1] == begXRef)
{
    strdel(line, i, 1);
        ++i;
}

Patch:
 
if (line[i] == begXRef)    // [i] statt [i+1]
{
    strdel(line, i, 1);
        ++i;
}

Nach dieser Änderung sollten Sie den TVHC neu übersetzen, um die Änderungen wirksam werden zu lassen.
 
TVHC meldet den Fehler "Text too long"!?
 
 
In der Datei tvhc.h legt eine Konstante namens bufferSize die Größe des Textpuffers fest, den der TVHC als Zwischenspeicher währen der Übersetzung benutzt. Der Puffer ist ziemlich klein dimensioniert, falls Sie obige Fehlermeldung erhalten.
 
Legen Sie einen ausreichen großen Puffer (z.B. 32 KB) an, so daß auch größere Texte problemlos übersetzt werden.
 
const bufferSize = 32768;

Nach dieser Änderung sollten Sie den TVHC neu übersetzen, um die Änderung wirksam werden zu lassen.
 
TVHC meldet den Fehler "TOPIC expected"!?
 
 
Dieser Fehler tritt auf, sobald eine Zeile mit einem Punkt — dem "commandChar" — beginnt. Die mir vorliegende Version bricht darauf die Umwandlung ab.
 
Dieser Abbruch ist jedoch unnötig, weshalb ich meinen TVHC gepatched habe. Falls Sie den Sourcecode vorliegen haben, suchen Sie nach
 
error("TOPIC expected");

und ersetzen Sie es durch
 
warning("TOPIC expected");

Nach eine Neuübersetzung des TVHC bricht dieser die Umwandlung nicht mehr ab, sondern gibt lediglich eine Warnmeldung aus, die Sie ignorieren können.
 

Home Wieso, weshalb, warum Fragen zum Texinfo-Format Fragen zum WinHelp-Format