[Ubuntu Wiki] Update of "SpeakupInclusion" by LukeYelavich

[Ubuntu Wiki]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Ubuntu Wiki" for change notification.

The following page has been changed by LukeYelavich:
https://wiki.ubuntu.com/SpeakupInclusion

The comment on the change is:
Fixed typos, and reworked some other info.

------------------------------------------------------------------------------
   * '''Launchpad Entry''': https://launchpad.net/distros/ubuntu/+spec/speakup-inclusion
   * '''Created''': 2006-05-18 by LukeYelavich
   * '''Contributors''':
-  * '''Packages affected''':  linux-source
+  * '''Packages affected''':  linux-source-2.6.17
  
  == Summary ==
  
- Include the [http://www.linux-speakup.org Speakup Screen Reader] in Ubuntu.
+ Include the [http://www.linux-speakup.org Speakup Screen Reader] in the Ubuntu kernels, and provide some extra user-space enhancements to make working with speakup easier for users.
  
  == Rationale ==
  
- The Speakup screen reader is one of the most well known screen readers available for the Linux console. Ubuntu has a screen reader for the GNOME desktop, but does not yet have one that can be used on the console, especially in cases where X/GNOME may not be available.
+ The Speakup screen reader is one of the most well known screen readers available for the Linux console. Ubuntu has a screen reader for the GNOME desktop, but does not yet have one that can be used on the console, especially in cases where X/GNOME may not be available. Blind users may also wish to be able to administer servers, which only have the console available, and may need direct access, requiring a screen reader to accomplish their work.
  
  == Use cases ==
  
-  * David is a regular user of the various GNOME screen readers to accomplish daily tasks. However, for some reason, X will not boot, probably due to an error in his X config file. He eeds a screen reader for the console so he can go and manually edit the file.
+  * David is a regular user of the various GNOME screen readers to accomplish daily tasks. However, for some reason, X will not boot, probably due to an error in his X config file. He needs a screen reader for the console so he can go and manually edit the file.
   * Joe is totally blind, and wants to set up a server install of Ubuntu. He needs a screen reader for the install, as well as for the running system, so he can easily get the server up and running, and will have a way to get feedback if he ever has to return to do work on the server locally.
  
  == Scope ==
  
- This spec will discuss getting the speakup patches included into the Ubuntu kernel tree, as well as some userspace enhancements to make working with speakup easier for the user.
+ This specification will discuss getting the speakup patches included into the Ubuntu kernel tree, as well as some userspace enhancements to make working with speakup easier for the user.
  
  == Design ==
  
@@ -30, +30 @@

  
  Speakup consists of several kernel modules. Two modules are the core of the screen reader, one of which is only loaded when the user enables keyboard help, to learn about the various keystrokes that speakup has. The rest of the modules are for the different speech synthesizers that speakup supports. Speakup provides an easy mechanism for switching between speech synthesizers, as well as changing various speech parameters for the currently loaded speech synthesizer. Luckily, these parameters can be changed by normal users, and speakup handles the loading of modules automatically, if the need arises.
  
- Speakup also comes with various user-space utilities to load and save speakup configurations, and allow users to create and use custom keystrokes. These utilities, along with some extra scripts for better user configuration management will be provided in a package called speakup-userspace. Of particular note, is an init script which will load the speakup module at system startup, so that users can simply type a command to start using speakup with a speech synthesizer. Note that the speakup module loaded on its own will not have any effect on the currently runnin system.
+ Speakup also comes with various user-space utilities to load and save speakup configurations, and allow users to create and use custom keystrokes. These utilities, along with some extra scripts for better user configuration management will be provided in a package called speakup-userspace. Of particular note, is an init script which will load the speakup module at system startup, so that users can simply type a command to start using speakup with a speech synthesizer. Note that the speakup module loaded on its own will not have any effect on the currently running system.
  
  == Implementation ==
  
@@ -46, +46 @@

  
  == Outstanding issues ==
  
-  * As software speech synthesizers will be the most common form of synthesis used with speakup, the EarlySpeechDispatcher spec needs to be implemented for software speech to be usable as a default speech synthesizer.
+  * As software speech synthesizers will be the most common form of synthesis used with speakup, speech-dispatcher needs to be promoted to main, and reworked to ensure flite does not get included by default.
  
  == BoF agenda and discussion ==