The anatomy of a robust Options block.
The block of text that contains the options you want to present to the end user must begin with '<<*Options*' and end with a corresponding '>>' marker. The various choices must be separated one from the other with slashes ('/').
If you want to add a groupname, it must appear immediately after the <<*Options* command. Just like all !groups!, the groupname must be written between two exclamation marks ('!').
If you want to add prompts, they must appear immediately after the !groupname!
Closing the administrative text. If you add a groupname and/or prompts, you must tell Pathagoras where the 'administrative text' end and the substantive text begins. This is done by the insertion of a third asterisk.
Here is the previous example marked up with a group name and prompts. You can copy and paste this example into an OnCloud document and test it by pressing Alt-P ('p'rocess) or clicking the Process button under Pathagoras Tools. (Note: as with all added colorings, they are for emphasis only. They are not required. You may leave colorings in the document and all will be removed upon processing.)
<<*Options*!shipping!FedEx/Ground/Hold for Pickup/Out of Stock*Per your request, the widgets will be shipped by Federal Express. We will bill you for the extra cost of shipping./Per your request, we will send the widgets by standard ground transport. This may take 3 to 5 additional days./As per your request, we will hold the widgets for pickup by your courier./The widgets you have ordered are not currently in stock. We will ship them as soon as possible. If we have not shipped within 5 days of this date, you will have the option to cancel the order.>>
Pathagoras On Cloud can do all of this markup for you automatically. Just highlight the text block that contains the Options. Click the 'Pathagoras Tools' tab and then click the 'Convert to '<<*Options*..." button. Provide the groupname and prompts (same number of prompts as choices in the body text, separating each prompt with slashes).
Pathagoras instantly modifies the highlighted text, inserting all elements in their proper places. Because all markups are plain text, you can continue to edit the groupname, the prompts and the substantive text until you have achieved the best setup for your document.