[Prev][Next][Index][Thread]

Re: Documentation for emacspeak 6



bob@megalith.rattlesnake.com writes:
 > I am puzzled.  raman@adobe.com 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
 > indispensible.

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
 >     emacspeak-dired.el
 > 
 > 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               bob@gnu.ai.mit.edu
 >     25 Rattlesnake Mountain Road     bob@rattlesnake.com
 >     Stockbridge, MA 01262-0693 USA   (413) 298-4725

-- 
Best Regards,
--raman

      Adobe Systems                 Tel: 1 (408) 536 3945   (W14-129)
      Advanced Technology Group     Fax: 1 (408) 537 4042 
      (W14 129) 345 Park Avenue     Email: raman@adobe.com 
      San Jose , CA 95110 -2704     Email:  raman@cs.cornell.edu
      http://labrador.corp.adobe.com/~raman/raman.html (Adobe  Internal)
      http://www.cs.cornell.edu/Info/People/raman/raman.html  (Cornell)
-----------------------------------------------------------------------
    Disclaimer: The opinions expressed are my own and in no way should be taken
as representative of my employer, Adobe Systems Inc.
____________________________________________________________