Pure-C-Hilfe

Das Pure-C-Hilfe-Format wird nur für Pure C, einem Compiler für den Atari, als Hilfesystem verwendet. Ansonsten hat es keine Bedeutung mehr für diesen Rechner.

Wie erzeugt UDO hier Titelseite und Inhaltsverzeichnis?

UDO erzeugt eine Seite mit den Titelangaben und dem Inhaltsverzeichnis. Da diese Seite bei umfangreicheren Dokumenten ziemlich lang werden kann, empfiehlt es sich, den Schalter !use_compressed_tocs [pch] im Zusammenhang mit den Schaltern !use_auto_subtocs [pch] und !use_auto_subsubtocs [pch] zu benutzen, damit auch Programmierer mit kleinen Bildschirmen nicht den Überblick auf dieser Seite zu verlieren.

Wie kann ich bei Pure-C-Hilfe die Kopfzeilen entfernen?

UDO erzeugt auf jeder Seite automatisch Kopfzeilen, gebildet aus der Überschrift der jeweiligen Seite sowie des Titels der Hilfedatei. Durch Anklicken des Titels können Sie zur Titelseite bzw. zum Inhaltsverzeichnis verzweigen.

Durch den Schalter !no_headlines [pch] lässt sich die Ausgabe dieser Kopfzeilen unterbinden.

Und wie die Fußzeilen?

UDO erzeugt auf jeder Seite automatisch Fußzeilen, in denen Verweise auf das vorherige, nachfolgende und/oder übergeordnete Kapitel zu finden sind. Diese ermöglichen dem Leser, direkt zu anderen Kapiteln des Textes zu verzweigen.

Durch den Schalter !no_bottomlines [pch] lässt sich die Ausgabe dieser Kopfzeilen unterbinden.

Wofür ist diese Datei mit dem Suffix .cmd?

UDO legt während der Umwandlung eine Kommandodatei für den Helpcompiler von Pure C an, welche an diesen zur Erzeugung der Helpdatei als Kommando übergeben werden muss.

UDO überschreibt diese Kommandodatei ohne Rückfrage. Um manuelle Änderungen an dieser Datei zu bewahren, müssen Sie die Datei schreibschützen.

Wie erzeuge ich eine Hilfedatei für Pure C?

Bei der Umwandlung des Quelltextes foo.u erzeugt UDO die Dateien foo.scr und foo.cmd.

Um eine Hilfedatei für Pure C zu erhalten, müssen Sie HC.TTP starten und diesem Programm die Kommandodatei foo.cmd übergeben:

$ e:\purec\hc.ttp foo.cmd

Unter GEM ziehen Sie einfach die Datei foo.cmd auf HC.TTP.

Wie benutzt ich die Hilfedatei mit Pure C?

Pure C erlaubt (leider) nur die Einbindung einer einzigen benutzerdefinierten Hilfedatei. Diese trägt den Namen USR.HLP und befindet sich im Pure-C-Ordner.

Um eine eigene Hilfedatei zu benutzen, sichern Sie die alte Hilfedatei (z.B. durch Umbenennen in USR.HLX) und kopieren Sie die eigene, in USR.HLP umbenannte Hilfedatei in den Pure-C-Ordner.