File: README.testing

package info (click to toggle)
emacspeak 53.0%2Bdfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 33,748 kB
  • sloc: lisp: 56,394; xml: 52,463; tcl: 1,333; cpp: 1,168; sh: 859; makefile: 739; python: 547; perl: 509; javascript: 191; ansic: 82
file content (109 lines) | stat: -rw-r--r-- 3,439 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
This document describes how one could quickly test if a new package works
resonably well. The idea was posted on
http://lists.debian.org/debian-accessibility/2013/10/msg00026.html

Emacspeak comes with a software synthesiser in the package
emacspeak-espeak-server I recommend to test emacspeak with that
synthesiser to also confirm that that works. If not the case after
installation of emacspeak-espeak-server, you need the following in
/etc/emacspeak.conf:

paul@wollumbin ~ $ cat /etc/emacspeak.conf
# emacspeak configuration file
#
#
if [ "$DTK_PROGRAM" = "" ]; then
DTK_PROGRAM=espeak
fi
if [ "$DTK_TCL" = "" ]; then
DTK_TCL=tcl
fi
if [ "$DTK_PORT" = "" ]; then
DTK_PORT=none
fi
if [ "$DTK_DEVICE" = "" ]; then
DTK_DEVICE="espeak"
fi
export DTK_PROGRAM DTK_PORT DTK_DEVICE
if [ "$DTK_TCL" != "" ]; then export DTK_TCL; fi
# End of /etc/emacspeak.conf

=================

Below you find the contents of the EmacspeakTestingGuide wiki
(https://wiki.debian.org/EmacspeakTestingGuide) as it appeared on 20 June 2014. I
recommend checking that page if there is more up-to-date information
(and update this file if there is).

These are the steps to test whether Emacspeak release (our releases) works
correctly.

Startup

Start Emacspeak using "emacspeak -q" command, that is without launching user
init file. On startup Emacspeak plays a melody and speaks a message "Press
... perfectly". However the melody is only heard when a required mp3 playback
program is present, probably mplayer. So don't worry if you don't hear the
melody, but the message should be there.

Movement

Every movement command should cause the part that was moved by to be
spoken. Try moving with arrows to hear the letters or lines. Try M-f M-b to
hear the words. This may be tested on welcome page.

Vulnerable commands

Try these commands whether they don't cause an unwanted behaviour or errors.

    S-down moves down bypassing empty lines C-right goes to next buffer M-x
    rmail - opens rmail application

Read only message

Create a new buffer, mark it as read only, try to type something. You should
hear: "capital buffer is read hyphen only".

    C-x C-f aaa M-x toggle-read-only type a letter

Info pages

Info pages were not always working correctly. In gui Emacs some of them were
silent. Try movement commands (char, word, line) in 2 info buffers:

    M-: (info "(Emacs)") press Next to go to another info page

Transient mode

Try if transient mark mode works as expected. In some version it did not.

    C-x C-b - select "scratch" buffer with enter key or mouse go to the
    beginning of line 3 C-space - mark the end of selection move to the
    beginning of line 2, line 2 highlights in yellow

    M-x replace-string <enter> t <enter> X <enter>

The letter t should change to X, but only in the second line.

Auditory icons

Auditory icons are funny sounds announcing things happening during edition and
movement.

    C-e C-a - turn them on C-home - icon is played C-spc - another icon is
    played C-/ - undo, yet another icon

Undo

Check if undo bug is present:

    C-x C-f bbb - creates a new buffer Type "12" Go left delete (only "1"
    remains) Type "3" Buffer consists of "13" C-/ - undo, several undo presses
    should make the buffer empty again. The bug caused switching back and forth
    the last change.

Emacspeak version

Test if the version Emacspeak presents is really the one it should be.

    M-: emacspeak-version