CIB merge technischer Leitfaden

6. Aufrufparameter im Detail

6.59. Parameter --replace-header

Der Parameter --replace-header dient dazu, das Neuschreiben des Kopfes der RTF-Ausgabe wahlweise abzuschalten.


Syntax

--replace-header=<Option>
<Option>: always, never oder automatic

Beschreibung

Der Kopf der RTF-Ausgabe wird am Ende neu geschrieben. Wegen der Farb-,Listen- und Schriftartentabellen im Kopf der RTF-Ausgabe, muss CIB merge Zeit für den Abgleich wegen Einfügungen oder zur Optimierung aufwenden. Dieser Abgleich oder diese Optimierungen interessieren aber nicht jeden Anwender. Daher sind sie wahlweise abschaltbar. Das bezieht sich auch auf den gesamten Kopf.

Mögliche Werte für <Option> sind:

Option

Bedeutung

always

Der Kopf der RTF-Ausgabe wird am Anfang immer reduziert geschrieben und bereits zu Beginn ist bekannt, dass der Kopf am Ende neu geschrieben wird. Würde man den RTF-Kopf aber deswegen am Anfang gar nicht schreiben, ist im Fehlerfall das Dokument unvollständig und nicht mehr mit MS Word lesbar. Dabei werden die Schriftartentabellen sowie der unspezifizierte Teil des Kopfes nicht ausgegeben. Die Listentabellen der Include-Files werden ignoriert.

never

Der Kopf der RTF-Ausgabe wird nie ersetzt. Wird er am Anfang trotzdem reduziert geschrieben?

automatic

Der Kopf der RTF-Ausgabe wird ersetzt, wenn eine der folgenden Bedingungen zutrifft:

  • Der RTF-Kopf wurde verändert.
  • Die Listentabelle wurde erweitert und
    --lists=optimize oder expand.
  • Die Listentabelle kann optimiert werden und
    --lists=optimize oder expand.
  • Die Schriftartentabelle wurde erweitert und
    --fonts=expand oder adjust.
  • Die Schriftartentabelle kann optimiert werden und
    --fonts=optimize oder adjust.
  • Die Farbtabelle wurde erweitert und
    --colors=expand oder optimize oder minimal.
  • Die Farbtabelle kann optimiert werden und
    --colors=optimize oder minimal.


Beispiele
--replace-header=automatic

Dieser Parameter wird zusammen mit --fonts, --colors und --lists im Anwendungsbeispiel Bausteine veranschaulicht.