This file is indexed.

/usr/share/doc/edbrowse/philosophy.html is in edbrowse 3.5.1-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
<HTML>
<FONT face=Arial,Helvetica,sans-serif size=4>
<HEAD>
<TITLE> The Command Line Philosophy </TITLE>
<LINK REL="SHORTCUT ICON" href="x.ico">
</HEAD>
<BODY bgcolor=white text=black link=red vlink=red alink=navy>

<H2 align=center> Command Line Programs for the Blind </H2>
<H4 align=center> by Karl Dahlke </H4>

<H3 align=center> Introduction </H3>

Word processors, Internet browsers, and email clients typically present information in two dimensions,
spreading text and icons across the screen.&nbsp;
This interface is remarkably efficient,
thanks to the parallel processing capabilities of the retina and the visual cortex.&nbsp;
In fact, this screen to brain interface is so efficient,
there is no need to count the bits as they fly by.&nbsp;
Amateur webmasters and professional software developers
routinely exploit this high band width channel, which is almost "too cheap to meter".&nbsp;
Web pages often present reams of irrelevant information
in the form of extraneous links and rarely used buttons and icons.&nbsp;
Carefully crafted applications are a little more organized,
but they still employ toolbars and widgits that clutter the screen.&nbsp;
This ancillary data is quickly tossed aside as your eyes focus on the item of interest.&nbsp;
However, a blind user cannot assimilate this data at a glance, and separate the wheat from the chaff.&nbsp;
He is forced to read every word on the page, using a voice synthesizer or braille display.&nbsp;
These adapters are imperfect at best,
as they ratchet the flow of information down to an agonizing crawl.&nbsp;
By analogy, a high speed cable modem has been replaced with a dial-up connection,
thus turning a rich multimedia experience into an exercise in frustration and futility.&nbsp;
Is there a practical alternative?

<P>
I believe there is, but certain critical applications must be rewritten from the ground up.&nbsp;
To this end, I have developed a combination editor/browser called edbrowse, which is 100% text based.&nbsp;
Output is measured and conserved like a precious commodity
as it passes through the narrow channel of speech or braille.&nbsp;
Edbrowse gives the blind user exactly what he asks for, no more and no less.&nbsp;
Sighted users also find its unique features helpful in certain situations, which will be described below.&nbsp;
This open source program is in the
<A href=http://www.the-brannons.com/edbrowse>
public domain</A>,
and is bundled in several Linux distributions.&nbsp;
An early perl version (with limited functionality) runs on virtually any computer.

