CIB merge technical documentation (EN)

6. Call parameters in detail

6.60. Parameter --replace-header

The --replace-header parameter is used to optionally disable RTF output header rewriting.


Syntax

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

Description

The header of the RTF output is rewritten at the end. Because of the color, list and font tables in the RTF output header, CIB merge has to spend time for insertion matching or optimization. But not every user is interested in this adjustment or optimization. Therefore they can be switched off optionally. This also applies to the entire header.

Possible values for <Option> are:

Option

Description

always

The header of the RTF output is always written reduced at the beginning and already at the beginning it is known that the header is rewritten at the end. But if the RTF header would not be written at all at the beginning, the document would be incomplete and not readable with MS Word. The font tables as well as the unspecified part of the header are not output. The table lists of the include files are ignored.

never

The header of the RTF output is never replaced. Wird er am Anfang trotzdem reduziert geschrieben?

automatic

The header of the RTF output is replaced if one of the following conditions applies:

  • The RTF header was changed.
  • The list table was extended and

--lists=optimize or expand

  • The list table can be optimized and

--lists=optimize or expand.

  • The font table was extended and

--fonts=expand or adjust.

  • The font table can be optimized and

--fonts=optimize or adjust.

  • The color table was extended and

--colors=expand or optimize or minimal.

  • The color table can be optimized and

--colors=optimize or minimal.


Example
--replace-header=automatic

The usage of this parameter together with --fonts, --colors and --lists is demonstrated in the application example Templates.