Re: [BRLTTY] Changing BRLTTY key mapping [repost]

2018-03-10 Thread Dave Mielke
[quoted lines by Dave Mielke on 2018/03/10 at 07:19 -0500]

>The list in the manual is quite out-of-date. The full list is in the derived 
>header "cmds.auto.h" (cd into Programs/ and make it). Perhaps there should be 
>a 
>tool that creates a document from it.

Building brltty now makes (and installs) a new command - brltty-lscmds - which 
writes a list of all of the commands to standard output. It's in rst 
(reStructured Text) format so you can eitehr (easily enough) read it directly 
or run it through a tool like rst2html. This document will eventually make it 
onto brltty's web site.

-- 
I believe the Bible to be the very Word of God: http://Mielke.cc/bible/
Dave Mielke   | 2213 Fox Crescent | WebHome: http://Mielke.cc/
EMail: d...@mielke.cc | Ottawa, Ontario   | Twitter: @Dave_Mielke
Phone: 1-613-726-0014 | Canada  K2A 1H7   |
___
This message was sent via the BRLTTY mailing list.
To post a message, send an e-mail to: BRLTTY@brltty.com
For general information, go to: http://brltty.com/mailman/listinfo/brltty


Re: [BRLTTY] Changing BRLTTY key mapping [repost]

2018-03-10 Thread Dave Mielke
[quoted lines by Vincent LE GOFF on 2018/03/10 at 09:27 +0100]

>I'll be trying to find th list of commands to which I can remap because I 
>didn't find the list itself, but I believe it's in the manual.

The list in the manual is quite out-of-date. The full list is in the derived 
header "cmds.auto.h" (cd into Programs/ and make it). Perhaps there should be a 
tool that creates a document from it.

-- 
I believe the Bible to be the very Word of God: http://Mielke.cc/bible/
Dave Mielke   | 2213 Fox Crescent | WebHome: http://Mielke.cc/
EMail: d...@mielke.cc | Ottawa, Ontario   | Twitter: @Dave_Mielke
Phone: 1-613-726-0014 | Canada  K2A 1H7   |
___
This message was sent via the BRLTTY mailing list.
To post a message, send an e-mail to: BRLTTY@brltty.com
For general information, go to: http://brltty.com/mailman/listinfo/brltty


Re: [BRLTTY] Changing BRLTTY key mapping [repost]

2018-03-10 Thread Vincent LE GOFF

Hi everyone,


Thanks for the comment Shérab.  I changed my key bindings yesterday and 
it was so easy I was almost (almost!) disappointed when it worked so 
well.  My new mapping just focuses on rockers, although I may be 
altering some others (the fact that the Braille keyboard is turned off 
by default and requires additional keys is a bit strange, but I don't 
use the Braille keyboard that often anyway).



I've remapped as follows, it made more sense to me: top left rocker = 
LNUP (line up), bottom left rocker = LNDN (line down), top right rocker 
= FWINLT (previous Braille window), bottom right rocker = FWINRT (next 
Braille window).  In addition, I have changed some key combinations, so 
going to the top/bottom of the screen, going at the cursor position, or 
going at the beginning of a line (that's things I often do on a daily 
basis) are more intuitive to me.  I can attach the rockers.kti file if 
you want, but really, it's so simple to change these keys, just place 
the altered /input/ht/rockers.kti in /etc/xdg/brltty/rockers.kti and 
change whatever you want in the latter.



Thanks Dave for describing the process.  I'll be trying to find th list 
of commands to which I can remap because I didn't find the list itself, 
but I believe it's in the manual.



Vincent


On 3/9/2018 7:07 PM, Shérab wrote:

Dear Vincent and all,

I started to use an HandyTech ActiveStar 40 one week ago, too.

Although I do not use the internal notetaker and have thus no idea about
what the reference bindings are, I also considered altering the
bindings that come with brltty, because I find some of them a bit counter
intuitive or unpractical.

I agree that the bindings used to change the currnet window, for
instance, could be improved, atleast on my device. The ones you suggest,
Vincent, look more natural to me, too.

Best wishes and many thanks for having started this thread,

