When you process a document with options blocks nested within another, or with variables nested within Options blocks (either or both), you notice a pause. The more items that are nested, the longer the pause.

   Pathagoras is counting relevant slashes to determine how many choices it will be presenting on the selection screen. During that 'pause,'  Pathagoras is converting slashes within nested components to other characters to make sure that the slashes it encounters are the right slash for the level of the option being processed.)


<<*Options*!FoodType!Appetizer/Entree/Dessert*I want to start the meal off with a [Greek salad/bowl of tomato bisque/cheese assortment]./For the main course, let me have [fried chicken/New York strip steak/vegetable moussaka]./And let's finish up with [Baked Alaska/Raspberry sorbet/apple pie]. {And coffee, please.}>>

The exaggerated slashes above are the 'real' dividers for the !FoodType! group.
The smaller slashes (seen in the nested variables) need to be ignored temporarily.


   Since any slash is a separator, without Pathagoras having a way to distinguish the 'nested' from the top level slashes, you would be presented 10 options at the beginning when you were only expecting 3.

   To accomplish this task, Pathagoras temporarily (and very quickly) converts the slashes in all nested elements to other characters.

   The process of converting in, and then converting back out after measurements have been taken, is quick for an individual element (less than 1/10 seconds according to our measurements).  However, when there are many such elements, it can add a significant amount of processing time to your project. When there are hundreds of nested elements, many seconds can be consumed.

  The solution:

   In cases where major 'outside' sections can be clearly identified, and where you can tell that 'slash conversions' would be a waste of time, use '^OR' (we call it 'caret OR') as the divider. (As suggested in the preceding sentence ^OR should only be used at the 'top level' of choices, and not at any nested level. And no nesting of ^ORs is allowed.

  One last requirement. the ^OR must be on it's own line, or at the end of a paragraph. (Pathagoras is looking for ^OR<Enter>


   Multiple ^ORs in a single document are permitted, with the only requirement being that the 'top level' options are independent from each other.

   The experienced user will also recognize that '/OR' (slashOR) can be used as a super divider. If Pathagoras see a /OR in an options block, it will not convert nested / within its scope. Plus, /ORs do not have to be in a separate line. ^OR was written for large swaths of text, /OR for much shorter document elements. A bit of experimentation could be useful to determine the best use of each in your particular documents.