<P>
This has implications for software development in general.&nbsp;
When a program or utility is "web based",
i.e. accessible through a browser,
with some common sense restrictions on the underlying html and javascript,
it is easily adapted to a wide range of disabilities.&nbsp;
Each user employs the browser that caters to his particular needs and preferences.&nbsp;
The interface is automatically tailored to the individual -
no additional programming is required.&nbsp;
The semantics of the data, and its representation on the screen, or in speech,
or on a braille display, have been neatly separated.&nbsp;
Of course this approach doesn't work for all applications,
(a blind user isn't going to play Flight Simulator),
but it can be employed in many situations.&nbsp;
Even a toolkit, such as Microsoft VB, might be enhanced
to create interactive web pages, instead of using the screen and the mouse.&nbsp;
If this project proves feasible,
a wide variety of common VB applications will become accessible over night.&nbsp;
The key is the accessible client, in this case a command line browser,
combined with a suite of streaming applications
that use these adapted clients as front end programs.

<P>
The benefits of this approach are not limited to the totally blind.&nbsp;
A color-blind individual might use his browser to change the color of the background,
text, headings, and hyperlinks to improve the contrast,
while A user with low vision might increase the font size.&nbsp;
Disabled users,
and folks who simply prefer their text in a particular font,
are hoping for a software revolution,
that sequesters functionality within the application,
and leaves the details of the interface unspecified,
to be determined by the wants and needs of the individual.

<P>
Google is taking the lead in this effort.&nbsp;
The services that are available through code.google.com
use streaming xml data,
without mandating a particular client.&nbsp;
You'll never see, "This website is best viewed with Internet Explorer version x or higher."&nbsp;
Third parties can develop tailor-made interfaces that meet their needs,
provided these programs follow
<a href=http://code.google.com/apis/gdata/basics.html>
Google's instructions</A>
for transferring data to and from the server.&nbsp;
Individuals are already constructing interfaces that work well for them,
giving them equal access to Google's broad range of services.

<H3 align=center> The Early Human-Machine Interface </H3>

Today's computer professionals, with laptops in hand, can hardly imagine the awkward interfaces that prior generations had to endure.&nbsp;
When I was a freshman at Michigan State University,
I learned how to use a key punch machine and a card reader;
that was how you "talked" to the computer.&nbsp;
Each punch card represented one line of text,
and a stack of several thousand cards might hold the source code for your master's project.&nbsp;
There was no file server on campus;
you kept your box of cards with you at all times.&nbsp;
And if you ever dropped your box of cards in the snow
while walking from the dorm to the computer center in January,
you were in a world of hurt.&nbsp;
Even an accidental spill from table to floor was cause for consternation,
as you carefully put your cards back in order.&nbsp;
Apparently this scenario was not uncommon,
prompting more than a few students to place sequence numbers on their cards
in the rightmost columns -
columns that were ignored by the computer.&nbsp;
Some people left gaps in these numbers, e.g. counting by tens,
so that additional lines of code could be inserted as necessary.&nbsp;
My roommate, who did not bother to number his cards, always carried them in a sealed cardboard box.&nbsp;
This led to more than a few jokes on my part.&nbsp;
"Quit singing in the shower at 6 A.M., or i'll scatter your box of cards all over the floor."

<P>
Once a student arrived safely at the computer center with cards in hand,
he might make some last minute corrections to his stack,
then feed the cards, at a rate of ten per second, through the card reader.&nbsp;
This created a "batch job", which resulted in a printout some 20 minutes later.&nbsp;
Wait times were highly variable, depending on load,
which is why many students worked at night.&nbsp;
Having placed the cards carefully back in his box,
our weary student anxiously waits for the results of his labors.&nbsp;
Did the program compile?&nbsp;
Did it run?&nbsp;
Was there an error in logic?&nbsp;
Can he turn his printout in for a grade, or is there more work to do?&nbsp;
If anything has to be changed, he goes back to the punch machine,
hammers out new cards, slides them into position,
and walks back to the card reader for another run.&nbsp;
The smallest typo represents another hour's work.&nbsp;
It was not unusual to see bleary-eyed students stumbling back into the dorm at 2 or 3 in the morning,
card box under one arm and a stack of printouts under the other.

<P>
Imagine my joy when the University installed interactive teletypes!&nbsp;
These look like electric typewriters, but the keystrokes are transmitted directly to the central computer.&nbsp;
When you hit return, the computer responds, then waits for your next command.&nbsp;
The interface had become a dialog,
which clipped along at 110 bits per second, or 300 bits per second if you glommed onto one of the newer teletypes.&nbsp;
The paper retained a written transcript of the entire session;
your commands and the computer's responses.&nbsp;
These machines are all but forgotten, except for the vestigial letters tty, which are an abbreviation for teletype.&nbsp;
The software that facilitates communication between you and your computer, through the keyboard and screen,
is still called a tty today.&nbsp;
Type `tty' into any Unix or Linux computer, and it will tell you which tty driver you are using,
e.g. /dev/tty1 on console 1.&nbsp;
A large Unix machine can have hundreds of tty drivers, supporting hundreds of simultaneous users.

<P>
The clatter of the teletype was an annoyance for most, but it was a blessing for me.&nbsp;
I knew when the computer had responded, and the nature of that response.&nbsp;
If a volunteer reader was not available, and the homework assignment was modest,
I could log onto the system,
type my program into the editor,
compile the program,
and run the executable,
based solely on the clicks of the teletype.&nbsp;
After my roommate read through the printout and verified the results,
I tucked it away in my notebook and turned it in the next day for a grade.&nbsp;
Although I now have a speech synthesizer at hand,
I still miss the audio feedback that was an unintentional feature of the mechanical teletype.&nbsp;
To this end, I modified the Linux tty driver to create similar sounds using the PC speaker.&nbsp;
When the computer sends text to the screen, soft clicking sounds accompany the nonspace characters,
while a longer swoop indicates a new line,
as though the print head was swinging back to the left.&nbsp;
These modules are available from the drivers directory in the following project.

<P>
git clone https://github.com/eklhad/acsint

<P>
The chirps and clicks are subtle, and are easily ignored by those around me;
yet they form an important part of my audio interface.&nbsp;
Like the systems of yesteryear,
my tty tells me when the computer has responded to my commands,
and the quantity and format of that response,
even before my synthesizer has spoken a word.

<P>
This project also contains a linear speech adapter, the only one of its kind.&nbsp;
Like the paper teletype, this adapter retains a log of all tty output,
and allows the user to review that log,
reading the entered commands and the computers responses.&nbsp;
All other adapters,
whether on MS-dos, Windows, Mac-OS, or Linux,
read the words or icons on the screen.&nbsp;
My adapter can read screen memory as well, but it typically runs in linear mode, which is optimal for the command line interface.&nbsp;
This adapter, and various applications such as edbrowse, all work together to present a new
(i.e. old) paradigm,
a paper teletype inside your computer.

<P>
Over the next few years, universities around the country
replaced their paper teletypes with cathode ray tube terminals, also known as CRTs.&nbsp;
Trees everywhere heaved a sigh of relief;
yet the interface was still the same.&nbsp;
A user types a command, and the computer responds on the next line.&nbsp;
The dialog continues.

<H3 align=center> Early Editors and Word Processors </H3>

When I began my career at AT&T Bell Labs,
I learned to use the standard Unix text editor, which is simply called ed.&nbsp;
This is a command line program, consistent with the interface of its day.&nbsp;
If you want to see the seventh line in a file, type 7 and hit return.&nbsp;
To find the line containing the string "xyz", type /xyz/.&nbsp;
Lines can be changed, deleted, moved, or copied using this program,
but you only see one line at a time.&nbsp;
Furthermore, ed is merely a text editor; it is not a word processor.&nbsp;
Tools like troff and nroff were developed to turn text into a formatted page.&nbsp;
For instance, .PP indicates a new paragraph,
.SH indicates a section heading, and so on.&nbsp;
Online manual pages are still written in this markup language today.&nbsp;
Type "man ls' into a Linux machine, and nroff is running in the background.

<P>
Although the combination of ed and nroff was primitive by today's standards,
it was perfect for me.&nbsp;
I used ed to create documents,
inserting formatting tags where appropriate,
and the resulting pages were comparable to those created by my sighted colleagues
who were forced to use the same text based tools.&nbsp;
Needless to say, this was not tolerated for long.&nbsp;
Screen editors such as vi and emacs quickly appeared,
followed by word processors such as Word Perfect and MS Word.&nbsp;
For the first time, you could see what your document would look like before sending it to the printer.&nbsp;
Once again, trees around the world were granted a reprieve,
and everyone who touched a computer became more productive over night - everyone but me.&nbsp;
Yes, screen readers allowed me to roam about and read the text,
but I was still processing the data linearly.&nbsp;
The benefits of a two dimensional search and scan were not available to me,
and to think otherwise is to live in a state of denial.&nbsp;
So I continued to use ed and nroff to create programs and documents for Bell Labs.&nbsp;
I even ported ed to the IBM PC, thus giving me the same linear interface at work and at home.

<H3 align=center> Accessing the Internet </H3>

Fast forward 15 years,
and the Internet consists of web pages that are text based, with embedded formatting directives that are similar to nroff.&nbsp;
For instance, &lt;P&gt; tells your browser to start a new paragraph,
while &lt;H2&gt; represents a new section heading at level 2.&nbsp;
These are reminiscent of the .PP and .SH directives that came before.&nbsp;
Thus, Hyper Text Markup Language (HTML), the language of the Internet,
is an evolutionary descendent of nroff.&nbsp;
Having learned most of the html codes,
I was able to develop some 1,400 web pages
for <A HREF=http://www.mathreference.com>MathReference.com</A>,
using nothing but a text editor.&nbsp;
If I want my web page to display Goodnight Moon in italics,
then Margaret Wise Brown in a smaller font on the next line,
I will enter the following commands.

<P>
&lt;I&gt;Goodnight Moon&lt;/I&gt;
<br>
&lt;br&gt;&lt;font size=-1&gt;by Margaret Wise Brown&lt;/font&gt;

<P>
Once again I am in the minority.&nbsp;
Most web developers use graphical design tools,
such as MS Front Page or Dreamweaver,
which hide the technical details of html.&nbsp;
The interface is similar to a word processor.&nbsp;
Arrange the text and pictures on the screen as you would like them to appear on your website,
and the tool generates the appropriate html.&nbsp;
This works well for others, but for me,
the benefits of a two dimensional representation are rendered academic,
as my speech adapter roams around the screen, trying to make sense of the page as a whole.&nbsp;
It's like looking at the world through a straw.

<P>
Although I could write web pages using ed and a few basic html commands,
I was still unable to surf the net quickly and efficiently.&nbsp;
My text editor allowed me to create a website from scratch,
but there was no command line browser to help me read websites that were written by others.&nbsp;
The closest approximation was a program called lynx, which does not employ graphical icons,
and can even be run without a mouse.&nbsp;
Indeed, many blind people still use lynx today.&nbsp;
However, lynx remains a screen oriented application,
presenting information across 25 rows and 80 columns.&nbsp;
I was hoping for a command line interface similar to ed.

<P>
In 2003, I began writing a program called edbrowse, a combination editor browser,
whose interface was fashioned after ed.&nbsp;
This has all the features of ed,
along with some new commands, such as `b' to browse an html file,
and `g' to go to a hyperlink referenced by that web page.&nbsp;
One can "edit" www.ibm.com as easily as one might edit a local file.&nbsp;
Of course you cannot meaningfully change the contents of www.ibm.com, since it resides on another computer,
but you can format it using the browse command,
then step through the text line by line, or search for a word or phrase
using the ed commands you already know.&nbsp;
To find the next hyperlink, search for the left brace, as this indicates a link to another web page.&nbsp;
Similarly, one can step through the fields in a fill-out form by searching for the less than sign.&nbsp;
With practice, it is surprisingly easy to navigate through most web pages
and find the information you want.&nbsp;
Compared to other browsers,
edbrowse demands more input, in the form of entered commands, and generates less output;
which is precisely the paradigm for a one dimensional channel such as speech or braille.

<H3 align=center> System Administration </H3>

We recently purchased a Mac, and after I learned how to log in remotely from my Linux machine,
I was able to perform all sorts of printer administration tasks,
including adding and configuring a new printer,
printing test pages,
setting up print queues with priorities, and monitoring print jobs.&nbsp;
This is normally accomplished through a graphical printer utility on the screen,
but I found another way.&nbsp;
The print utility is web based, so anyone with a browser can access the printers via http://localhost:631.&nbsp;
(If you have a Mac, type this into your browser and you'll see what I mean.)&nbsp;
An important subsystem of the computer, with a moderate level of complexity,
has been rendered accessible to a wide range of disabled users,
thanks to the power of the Internet.&nbsp;
Fire up your favorite browser, be it edbrowse or lynx or firefox,
and manage your print jobs through an interface that has been optimized for your particular needs.

<P>
Another example of web based system administration is samba file sharing,
which is accessible through http://localhost:901 on some computers.&nbsp;
Turning to network administration,
most off-the-shelf routers can now be configured through html.&nbsp;
I hope this is the beginning of a new trend in system administration.&nbsp;
Accounts and passwords, networking, firewalls, disk utilities, and the task manager are just a few examples
of real world applications that can and should be web based.&nbsp;
If the resulting web pages are relatively simple in their content and format,
computers would become more accessible, almost over night.&nbsp;
Most people would access these functions through the default graphical browser
that is shipped with the computer,
and they wouldn't know the difference.&nbsp;
At the same time,
I would take advantage of edbrowse, which was written specifically for my needs.

<P>
Beyond this, web based administration makes it easy to configure the computer remotely.&nbsp;
If the firewall permits, I could access the printers on your box by typing http://yourbox:631 into my browser.&nbsp;
There is no need to log in remotely and run edbrowse on your computer,
which may not be practical in any case.

<H3 align=center> Other Applications </H3>

Some applications cannot be operated effectively through a browser,
and edbrowse does not claim to be the universal solution to accessibility.&nbsp;
Consider Microsoft Excel, a well known spreadsheet application.&nbsp;
Imagine a conversion utility that transforms an xls file to an interactive web page, ready for manipulation by your favorite browser.&nbsp;
Each cell becomes an input field in a fill-out form, and the cells are arranged in rows and columns inside an html table.&nbsp;
As data is modified,
javascript formulas compute totals and averages, as Excel normally does.&nbsp;
This works well for small data sets,
yet some spreadsheets contain hundreds of columns and thousands of rows.&nbsp;
Your eyes easily drift down column 79, looking for trends in the data,
but edbrowse cannot do this.&nbsp;
Long lines are tolerated, but there is no convenient way to jump to column 79.&nbsp;
Nor can you easily locate the "payment" column for the row associated with customer "Mary Smith".&nbsp;
Either edbrowse must be augmented with new "spreadsheet" features,
or a linear version of Excel must be developed,
with novel commands designed to locate and modify individual cells.

<P>
This holds true for any program where eye movements
(which lie outside the purview of the screen interface)
must be converted into commands and responses,
entirely new pathways for the linear version of the same application.&nbsp;
Think of the application as a conversation between the program and the user.&nbsp;
When the user ignores 95% of what the program "says", and selects the
relevant 5% by moving his eyes,
that conversation must change in fundamental ways to be blind-friendly.&nbsp;
Most screen programs implement this type of mega-output conversation;
that is in fact the screen paradigm.&nbsp;
For this reason, screen programs with high data rates must be redesigned from the ground up
to run efficiently in text mode.&nbsp;
At the same time, simpler programs can often be restructured to
generate html or xml,
which gives the user control over his interface
through specialized clients.

<H3 align=center> In the Background </H3>

Although edbrowse was designed to make the Internet accessible to the disabled community,
it has some unique features which have attracted the attention of Unix administrators and developers.&nbsp;
Most browsers assume the presence of a human operator, to read the screen and click the mouse.&nbsp;
In contrast, edbrowse can simply read a set of commands from a file.&nbsp;
In addition, edbrowse includes a scripting language,
with conditional logic, loops, and functions.&nbsp;
A background cron job, run every morning by the computer,
can review the contents of several web pages, and send mail to the operator if certain conditions are met.&nbsp;
In other words, edbrowse is well suited to batch processing, without human intervention.&nbsp;
In theory, the same tasks could be accomplished by a shell script, calling upon wget and grep and the like,
but a self-contained edbrowse script is easier to write and maintain.&nbsp;
This is why grml,
a distribution aimed at system administrators,
was the first to include edbrowse in its standard release.&nbsp;
Others, such as debian, and even Free BSD, now offer edbrowse in their distributions.

<H3 align=center> Summary </H3>

Although edbrowse has become a useful tool for batch jobs on the Internet,
the main focus continues to be accessibility.&nbsp;
Pasting a screen reader on top of Explorer is a good beginning,
but it hardly creates a level playing field.&nbsp;
The disabled community deserves better.&nbsp;
The editor, the browser, the mail client, and the spreadsheet can be made much more efficient
for the blind, blind-deaf, and motor impaired,
if we would just take the time to redesign them
with the user's needs in mind.&nbsp;
Once these critical applications are transformed,
other utilities can be modified to leverage these clients,
as illustrated by an emerging suite of web based tools and services.&nbsp;
These efforts should be funded at the federal level,
but sadly, they have received little support from government or industry to date.&nbsp;
When everyone has access to computers, laptops, and the internet,
we all benefit.&nbsp;
Sir Bert Massie, Chairman of the Disability Rights Commission,
said it best.&nbsp;
"The overall vision must be one of a society in which everyone (disabled and
non-disabled alike) can flourish and participate fully as equal citizens."

</BODY></font>