[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#509371: marked as done (installation-guide: Installation guide accessibility sections)

Your message dated Mon, 27 Apr 2009 18:47:30 +0000
with message-id <E1LyVrW-0002gn-Qo@ries.debian.org>
and subject line Bug#509371: fixed in installation-guide 20090427
has caused the Debian Bug report #509371,
regarding installation-guide: Installation guide accessibility sections
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@bugs.debian.org
immediately.)


-- 
509371: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=509371
Debian Bug Tracking System
Contact owner@bugs.debian.org with problems
--- Begin Message --- 
Package: installation-guide
Severity: normal
Tags: patch

Here is a patch that adds to installation-guide two accessibility
sections: in the supported hardware section, provide urls to lists
of supported braille displays and speech syntheses, and in the boot
section, document the boot parameters needed to enable accessibility
features.

Samuel

-- System Information:
Debian Release: 5.0
  APT prefers testing
  APT policy: (990, 'testing'), (500, 'unstable'), (500, 'stable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.27 (SMP w/2 CPU cores)
Locale: LANG=fr_FR.UTF-8, LC_CTYPE=fr_FR.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash

Index: build/entities/urls.ent
===================================================================
--- build/entities/urls.ent	(révision 56918)
+++ build/entities/urls.ent	(copie de travail)
@@ -202,7 +202,14 @@
 
 <!ENTITY url-simtel "ftp://ftp.simtel.net/pub/simtelnet/msdos/";>
 
+<!ENTITY url-brltty "http://www.mielke.cc/brltty/";>
+<!ENTITY url-brltty-driver-codes "http://www.mielke.cc/brltty/doc/Manual-BRLTTY/English/BRLTTY-11.html";>
+<!ENTITY url-brltty-table-codes "http://www.mielke.cc/brltty/doc/Manual-BRLTTY/English/BRLTTY-6.html";>
 
+<!ENTITY url-speakup "http://www.linux-speakup.org/";>
+<!ENTITY url-speakup-driver-codes "http://www.linux-speakup.org/spkguide.txt";>
+
+
 <!-- ****************************************** m68k links -->
 <!--
    urls that I need to absorb or point to:
Index: build/entities/common.ent
===================================================================
--- build/entities/common.ent	(révision 56918)
+++ build/entities/common.ent	(copie de travail)
@@ -126,6 +126,12 @@
 <!-- version of X11 shipping with the current release -->
 <!ENTITY x11ver "7.3">
 
+<!-- version of BRLTTY shipping with the current release -->
+<!ENTITY brlttyver "3.10">
+
+<!-- version of Speakup shipping with the current release -->
+<!ENTITY speakupver "3.0.3">
+
 <!-- an example of adding another image to lilo.conf, cf
      en/post-install.sgml etc. -->
 <!ENTITY additional-lilo-image
Index: build/templates/docstruct.ent
===================================================================
--- build/templates/docstruct.ent	(révision 56918)
+++ build/templates/docstruct.ent	(copie de travail)
@@ -29,6 +29,7 @@
    <!ENTITY supported-sparc.xml         SYSTEM "##SRCPATH##/hardware/supported/sparc.xml">
   <!ENTITY network-cards.xml            SYSTEM "##SRCPATH##/hardware/network-cards.xml">
   <!ENTITY supported-peripherals.xml    SYSTEM "##SRCPATH##/hardware/supported-peripherals.xml">
+  <!ENTITY accessibility-hardware.xml   SYSTEM "##SRCPATH##/hardware/accessibility.xml">
   <!ENTITY buying-hardware.xml          SYSTEM "##SRCPATH##/hardware/buying-hardware.xml">
   <!ENTITY installation-media.xml       SYSTEM "##SRCPATH##/hardware/installation-media.xml">
   <!ENTITY memory-disk-requirements.xml SYSTEM "##SRCPATH##/hardware/memory-disk-requirements.xml">
@@ -94,6 +95,7 @@
   <!ENTITY boot-installer-s390.xml         SYSTEM "##SRCPATH##/boot-installer/s390.xml">
   <!ENTITY boot-installer-sparc.xml        SYSTEM "##SRCPATH##/boot-installer/sparc.xml">
   <!ENTITY boot-installer-parameters.xml   SYSTEM "##SRCPATH##/boot-installer/parameters.xml">
+  <!ENTITY boot-installer-accessibility.xml   SYSTEM "##SRCPATH##/boot-installer/accessibility.xml">
   <!ENTITY boot-installer-trouble.xml      SYSTEM "##SRCPATH##/boot-installer/trouble.xml">
 
  <!ENTITY using-d-i.xml                  SYSTEM "##SRCPATH##/using-d-i/using-d-i.xml">
Index: en/hardware/hardware-supported.xml
===================================================================
--- en/hardware/hardware-supported.xml	(révision 56918)
+++ en/hardware/hardware-supported.xml	(copie de travail)
@@ -399,6 +399,7 @@
   </sect2>
 
 &network-cards.xml;
+&accessibility-hardware.xml;
 &supported-peripherals.xml;
 
  </sect1>
Index: en/hardware/accessibility.xml
===================================================================
--- en/hardware/accessibility.xml	(révision 0)
+++ en/hardware/accessibility.xml	(révision 0)
@@ -0,0 +1,29 @@
+<!-- retain these comments for translator revision tracking -->
+<!-- $Id: accessibility-hardware.xml $ -->
+
+ <sect2 id="braille-displays">
+ <title>Braille Displays</title>
+<para>
+
+Debian's support for braille displays is determined by the underlying
+support found in BRLTTY. Most displays work under BRLTTY, via serial, USB
+or bluetooth. Details on supported braille devices can be found at <ulink
+url="&url-brltty;"></ulink>. Debian &release; ships with BRLTTY version
+&brlttyver;.
+
+</para>
+ </sect2>
+
+ <sect2 id="hardware-speech-syntheses" arch="x86">
+ <title>Hardware Speech Syntheses</title>
+<para>
+
+Debian's support for hardware speech syntheses is determined by the underlying
+support found in Speakup. Speakup only supports integrated boards and external
+devices connected through Serial (no USB or serial-to-USB adapters are
+supported).  Details on supported hardware speech syntheses can be found at
+<ulink url="&url-speakup;"></ulink>. Debian &release; ships with Speakup version
+&speakupver;.
+
+</para>
+ </sect2>
Index: en/boot-installer/accessibility.xml
===================================================================
--- en/boot-installer/accessibility.xml	(révision 0)
+++ en/boot-installer/accessibility.xml	(révision 0)
@@ -0,0 +1,92 @@
+<!-- retain these comments for translator revision tracking -->
+<!-- $Id: boot-installer-accessibility.xml $ -->
+
+ <sect1 id="boot-installer-accessibility"><title>Accessibility</title>
+<para>
+
+Some people may need particular support due to e.g. visual impairment.  USB
+braille displays are automatically detected, but most other accessibility
+features have to be enabled by hand.  On machines that support it, the boot
+menu emits a beep when it is ready to receive keystrokes.  Some boot parameters
+can then be appended to enable accessibility features.  Note that on most
+architectures the boot loader interprets your keyboard as a QWERTY keyboard.
+
+</para>
+
+<sect2><title>USB Braille Displays</title>
+
+<para>
+
+USB braille displays should be automatically detected.  A textual version of
+the installer will then be automatically selected, and support for the braille
+display will be automatically installed on the target system.  You can thus just
+press &enterkey; at the boot menu.  Once BRLTTY is started,
+you can choose a braille table by entering the preference menu.
+
+</para>
+
+  </sect2>
+  <sect2><title>Serial Braille Displays</title>
+
+<para>
+
+Serial braille displays can not safely be automatically detected
+(since that may brick some of them).  You thus need to append the
+<userinput>brltty=driver,port,table</userinput> boot parameter to tell
+BRLTTY which driver it should use. <userinput>driver</userinput>
+should be replaced by the two-letter driver core for your terminal,
+see <ulink url="&url-brltty-driver-codes;"></ulink> for a list.
+<userinput>device</userinput> should be replaced by the name of the serial
+port the display is connected to, <userinput>ttyS0</userinput> is the default.
+<userinput>table</userinput> is the name of the braille table to be used, see
+<ulink url="&url-brltty-table-codes;"></ulink> for a list, the english table
+is the default.  Note that the table can be changed later by entering the
+preference menu.
+
+</para>
+
+  </sect2>
+
+  <sect2 arch="x86"><title>Hardware Speech Syntheses</title>
+
+<para>
+
+Support for hardware speech syntheses is enabled only along support for
+graphical installer.  You thus need to select the <computeroutput>Graphical
+install</computeroutput> entry in the boot menu.
+
+Hardware speech syntheses can not be automatically detected.  You thus need
+to append the <userinput>speakup.synth=driver</userinput> boot parameter
+to tell Speakup which driver it should use. <userinput>driver</userinput>
+should be replaced by the driver code for your device, see <ulink
+url="&url-speakup-driver-codes;"></ulink> for a list.  The textual version of
+the installer will then be automatically selected, and support for the speech
+synthesis will be automatically installed on the target system.
+
+</para>
+
+  </sect2>
+  <sect2><title>Board-based Devices</title>
+
+<para>
+
+Some accessibility devices are actual boards that are plugged inside
+the machine and that directly read text from the video memory.  To get
+them working the framebuffer support must be disabled by using the
+<userinput>fb=false</userinput> boot parameter.
+
+</para>
+
+  </sect2>
+  <sect2><title>High-Contrast Theme</title>
+
+<para>
+
+For people with low vision, the installer can use a high-contrast
+theme that makes it more readable.  To enable it, append the
+<userinput>theme=dark</userinput> boot parameter.
+
+</para>
+
+  </sect2>
+ </sect1>
Index: en/boot-installer/boot-installer.xml
===================================================================
--- en/boot-installer/boot-installer.xml	(révision 56918)
+++ en/boot-installer/boot-installer.xml	(copie de travail)
@@ -44,6 +44,7 @@
 
  </sect1>
 
+&boot-installer-accessibility.xml;
 &boot-installer-parameters.xml;
 &boot-installer-trouble.xml;

--- End Message ---
--- Begin Message --- 
Source: installation-guide
Source-Version: 20090427

We believe that the bug you reported is fixed in the latest version of
installation-guide, which is due to be installed in the Debian FTP archive:

installation-guide-alpha_20090427_all.deb
  to pool/main/i/installation-guide/installation-guide-alpha_20090427_all.deb
installation-guide-amd64_20090427_all.deb
  to pool/main/i/installation-guide/installation-guide-amd64_20090427_all.deb
installation-guide-arm_20090427_all.deb
  to pool/main/i/installation-guide/installation-guide-arm_20090427_all.deb
installation-guide-hppa_20090427_all.deb
  to pool/main/i/installation-guide/installation-guide-hppa_20090427_all.deb
installation-guide-i386_20090427_all.deb
  to pool/main/i/installation-guide/installation-guide-i386_20090427_all.deb
installation-guide-ia64_20090427_all.deb
  to pool/main/i/installation-guide/installation-guide-ia64_20090427_all.deb
installation-guide-mips_20090427_all.deb
  to pool/main/i/installation-guide/installation-guide-mips_20090427_all.deb
installation-guide-mipsel_20090427_all.deb
  to pool/main/i/installation-guide/installation-guide-mipsel_20090427_all.deb
installation-guide-powerpc_20090427_all.deb
  to pool/main/i/installation-guide/installation-guide-powerpc_20090427_all.deb
installation-guide-s390_20090427_all.deb
  to pool/main/i/installation-guide/installation-guide-s390_20090427_all.deb
installation-guide-sparc_20090427_all.deb
  to pool/main/i/installation-guide/installation-guide-sparc_20090427_all.deb
installation-guide_20090427.dsc
  to pool/main/i/installation-guide/installation-guide_20090427.dsc
installation-guide_20090427.tar.gz
  to pool/main/i/installation-guide/installation-guide_20090427.tar.gz



A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 509371@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Frans Pop <fjp@debian.org> (supplier of updated installation-guide package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Format: 1.8
Date: Mon, 27 Apr 2009 13:23:30 +0200
Source: installation-guide
Binary: installation-guide-alpha installation-guide-amd64 installation-guide-arm installation-guide-hppa installation-guide-i386 installation-guide-ia64 installation-guide-mips installation-guide-mipsel installation-guide-powerpc installation-guide-s390 installation-guide-sparc
Architecture: source all
Version: 20090427
Distribution: unstable
Urgency: low
Maintainer: Debian Install System Team <debian-boot@lists.debian.org>
Changed-By: Frans Pop <fjp@debian.org>
Description: 
 installation-guide-alpha - Debian installation guide
 installation-guide-amd64 - Debian installation guide
 installation-guide-arm - Debian installation guide
 installation-guide-hppa - Debian installation guide
 installation-guide-i386 - Debian installation guide
 installation-guide-ia64 - Debian installation guide
 installation-guide-mips - Debian installation guide
 installation-guide-mipsel - Debian installation guide
 installation-guide-powerpc - Debian installation guide
 installation-guide-s390 - Debian installation guide
 installation-guide-sparc - Debian installation guide
Closes: 509371 509372 518018 519508 520582
Changes: 
 installation-guide (20090427) unstable; urgency=low
 .
   [ Colin Watson ]
   * Document partman/early_command (added in partman-base 129).
   * Add note about preseeding ownership to preseed-seenflag section, since I
     had a user confused by this who hadn't found the note elsewhere
     explaining owners.
   * Use /dev/sda and /dev/sdb in the RAID preseeding example rather than
     /dev/discs/disc0/disc and /dev/discs/disc1/disc, since the latter
     devices no longer exist.
   * Document noshell boot parameter. See #504381.
   * Clarify behaviour of "auto" preseed alias.
   * Clarify that preseeding aliases are only aliases for question names, and
     that a value is always needed as well.
   * Apparently you can pass extra boot parameters to OpenBoot at the end of
     the 'boot' command. Document this as it has been known to cause some
     confusion.
 .
   [ Frans Pop ]
   * Document preseeding of network-console now that its postinst can be
     relied on to be executed.
   * Update info on passing boot parameter for PPPoE.
   * Explain Standard system task.
   * Add LXDE desktop environment.
   * Mention option to select desktop environment from boot menu for x86 CDs.
   * Add task sizes for alternative desktop environments.
   * chroot install: 'tzconfig' is deprecated for 'dpkg-reconfigure tzdata'.
     Closes: #520582.
   * Booting using LILO or GRUB: minor improvements. Closes: #519508.
   * Fix example how to generate md5-encoded password. Closes: #518018.
   * Fix missing tags in Japanese translation. Closes: #509372.
   * Improve script that extracts preconfiguration example file from appendix.
 .
   [ Samuel Thibault ]
   * Document accessibility support. Closes: #509371.
 .
   [ Frans Pop ]
   * (Re-)enable Vietnamese translation (not fully up-to-date).
   * Convert PO translations for Finnish, Korean and Vietnamese to XML using
     their last fully translated version.
   * Release update of the manual for Lenny. Six translations have not been
     updated: Brazilian, Catalan, Finnish, Korean, Spanish and Vietnamese.
Checksums-Sha1: 
 d2686ab8b149bc59839196712579cae9e44e90b8 1603 installation-guide_20090427.dsc
 fceaadd5fdb31e3de0868095ed053c0bb565cff5 6910964 installation-guide_20090427.tar.gz
 fef5eed13e641713ee4763b79dd0ed15a012c949 15908338 installation-guide-alpha_20090427_all.deb
 fbbfbfcd7c63351fdf09447fbb5d418a22012d77 18019230 installation-guide-amd64_20090427_all.deb
 0daabbc1b370982d1cc6b6105202ba125796b52e 15449010 installation-guide-arm_20090427_all.deb
 a2da6e7fa01d653233abde7eb7bbc9d78665ff88 14905390 installation-guide-hppa_20090427_all.deb
 c43d380fc860f5ce853e51642c9c161157166888 18139616 installation-guide-i386_20090427_all.deb
 0618a2882ac3cd3d33e19afe0413ac70058df41d 15873952 installation-guide-ia64_20090427_all.deb
 88d0c3e2dd489f37e85c67f6a67c12eb6312cb3d 15111492 installation-guide-mips_20090427_all.deb
 c1c29f3459a2c38908adf09bbc725fdb74d3e58e 15037532 installation-guide-mipsel_20090427_all.deb
 cbcc07927486193425f9183f8bb0a925ffae8e0e 17168242 installation-guide-powerpc_20090427_all.deb
 e827cb5d20bfa37414c4e1bf3f3c02b9897bb417 13790234 installation-guide-s390_20090427_all.deb
 9da042115d9bd2a7eca8fdb1c9ac3de4e73e456f 15716194 installation-guide-sparc_20090427_all.deb
Checksums-Sha256: 
 0efae080a5a55e930e9e44808fd4b7d4e1da9894acca2aa07b4d8ea135a3d2ed 1603 installation-guide_20090427.dsc
 0dfd987ed62df11dc77f53eb7812423887c6eadcfc464deb7d0bff5455576629 6910964 installation-guide_20090427.tar.gz
 e16fd620716d5b8d5b246ef752db85d62d1b970fd56c0904a89f29021eb8f24c 15908338 installation-guide-alpha_20090427_all.deb
 5b7f23495d0a7b927311e81378b97a022ebc4d9244ba09ddf216969d6d2effee 18019230 installation-guide-amd64_20090427_all.deb
 13a866ed3f7049c5905403539430bd60c868f3c5102f2e49404801c04a0f6fce 15449010 installation-guide-arm_20090427_all.deb
 10be9b266a21ef11d855e017dc1c382ba03311196b29048d053b2d9e17ab7381 14905390 installation-guide-hppa_20090427_all.deb
 25d48c269e8a4b064d636df85da7b34973357dc462c61ed302e867c3ab40163d 18139616 installation-guide-i386_20090427_all.deb
 488659d3c1f6cc28619bcdfe47414158b25d693120206d122215d65652b3d92a 15873952 installation-guide-ia64_20090427_all.deb
 1cba9f5ddcc405b4cf115c02a64808bff66a1553f7878a9675e59bf694cff2ee 15111492 installation-guide-mips_20090427_all.deb
 36aebd37a4e7a7a6d4983b5a1fc482ec43aa6b5055f3bc4ceac452a3baa45e98 15037532 installation-guide-mipsel_20090427_all.deb
 68a7a28b401ec33bf32f252f9a2f06f93a9099009722a6e941f48feb63bc3879 17168242 installation-guide-powerpc_20090427_all.deb
 dfd1a5fd4583e6ce5a78f55be1af9ef717c5eb85e7722f305acef92ae5145e00 13790234 installation-guide-s390_20090427_all.deb
 826ec3e221bef2b72066e38c6928f55aa1a803ca8e03d7102633cb403c3b3345 15716194 installation-guide-sparc_20090427_all.deb
Files: 
 f6be83f1ca7986fbd326f04185923c0e 1603 doc optional installation-guide_20090427.dsc
 a12e217c46c7f1369bda4c8640259fb8 6910964 doc optional installation-guide_20090427.tar.gz
 24a0389cda7c6df0dc838243743a2fc4 15908338 doc optional installation-guide-alpha_20090427_all.deb
 2d96cf5f53f49aab206292090dbdc790 18019230 doc optional installation-guide-amd64_20090427_all.deb
 9fe4fd2b57c2f324d1521e34591b518b 15449010 doc optional installation-guide-arm_20090427_all.deb
 7e694d600332420430bf4a6042ddf067 14905390 doc optional installation-guide-hppa_20090427_all.deb
 c6dd0fae7bcfa2dfddc184567a451ffd 18139616 doc optional installation-guide-i386_20090427_all.deb
 29f1f72f2197d04aff5a616f99ae8930 15873952 doc optional installation-guide-ia64_20090427_all.deb
 25e3c5686c6937ec425fe54a0c20f218 15111492 doc optional installation-guide-mips_20090427_all.deb
 b972e71fa4d96e9231a6bc359379c09a 15037532 doc optional installation-guide-mipsel_20090427_all.deb
 fd9fda1e70eef3ef91bcc68f29dd7da8 17168242 doc optional installation-guide-powerpc_20090427_all.deb
 cca717ae4e28559dbd8dc730a9f252db 13790234 doc optional installation-guide-s390_20090427_all.deb
 88866886c4f0e342f88548304ad4c772 15716194 doc optional installation-guide-sparc_20090427_all.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)

iEYEARECAAYFAkn16kcACgkQgm/Kwh6ICoT5bwCgs7LzKdBPt/aY5U9jX9TJvGBo
iLkAoI1i1woHj66mF9o+X2xPJfzl9Cf7
=1MCE
-----END PGP SIGNATURE-----

--- End Message ---
Reply to: