Re: Documentation for emacspeak 6
> I am puzzled. firstname.lastname@example.org writes:
> Also, the reason why it is important to learn to use describe
> function is that that is how you learn all of emacs, ...
I must confess I did not express myself clearly. Readding the emacs info pages
was how I learnt all I know about emacs.
> That is not how most people I know learned Emacs. Others taught them
> or they read the manual. I mostly read the manual.
> Compared to my use of `describe function', the manual was much more
> important. Indeed, the manual and `describe function' have different
> purposes. The manual tells you how to use the application; describe
> function tells you about a particular function after you already know
> about it, but have forgot the details.
I was alluding to describe-function more because for someone who refuses to
read manuals at least it 's something there at your fingertips.
Again, the question I have is *not* about are info pages useful --they are
The question is a very very specific one --namely,
are the automatically generated notes from the emacspeak sources useful
given that they are incomplete from a user perspective.
> The introduction is useful --what I question is the automatic
> fragments pulled from modules like emacspeak-calendar.el and
> The Emacspeak manual should be read in conjuction with the Emacs
> manual, in much the same way the Calender manual was read as a
> standalone manual before the main material on the Calender was
> incorporated into the Emacs manual as a chapter.
> That is the way this manual should go. We should expect eventually to
> see it integrated with the Emacs manual. Emacs has a text-only screen
> display, a graphics screen display, and a voice display. The Emacs
> manual should describe all three.
> Robert J. Chassell email@example.com
> 25 Rattlesnake Mountain Road firstname.lastname@example.org
> Stockbridge, MA 01262-0693 USA (413) 298-4725
Adobe Systems Tel: 1 (408) 536 3945 (W14-129)
Advanced Technology Group Fax: 1 (408) 537 4042
(W14 129) 345 Park Avenue Email: email@example.com
San Jose , CA 95110 -2704 Email: firstname.lastname@example.org
http://labrador.corp.adobe.com/~raman/raman.html (Adobe Internal)
Disclaimer: The opinions expressed are my own and in no way should be taken
as representative of my employer, Adobe Systems Inc.