[Top][All Lists]

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

Re: Failing to see the allure of Emacs

From: Jay Belanger
Subject: Re: Failing to see the allure of Emacs
Date: Tue, 04 May 2010 15:43:20 -0000
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux)

> Please don't tell me "use info",

Then don't use it; the documentation is available in hard copy, html,
etc.  What is your preferred form?

> because info is designed and intended not for reading, but for brief,
> casual online reference, and that is its cognitive organization.

Where did you get that idea?

> It's poor as a learning tool, at least for text-based and
> example-based learners like me.

It is text-based, and whether or not an info document is example based
depends (like everything else) on who wrote it.

> I'm a fast reader and I like hectares of well-indexed text with lots
> of bookmarks: that's my best medium.

Good info documentation is made up of hectares of well-indexed text;
bookmarks you can put in yourself.

> If documentation is worth doing -- and I think it is -- then it's
> worth doing well, in a way that meets the needs of the people who'll
> actually use it.

That is what Emacs documentation strives to do.  If there is a problem
with it, that is a bug and feel free to report it as such.

> In that light, emacs documentation seems to me to hold up not too
> well.

Nobody is required to like Emacs documentation, but your comments give
the impression that you haven't looked at it.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]