Attributes Tables
-----------------

Files with names of the form *.atb are attributes tables, and with names of the 
form *.ati are attributes subtables. They are used when BRLTTY is displaying 
screen attributes rather than screen content. Each of the eight braille dots 
represents one of the eight VGA attribute bits.

An attributes table consists of a sequence of directives, one per line, which 
define how combinations of VGA attributes are to be represented in braille. 
UTF-8 character encoding must be used. White-space (blanks, tabs) at the 
beginning of a line, as well as before and/or after any operand of any 
directive, is ignored. Lines containing only white-space are ignored. If the 
first non-white-space character of a line is "#" then that line is a comment 
and is ignored.

===============================================================================

The Dot Directive
-----------------

   dot <dot> <state> # <comment>

Use the "dot" directive to specify what a specific dot represents. The default 
is that all dots are down and not used to represent anything.

The <dot> operand specifies the dot being defined. It is a single digit within 
the range 1-8 as defined by the standard braille dot numbering convention (see 
README.BrailleDots).

The <state> operand specifies what the dot represents. It may be:
*  =attribute  The dot is raised if the named attribute is on.
*  ~attribute  The dot is raised if the named attribute is off.

The names of the attribute bits are:
*  0X01  fg-blue
*  0X02  fg-green
*  0X04  fg-red
*  0X08  fg-bright
*  0X10  bg-blue
*  0X20  bg-green
*  0X40  bg-red
*  0X80  blink

Examples:

   dot 1 =fg-red
   dot 2 ~bg-blue

===============================================================================

The Include Directive
---------------------

   include <file> # <comment>

Use the "include" directive to include the content of an attributes subtable. 
It is recursive, which means that any attributes subtable can itself include 
yet another attributes subtable. Care must be taken to ensure that an "include
loop" is not created.

The <file> operand specifies the file to be included. It may be either a 
relative or an absolute path. If relative, it is anchored at the directory 
containing the including file.

===============================================================================

