Update d/changelog for release 8.4.1-1
[pkg-a11y/daisy-player.git] / debian / README.testing
1 This document describes how one could quickly test if a new package works
2 resonably well. The idea was posted on
3 http://lists.debian.org/debian-accessibility/2013/10/msg00026.html
4
5 Preface: daisy-player was originally written to start reading CD's from
6 the CD-rom drive. I don't even have such a drive, so I don't use that
7 feature. To disable CD-rom usage I start daisy-player with input.
8 Additionally, I have added /dev/null as CD device in daisy-player, but I
9 don't think that is necessary. As I don't use CD's also the cddb option
10 is useless for me, so the first time I use daisy-player I start with the
11 -n option.
12
13 As daisy-player is a reader of DAISY books, you need some DAISY books to
14 start with. I recommend downloading at least one version 2.02 and one
15 version 3 book from http://www.daisy.org/sample-content. E.g. "A Light
16 Man" and "Are You Ready". The files come zipped, so you need to unzip them.
17
18 paul@wollumbin ~/daisy-player/samples $ wget http://www.daisy.org/samples/202toc-only/light-man.zip
19 paul@wollumbin ~/daisy-player/samples $ unzip light-man.zip
20
21 daisy-player needs a console, so start it in a terminal window. You can
22 run daisy-player against the directory holding the files you just
23 unzipped. daisy-player is made for 24 lines x 80 chars, if your window
24 is smaller, text might appear funny.
25
26 paul@wollumbin ~/daisy-player/samples $ daisy-player -n light-man
27
28 - You should get a screen with two info lines of daisy-player and then
29   the content of the book.
30 - Pressing h should bring you the help, then pressing any key (twice)
31   should return you to the normal screen.
32 - Pressing enter should start the reading and you should be able to hear
33   the text.
34 - Pressing Cursor Down should scroll down to new sections, hitting enter
35   should start reading that section
36 - Hitting q should quite gracefully.
37
38 paul@wollumbin ~/daisy-player/samples $ wget http://www.daisy.org/samples/3full-text-full-audio/are-you-ready-z3986.zip
39 paul@wollumbin ~/daisy-player/samples $ unzip are-you-ready-z3986.zip
40 paul@wollumbin ~/daisy-player/samples $ daisy-player Are_you_ready_z3986
41
42 - You should get a screen with the content of the book. You will only
43   see the first 22 sections of the book, there is one more (PageDown).
44 - Pressing l allows you to scroll the chapters with Cursor Up/Down,
45   pressing l again allows you to scroll the paragraphs.
46 - Pressing enter should start the reading where you are and you should
47   be able to hear the text.
48 - Hitting q should quite gracefully.
49 - Restarting daisy-player as before should start where you were the last
50   time you "read" this book.
51
52 daisy-player stores it's current configuration in ~/.daisy-player.rc and
53 places bookmarks in ~/.daisy-player/ You might want to backup/remove
54 those to restore default settings. (Don't edit while daisy-player is
55 running or it will be overwritten.)
56
57 Lastly, testing if the translations still work is also nice:
58 paul@wollumbin ~/daisy-player/samples $ LANGUAGE=nl_NL daisy-player Are_you_ready_z3986