Re: Failing to see the allure of Emacs

[Jay Belanger <jay.p.belanger@gmail.com>]

> 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.