Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/geert/linux...
[linux-btrfs-devel.git] / drivers / staging / speakup / TODO
blobc3612e4b8ac817b860b2a08679c690a2baf8c252
1 Speakup project home:  http://www.linux-speakup.org
3 Mailing List:  speakup@braille.uwo.ca
5 Speakup is a kernel based screen review package for the linux operating
6 system.  It allows blind users to interact with applications on the
7 linux console by means of synthetic speech.
9 Currently, speakup has several issues we know of.
11 The first issue has to do with the way speakup communicates with serial
12 ports.  Currently, we communicate directly with the hardware
13 ports. This however conflicts with the standard serial port drivers,
14 which poses various problems. This is also not working for modern hardware
15 such as PCI-based serial ports.  Also, there is not a way we can
16 communicate with USB devices.  The current serial port handling code is
17 in serialio.c in this directory.
19 Some places are currently using in_atomic() because speakup functions
20 are called in various contexts, and a couple of things can't happen
21 in these cases. Pushing work to some worker thread would probably help,
22 as was already done for the serial port driving part.
24 There is a duplication of the selection functions in selections.c. These
25 functions should get exported from drivers/char/selection.c (clear_selection
26 notably) and used from there instead.
28 The kobjects may have to move to a more proper place in /sys. The
29 discussion on lkml resulted to putting speech synthesizers in the
30 "speech" class, and the speakup screen reader itself into
31 /sys/class/vtconsole/vtcon0/speakup, the nasty path being handled by
32 userland tools.
34 Another issue seems to only happen on SMP systems.  It seems
35 that text in the output buffer gets garbled because a lock is not set.
36 This bug happens regularly, but no one has been able to find a situation
37 which produces it consistently.
39 Patches, suggestions, corrections, etc, are definitely welcome.
41 We prefer that you contact us on the mailing list; however, if you do
42 not want to subscribe to a mailing list, send your email to all of the
43 following:
45 w.d.hubbs@gmail.com, chris@the-brannons.com, kirk@braille.uwo.ca and
46 samuel.thibault@ens-lyon.org.