[BRLTTY] Xbrlapi

[Samuel Thibault]

Willie Walker, le Thu 14 Dec 2006 13:34:38 -0500, a écrit :
> Thanks for the quick response!
> 
> > > type: corresponds to the KEY_TYPE_* constants.  There are currently 
> > >       only two types: KEY_TYPE_SYM (used for text entry) and
> > >       KEY_TYPE_CMD (used for everything else).
> > 
> > Yes.
> > 
> > > cmd:  The actual command.
> > 
> > > The 'type' above is encoded in the command.
> > 
> > What do you mean by that?
> 
> (cmd | type) == cmd, at least from what I can tell.

Then it's a bug.

> > > arg:  Holds optional command arguments.
> > 
> > Yes.
> > 
> > >       [What does this hold when the type is KEY_TYPE_SYM?]
> > 
> > It never not hold anything.
> 
> What does 'arg' hold when the type is KEY_TYPE_SYM?

no bits, i.e. 0 :)

> > > flgs: I've yet to see this hold a non-zero value, so I don't have a 
> > >       clue.  :-(
> > 
> > These are brlapi.KEY_FLG*, like SHIFT, CONTROL, META. Some commands have
> > specific flags too.
> 
> Interesting.  Thanks.  Do you have table that specify which commands
> have flags, or it is infamously intuitively obvious?  :-)

brlapi_commands should document them.

> > See man brlapi_commands for more details.  Dave, here is a documentation
> > patch for pointing users to brlapi_commands(3).
> 
> Unfortunately, I'm missing the man pages for brlapi and never knew they
> existed until today.

Ugh, odd.

> The docs I found on line

Online docs are only for the latest stable version, i.e. 3.7.2.

> So...I've just been fighting my way through source code and defines.
> Looks like Programs/brlapi_constants.h might have some of this
> information, though.

Yes.  Manpages are extracted from that.

Samuel