Shérab.
___
This message was sent via the BRLTTY mailing list.
To post a message, send an e-mail to: BRLTTY@brltty.com
For general information, go to: http://brltty.com/mailman/listinfo/brltty


___
This message was sent via the BRLTTY mailing list.
To post a message, send an e-mail to: BRLTTY@brltty.com
For general information, go to: http://brltty.com/mailman/listinfo/brltty

Re: [BRLTTY] Changing BRLTTY key mapping [repost]

2018-03-09 Thread Shérab
Dear Vincent and all,

I started to use an HandyTech ActiveStar 40 one week ago, too.

Although I do not use the internal notetaker and have thus no idea about
what the reference bindings are, I also considered altering the
bindings that come with brltty, because I find some of them a bit counter
intuitive or unpractical.

I agree that the bindings used to change the currnet window, for
instance, could be improved, atleast on my device. The ones you suggest,
Vincent, look more natural to me, too.

Best wishes and many thanks for having started this thread,

Shérab.
___
This message was sent via the BRLTTY mailing list.
To post a message, send an e-mail to: BRLTTY@brltty.com
For general information, go to: http://brltty.com/mailman/listinfo/brltty

Re: [BRLTTY] Changing BRLTTY key mapping [repost]

2018-03-09 Thread Dave Mielke
[quoted lines by Vincent LE GOFF on 2018/03/09 at 12:58 +0100]

>I am using the Actilino (alo) and have been testing the ActiveBraille (ab40).  
>As it is, it sounds like the default mapping is not correct for either of 
>these devices.  By "correct", I mean that when using them in standalone mode 
>(as Braille notetakers) or plugged to a screen reader on Windows, simple 
>mapping (for navigation, for instance) is different. 

HandyTech support has been in brltty for a very long time. A lot of us lack 
experience with Windows screen readers, and I doubt the earlier HT models could 
function as notetakers. In other words, brltty's HT bindings may have been 
developed without much of an existing template to go by.

>However, by altering the problematic files, it would also affect a lot of 
>other handytech displays for which the mapping might be more accurate, I have 
>no idea.

Neither do I. Mario would be the best person to discuss this with. I'd hesitate 
to make any changes to the HT bindings without his advice.

>For instance, to go to the next Braille window (which is something
>one does very often, admittedly), the default key mapping is "Right
>Triple Action Key center (TRC)".  On other devices, it might be one
>key, but on the Actilino and ActiveBraille, that's two keys you have
>to press simultaneously. So only moving the Braille window requires
>two key presses (fortunately, they are close).  

They really did used to be triple action keys. On older models you just had to 
press the center of what was an actual rocker.

-- 
I believe the Bible to be the very Word of God: http://Mielke.cc/bible/
Dave Mielke   | 2213 Fox Crescent | WebHome: http://Mielke.cc/
EMail: d...@mielke.cc | Ottawa, Ontario   | Twitter: @Dave_Mielke
Phone: 1-613-726-0014 | Canada  K2A 1H7   |
___
This message was sent via the BRLTTY mailing list.
To post a message, send an e-mail to: BRLTTY@brltty.com
For general information, go to: http://brltty.com/mailman/listinfo/brltty


Re: [BRLTTY] Changing BRLTTY key mapping [repost]

2018-03-09 Thread Vincent LE GOFF

Thank you Dave.


I believe that the ht (HandyTech) driver is pretty much centralized on 
BRLTTY.  Meaning that most displays of this brand will have the same 
features except for slight modifications.  I am using the Actilino (alo) 
and have been testing the ActiveBraille (ab40).  As it is, it sounds 
like the default mapping is not correct for either of these devices.  By 
"correct", I mean that when using them in standalone mode (as Braille 
notetakers) or plugged to a screen reader on Windows, simple mapping 
(for navigation, for instance) is different.  However, by altering the 
problematic files, it would also affect a lot of other handytech 
displays for which the mapping might be more accurate, I have no idea.



