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

Re: Documentation for emacspeak 6





>I am personally not sure that the automatically generated pages add
>any value; since all that information and more is already available
>via commands describe-function and describe-key.  Also, in my
>personal judgement the user is likely to get confused rather than
>informed by the automatically generated pages, but I could be grossly
>wrong.

If you know the key, or the function name, then describe-key or
describe-function give you the description.  However, if you don't
know what functions might exist, let alone what their function names
are, and don't want to hunt at random through the possible key
sequences, then you need a collection of descriptions organized by
functional area.  That is why I wanted the automatically generated
descriptions included.

describe-function and describe-key correspond to a reference manual
(for reminding the user who already understands the system, but has
forgotten the details).  I was trying to write an introduction, for
the new user.

                           - Jim Van Zandt