[Ubuntu Wiki] Update of "SpokenBoot" 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/SpokenBoot

The comment on the change is:
Fix some typos, and merge the EarlySpeechDispatcher spec into this one.

------------------------------------------------------------------------------
   * '''Launchpad Entry''': https://launchpad.net/distros/ubuntu/+spec/spoken-boot
   * '''Created''': 2006-06-11 by LukeYelavich
   * '''Contributors''':
-  * '''Packages affected''': speech-dispatcher, speechd-up, lsb-base
+  * '''Packages affected''': speech-dispatcher, speechd-up, lsb-base, initscripts, alsa-utils, alsa-lib
  
  == Summary ==
  
@@ -22, +22 @@

  
  == Scope ==
  
- This specification will discuss the implementation of spoken feedback for the Ubuntu boot process.
+ This specification will discuss the loading of speech-dispatcher to provide software speech as early as possible, and the implementation of spoken feedback for the Ubuntu boot process.
  
  == Design ==
  
@@ -30, +30 @@

  
  == Implementation ==
  
+  * Sound services would have to be loaded a lot earlier in the boot process, so that speech-dispatcher has a sound card to use in the event that one is needed.
+  * A special init script would be written that would be executed when the filesystem was mounted read-only. The script would take care of loading a specially built copy of the speech-dispatcher daemon that would point to a config file with alternate log locations set. When the filesystem was remounted read-write, the same, or possibly another script would shut down the currently running daemon, and restart speech-dispatcher normally.
- Functions for handling speech output will be added to /lib/lsb/init-functions. Function calls will then be placed in other important functions such as log_begin_msg and log_end_msg. The amount of information that is spoken will depend on the setting stored in a config file called by the speech functions. Three possible options will be available, none, fail, and all. By default, none wil be set. Fail will only speak any information related to a process that fails to function for any reason, i.e call log_end_msg with a nonzero value. All will cause all information to be spoken.
+  * Functions for handling speech output will be added to /lib/lsb/init-functions. Function calls will then be placed in other important functions such as log_begin_msg and log_end_msg. The amount of information that is spoken will depend on the setting stored in a config file called by the speech functions. Three possible options will be available, none, fail, and all. By default, none wil be set. Fail will only speak any information related to a process that fails to function for any reason, i.e call log_end_msg with a nonzero value. All will cause all information to be spoken.
- 
- The speech functions will check whether the configuration is either set to fail or all. If so, a check for the running of speech-dispatcher will be made. If successful, the requested text will be spoken.
+  * The speech functions will check whether the configuration is either set to fail or all. If so, a check for the running of speech-dispatcher will be made. If successful, the requested text will be spoken.
- 
- The /etc/init.d/checkfs.sh script will also be modified to provide checks for a configuration option to enable a screen reader if the fsck fails. These modifications could easily make use of init-functions, to keep all spoken feedback code in the same place.
+  * The /etc/init.d/checkfs.sh script will also be modified to provide checks for a configuration option to enable a screen reader if the fsck fails. These modifications could easily make use of init-functions, to keep all spoken feedback code in the same place.
- 
- If the screen reader option is set to yes, a check for speech-dispatcher running will be performed. If not, it will be loaded. The speakup screen reader will also be loaded. Once the user exits from the shell set up after the failed fsck, the screen reader may be unloaded, and spoken feedback will be set to something other than its original setting, depending on more options in the configuration file.
+  * If the screen reader option is set to yes, a check for speech-dispatcher running will be performed. If not, it will be loaded. The speakup screen reader will also be loaded. Once the user exits from the shell set up after the failed fsck, the screen reader may be unloaded, and spoken feedback will be set to something other than its original setting, depending on more options in the configuration file.
  
  === Code ===
  
@@ -44, +43 @@

  
  == Outstanding issues ==
  
-  * The SpeakupInclusion and EarlySpeechDispatcher specs have to be implemented before this spec can be useful.
+  * The SpeakupInclusion spec needs to be implemented before this spec can be useful.
-  * speechd-up needs to be promoted to main for screen reader functionality.
+  * Some form of sound card setup needs to be performed before speech-dispatcher can be used at early boot. Since soundcards havent been loaded yet, a mechanism for determining the default sound card module to use would be necessary. Sound libraries would also need to exist in /lib, due to /usr not being mounted yet.
+  * speech-dispatcher and speechd-up need to be promoted to main.
   * Any packages that do not use init-functions in their init scripts will have to be changed.
  
  == BoF agenda and discussion ==