The above causes a repeat of the identical text X number of times. You will more likely will want to use the <<*Repeat*>> function to increment a variable that you place within the repeating text. The structure is identical to the 'Simple' example above, with the introductory word "<<*Repeat*" followed by whatever text you want to repeat, followed by a closing ">>"
Examples (The colors are added for illustration purposes. They are not required):
When the repeat block is encountered during a document assembly session, Pathagoras will ask "How many times do you want to repeat this text?" The 'return' of the function would be, in this case, the named variable, incremented by the number of repeats called for.
So, if the answer to the 'how many' question is 3, Pathagoras will create 3 new variables thusly:
[ChildName@1] [ChildName@2] [ChildName @3]
See this page for the repeat 'arguments' which allow you to add punctuation and connectors to make the above more 'sentence-like.'
E.g,, [ChildName@1], [ChildName@2] and [ChildName @3]
You can include as much or as little additional text within the repeat block as you wish. All plain text will be repeated 'intact'; all bracketed text will be incremented as per the examples.
<<*Repeat*[Child@Name], Date of birth [Child@DOB]>>.
You can increment a number outside of a variable using the character set '[#]' (no quotes).
For example, if you wanted to make a numbered list using the above, you might type:
By default, all bracketed variables are incremented by each repeat called for. However, if you place a variable that you do not wish to increment (perhaps a date variable that will be consistent for all blocks, simply append an underline to the variable name (inside the bracket) and Pathagoras will repeat the variable but not increment it.
You can modify the settings of the 'non-increment' function, including the non-increment ending character and whether it is removed (let's say so that it will match other variable) or left in. "_" and 'remove' are the default settings.
The settings are found under the "Repeats" tab of the Utilities/Settings | All Settings screen.
Incrementing within Date Math formulae:
If you are repeating a Date Math equation (where incrementing is to be suppressed), make sure you add the underscore to the 'formula' variables (those to the right of the equal sign). The resulting variables (to the left of the '+') is simply text at this stage and does not require a 'don't increment' marker.
<<*Repeat*[#Math#Date Claims Due Alternate=[CreditorNoticeDate_]+[91 days_]]>>