sample.txt

BBOalert, file must begin with BBOalert keyword 1.5.1

You can use this sample data to test BBOalert features. You should :
- press 'Raw' button on this page
- Ctrl-A to select all text
- Ctrl-C to copy it to the clipboard
- In BBO, after successfull login
    - press 'Import' button
    - Practice
    - Start a Teaching Table
    - Start Table
    - sit in all four directions
    - make a call included in this sample and see what happens

1. File format

Valid records should contain at least 3 fields seperated by comma
<context>,<call>,<explanation>,<comment>
where <context> represents the bidding before <call>. <explanation> is the text to accompany tha alerted call.
<comment> field is optional. Spaces or tabs are allowed at the beginning or end of each field for better readability.

Empty lines are allowed for better readability
Comment lines like this are ignored

Example :
    1C--1D--1H--,	1N,		explanation text, 

Note -- which represents passed oponents. Instead of -- you can use double underscore __ as wild card
if the meaning of the call does not depend of eventual overcalls made by oponents.
In the example below, the meaning of each of each call remains the same, even if oponents bid.
    1C__1D__1H__,	1N,		explanation text,

The opening bid must begin with empty field
    ,1C,17+HCP any distribution,Comment: this is the typical opening bid of Precision System

The negative response to 1C opening is 1D
    1C--,1D,0-7HCP any distribution
The bidding context is 1C-- which means opening 1C followed by opponent's pass (-- code)

Opener's rebid after 1D response will be coded
    1C--1D--,1N,17-19HCP balanced hand

Similar after the 1H overcall after 1D
    1C--1D1H,1N,17-19HCP balanced hand

If the opening is seat sensitive you should mention explicitely initial passes
    ----,1H,9-14HCP 4+!S
    ----1S--,2C,10-11p Drury after initial pass

Our own overcalls after opponent's opening are represented by code
    1H,2N,minor two-suiter

For better readability leading spaces or tabs are allowed
    1H,     2N,     minor two-suiter

If the same bidding sequence is defined twice, only the last one will be considered.
Typical situation when, during the game, you modify the exeplanation for the alerted call.
Any modification made during the game will appear in the clipboard (paste at the end of the existing table).
In the comment field you will find the time stamp and the deal number for eventual review.

If the explanation text excceds 39 characters, you can use # character to split it in to parts.
The first will appear in the explanation field of the bidding box, the second part in the chat box.
You should send the chat message to the opponents manually. Example :
    ,1D,Short explanation text#Long chat message text limited to 249 characters

Keyboard abbreviations can be defined :
    Shortcut,   TC,   Texas !C
    Shortcut,   TD,   Texas !D
    Shortcut,   TH,   Texas !H
    Shortcut,   TS,   Texas !S
    Shortcut,   XX,   to avoid long line wrapping in the text editor \
                      you can use backslash to continue in the next line
    Shortcut,   BW,   Blackwood 4-1,3-0 (5 key cards)
    Shortcut,   ML,   Multiline text\nLine 2\nLine 3\n

or Alt-key shortcuts :
    Shortcut,	AltA, Hello. You pressed ALt-A key

Sample of selectable blocks of data

    Option,vs1C standard
    1C,Db,Take-out double

    Option,vs1C Precision
    1C,Db,Lead indicating double

    Option,vs1NT Standard
    1N,Db,Undefined 6 card suit

    Option,vs1NT Weak
    1N,Db,For penalties

Reserved tags @n and @v will enable automatic switching of code depending on actual
vulnerability.
    Option,MyOpenings @n
    ,1N,12-14 balanced

    Option,MyOpenings @v
    ,1N,15-17 balanced

Bare 'Option' keyword will end the optional block 
    Option

The options can be enabled only for a spacific partner if you provide his user-id with the optio

Option,2D Multi,john
,2D,weak 6M or any strong hand
Option,2D Weak,joe
,2D,weak card 6!D
Option