User Commands                        create-branching-keyboard(1)



NAME
     create-branching-keyboard - create branching  keyboards  for
     GOK

SYNOPSIS
     create-branching-keyboard infile [n-desired-rows]

DESCRIPTION
     create-branching-keyboard  takes  an  input  data  file  and
     creates a family of branching keyboard XML files in the for-
     mat that GOK expects. Given an input file  named  test.data,
     create-branching-keyboard  creates  test.data.kbd,  which in
     turn refers to a family of  *.kbd  files  that  are  created
     based on data in the input file.

OPERANDS
     The following operands are supported:

     infile          The name of the input file.



     n-desired-rows  If   specified,    create-branching-keyboard
                     attempts to create keyboards with the speci-
                     fied number of rows. The recommended  values
                     are between 2 and 6.



EXTENDED DESCRIPTION
     create-branching-keyboard can be used to create families  of
     branching  keyboards  from  UTF-8 input files. The format of
     the input files is as follows:

       ]o  Lines beginning with '#' are ignored.

       ]o  The rest of the  input  file  consists  of  consecutive
          pairs  of  lines. The first line of a pair is typically
          ignored, but should serve as a UTF-8  label  describing
          the  "primary key" in the next line. The second line of
          the pair consists of a single UTF-8 character  followed
          by a ':' color delimiter, and a string of UTF-8 charac-
          ters to which the initial character may branch.


     The resulting XML file, after processing, defines .kbd files
     such  that  each prefix 'primary key' forms a key on the GOK
     keyboard whose label is the "primary key"  UTF-8  character,
     and which branches to a keyboard consisting of the following
     UTF-8 characters, one per key.





SunOS 5.11          Last change: 13 Nov 2007                    1






User Commands                        create-branching-keyboard(1)



     create-branching-keyboard is particularly useful in creating
     branching keyboards for ideographic languages. For instance,
     the primary key for a given line may consist  of  the  UTF-8
     character for a 'radical' such as hng.

EXAMPLES
     Example 1: Creating Branching Keyboards From a  File  Called
     test.data

     example% create-branching-keyboard test.data

EXIT STATUS
     The following exit values are returned:

     0        Application exited successfully



     >0       Application exited with failure



FILES
     The following files are used by this application:

     /usr/bin/create-branchinExecutable to create branching  key-
                             boards for GOK



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
           ATRIBUTE TYPE               ATRIBUTE VALUE      
    
     Availability                 SUNWgnome-a11y-gok         
                                                             
                                  SUNWgnome-a11y-gok         
   
    Interface stability          Volatile                    
   


SEE ALSO
     Latest version of the GNOME  Desktop  User  Guide  for  your
     platform.

     gok(1), attributes(5)





SunOS 5.11          Last change: 13 Nov 2007                    2






User Commands                        create-branching-keyboard(1)



NOTES
     The create-branching-keyboard utility  is  experimental  and
     unsupported.

     Written by Bill Haneman, Sun Microsystems Inc., 2004,  2006,
     2007.

















































SunOS 5.11          Last change: 13 Nov 2007                    3