For instance, to go to the next Braille window (which is something one 
does very often, admittedly), the default key mapping is "Right Triple 
Action Key center (TRC)".  On other devices, it might be one key, but on 
the Actilino and ActiveBraille, that's two keys you have to press 
simultaneously. So only moving the Braille window requires two key 
presses (fortunately, they are close).  In standalone (which should be 
the reference, I imagine), only Right Triple Action Key down (TRD) or 
Left Triple Action Key down (TLD) are necessary (either, not both at the 
same time).  The Adctilino and ActiveBraille have four navigation keys, 
two on either side of the display.  This is quite common for other 
displays as well.  So the Triple Action Key Center requires the press of 
Triple Action Key Up + Triple Action Key Down.  And that's not really great.



But I insist: I have no idea how the other devices behave, so I prefer 
to make my modification just for my BRLTTY installation. Other handytech 
users might be well-used to the current setup and unwilling to shift, 
which I completely understand.



Thank you again,


Vincent


On 3/9/2018 12:29 PM, Dave Mielke wrote:

[quoted lines by Vincent LE GOFF on 2018/03/09 at 07:44 +0100]


So I've got my new Braille display, and would like to update its key
bindings so it'd behave a bit closer from what it does in standalone,
and how it behaves with other screen readers.

Which braille device do you have? Is there something wrong with brltty's
bindings for it that you think we should consider fixing?


In the README.customize, there's no mention of respecting the directory
structure.  However, the file I want to edit is in input/ht/rockers.kti .  So
do I need to create a ht folder in /etc/xdg/brltty and the rockers.kti file in
it, or do I just add a /etc/xdg/brltty/rockers.cti file?

Put it right in brltty's xdg directory. Don't create a directory structure
underneath it.


I don't want to create conflicts with other drivers, if possible.

Yes, that's a risk. It was done this way in order to make it as easy as
possible.


As I mentioned, I would like to change rockers.kti .  My actual driver file is
in ht/alo.ktb.  This file imports rockers.kti (actually it imports a file that
imports another file).  So, if I leave alo.ktb alone and just change
rockers.kti, would the include path be updated only for this file or do I need
to copy all the included files?

Just make a copy of the file you'd like to modify.



___
This message was sent via the BRLTTY mailing list.
To post a message, send an e-mail to: BRLTTY@brltty.com
For general information, go to: http://brltty.com/mailman/listinfo/brltty

Re: [BRLTTY] Changing BRLTTY key mapping [repost]

2018-03-09 Thread Dave Mielke
[quoted lines by Vincent LE GOFF on 2018/03/09 at 07:44 +0100]

>So I've got my new Braille display, and would like to update its key
>bindings so it'd behave a bit closer from what it does in standalone,
>and how it behaves with other screen readers.  

Which braille device do you have? Is there something wrong with brltty's 
bindings for it that you think we should consider fixing?

>In the README.customize, there's no mention of respecting the directory 
>structure.  However, the file I want to edit is in input/ht/rockers.kti .  So 
>do I need to create a ht folder in /etc/xdg/brltty and the rockers.kti file in 
>it, or do I just add a /etc/xdg/brltty/rockers.cti file? 

Put it right in brltty's xdg directory. Don't create a directory structure 
underneath it.

>I don't want to create conflicts with other drivers, if possible.

Yes, that's a risk. It was done this way in order to make it as easy as 
possible.

>As I mentioned, I would like to change rockers.kti .  My actual driver file is 
>in ht/alo.ktb.  This file imports rockers.kti (actually it imports a file that 
>imports another file).  So, if I leave alo.ktb alone and just change 
>rockers.kti, would the include path be updated only for this file or do I need 
>to copy all the included files? 

Just make a copy of the file you'd like to modify.

-- 
I believe the Bible to be the very Word of God: http://Mielke.cc/bible/
Dave Mielke   | 2213 Fox Crescent | WebHome: http://Mielke.cc/
EMail: d...@mielke.cc | Ottawa, Ontario   | Twitter: @Dave_Mielke
Phone: 1-613-726-0014 | Canada  K2A 1H7   |
___
This message was sent via the BRLTTY mailing list.
To post a message, send an e-mail to: BRLTTY@brltty.com
For general information, go to: http://brltty.com/mailman/listinfo/brltty