[BRLTTY] Customizations to data files.

[Dave Mielke]

The latest brltty development code now includes support for the XDG 
configuration file layout. The most important thing this offers is a standard 
place to place data files of your own which should override brltty's provided 
data files. In other words, you no longer need to modify brltty's provided data 
files in order to make your own customizations. The following data files are 
covered by this change:

   The Configuration File (brltty.conf)
   Text Tables (*.ttb)
   Text Subtables (*.tti)
   Attributes Tables (*.atb)
   Attributes Subtables (*.ati)
   Contraction Tables (*.ctb)
   Contraction Subtables (*.cti)
   Key Tables (*.ktb)
   Key Subtables (*.kti)

The standard directory where to put your customized files is:

   /etc/xdg/brltty

The simplest way to customize a data file is to copy it to this directory and 
them to modify your copy as needed. You can, however, just place your changes 
in your version of the file and then include the provided file in order to 
automatically always pick up the latest versions of all the unchanged lines. 

For example: Let's say that you'd like to add your own key bindings to the 
laptop keyboard key table. To do so, create /etc/xdg/brltty/laptop.ktb and 
place these lines in it:

   bind Key1 COMMAND1
   bind Key2 COMMAND2
   ...
   include /etc/brltty/laptop.ktb

The XDG_CONFIG_HOME and XDG_CONFIG_DIRS environment variables are supported as 
well.

-- 
Dave Mielke           | 2213 Fox Crescent | The Bible is the very Word of God.
Phone: 1-613-726-0014 | Ottawa, Ontario   | http://Mielke.cc/bible/
EMail: dave at mielke.cc | Canada  K2A 1H7   | http://FamilyRadio.com/