Rockbox mail archiveSubject: RE: Rockbox Manual (was Re: Turning off a song while playing on iAudiosx5)
RE: Rockbox Manual (was Re: Turning off a song while playing on iAudiosx5)
From: Tim Culhane <tim.culhane_at_criticalpath.net>
Date: Mon, 17 Jul 2006 09:11:10 +0100
I think the real problem with regards the pdf manual is the way in which
the pdf is generated. As I understand it the pdf is generated using latX,
and as a result, the accessibility of the pdf document is very poor when
read using a screen reader.
For example, I have pasted below the text which is produced when I read
page 21 of the manual:
Navigating the Main Menu
Moves up in the menu.
Inside a setting, increases the value or chooses
Moves down in the menu.
Insidea setting, decreases the value or chooses
Exits menu, setting or moves to parent menu
Figure 3.2.: The list bookmarks screen
IftheSAVEALISTOFRECENTLYCREATEDBOOKMARKS optionis enabledthenyoucan
viewalistofseveralrecent bookmarkshereand selectonetojump straighttothat
for more details on configuring bookmarking in Rockbox.
Note: This option is offby default.
TheSOUND SETTINGS menuoffersa selectionof soundpropertiesyoumay change
to customize your listening experience. The details of this menu are covered
starting on page
The GENERAL SETTINGS menu allows you to customize the way Rockbox looks and
As you can see, the structure of the document seems mixed up. Also, words
runtogether without spaces between them.
I'm not an expert on the best way of generating accessible pdf, but it is
possible (though by way of latX I'm not sure). Firstly the pdf needs to
be structured. The manual as it currently stands uses unstructured pdf.
More information on how to produce more accessible pdf can be found at
Hope this helps, and If anybody wants more help on this I'll be happy to
However, until the html version of the manual comes on stream I think that
a fully accessible manual is some way off.
From: rockbox-bounces_at_cool.haxx.se [mailto:rockbox-bounces_at_cool.haxx.se] On
Behalf Of Michael DiFebbo
Sent: 14 July 2006 17:45
Subject: Rockbox Manual (was Re: Turning off a song while playing on
Tim Culhane wrote:
> I'd look in the manual, but it relies on a diagram of the layout of
> the player, and I'm blind, so can't use that!
You raised this issue previously, and Dominik Riebeling asked you to
describe more specifically the problem that you are having. You did not
respond to his questions.
As Dominik noted, buttons are described throughout the Rockbox Manual.
As just one example, section 2.2.2 describes the File Menu. The second
sentence in that section says, "To access the File Menu, position the
selector over a file or folder and hold the Select button." What is
there about this description that is inadequate for you? Can you give
us examples of sections of the manual that cause you difficulty? We
would like to make the manual as accessible as possible, but we can't
help you unless you help us to identify the problem.
Received on 2006-07-17