Generation Options: Miscellaneous

Navigation:  ScriptLine Properties > Generation Options >

Generation Options: Miscellaneous

Previous pageReturn to chapter overviewNext page

The options in the Miscellaneous tab of the Generation Options ScriptLine property dialog are:

 

Force temp tables generation

This option, if set to true, forces Q++ to create temporary data tables during the Creating Local Tables stage of diary generation, even if Q++ has determined that, for example, the current script did not use any Saints, and that, therefore, it was not necessary to create a temporary Saints table locally. The default, and recommended, value for this option is false, and there is almost never any reason to set this option to true.

Max recursion level

Whenever Q++ evaluates a token it keeps track of the number of levels of recursion used. Whenever that number reaches the value of the Maximum Recursion property, the processing of the token is stopped and a run-time error message is generated.

 

Most tokens get converted with a recursion level of 0 (zero). The token comes in and is replaced by text that does not contain tokens. For example, [a1Dddd] may get converted to Monday.

However, sometimes, a conversion functions must evaluate included tokens immediately because the original token's date cannot be used for these included tokens. This is the case for Duration Tokens and MiniCalendar Tokens. This is usually a sign that you are replacing a token by the same token, either in the Multi-Holidays surrounding text or the Moon Options. In these cases the recursion level of the conversion function calling itself can increase.

 

The default value for this property, 50, should be more than enough in all cases. If necessary, this value can be increased to 500, but it is not recommended as it can cause a stack overflow, and most of the time you will not need to change the value of this property.

Max iteration level

Whenever Q++ evaluates a token it keeps track of the number of levels of iterations used in converting each individual token. Whenever that number reaches the value of the Maximum Iterations property, the processing of the token is stopped and a run-time error message is generated.

 

Most tokens get converted with an iteration level of 0 (zero). The token comes in and is replaced by text that does not contain tokens. For example, [a1Dddd] may get converted to Monday.

A token such as [a1:dmmmm] may be converted, depending on the language, into [Mmmm] [d][.d] which would cause the token conversion to be called 3 more times to evaluate these 3 tokens, hence a recursion level of 3.

Even recursive macro tokens that generate complete months and format different elements of each day differently, usually reach an iteration level of about 300 only.

 

As can be seen from the above examples, the default value for this property, 1000, should be more than enough in all cases. If necessary, this value can be increased to 10000, but most of the time you will not need to change the value of this property.

Maximum BOXFIT Iterations


Warn if no overflow in BOXFIT


Override XPress Tags Version

This option should only be used at the behest of technical support.

Remove Hyphenation

This option is sometimes needed when complex typographical changes, as occurs in many GenTokens, can confuse QuarkXPress and cause it to crash during diary generation.

 

When this option is set to true, before processing each token, Q++ removes the automatic hyphenation for that token text. This is equivalent to setting the H&J Format value to No Hyphenation.

 

Recommended default: true.

Warn of inconsistent Text Style Sheets

When using QuarkXPress 2015 or above to generate a diary, if one of the templates of the script has the same-name text style sheet as another of the templates of the script, then the warning message Input file contains same name CharStyle asset defined differently will be generated for all the text style sheets you have defined yourself if the CheckBox is grayed or if the CheckBox is checked then the same message will also be issued if an inconsistency is noticed for the default text style sheet (ie. the Normal text style sheet).

Warn of inconsistent Paragraph Style Sheets

When using QuarkXPress 2015 or above to generate a diary, if one of the templates of the script has the same-name paragraph style sheet as another of the templates of the script, then the warning message Input file contains same name ParaStyle asset defined differently will be generated for all the paragraph style sheets you have defined yourself if the CheckBox is grayed or if the CheckBox is checked then the same message will also be issued if an inconsistency is noticed for the default paragraph style sheet (ie. the Normal text style sheet).

Warn of inconsistent H&Js

When using QuarkXPress 2016 or above to generate a diary, if one of the templates of the script has the same-name H&J style as another of the templates of the script, then the warning message Input file contains same name H&J asset defined differently will be generated for all the H&J styles you have defined yourself if the CheckBox is grayed or if the CheckBox is checked then the same message will also be issued if an inconsistency is noticed for all default H&J styles.

Warn of inconsistent Dashes & Stripes

When using QuarkXPress 2015 or above to generate a diary, if one of the templates of the script has the same-name dashes/stripes as another of the templates of the script, then the warning message Input file contains same name Dashes/Stripes asset defined differently will be generated for all the dashes/stripes you have defined yourself if the CheckBox is grayed or if the CheckBox is checked then the same message will also be issued if an inconsistency is noticed for default dashes/stripes (all 11 styles from All Dots to Triple).


Topic 179075 updated on 03-Jun-2017.
Topic URL: http://www.qppstudio.net/webhelp/index.html?miscellaneous2.htm