Turbo-Vision-Hilfe

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 Tipps gegeben, wie Sie den TVHC patchen sollten.

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 enthält einen bösen Fehler, der dazu führt, dass die Quotefunktion – das Aufheben der Funktion der geschweiften Klammer durch doppelte Angabe – nicht funktioniert. Falls der TVHC Ihnen die obige Fehlermeldung präsentiert, ändern 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, dass 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 einer Neuübersetzung des TVHC bricht dieser die Umwandlung nicht mehr ab, sondern gibt nur eine Warnmeldung aus, die Sie ignorieren können.