Re: Guile in Emacs

[Jeff Clough <jeff@chaosphere.com>]

"Drew Adams" <drew.adams@oracle.com> writes:

> It is a choice whether we want clicking a cross-reference in an Emacs manual to
> take you (a) to a section of the same manual or another manual available locally
> or (b) to a section of a manual that might be on the Web. A cross reference
> might well be to a non-local or a non-GNU manual or specification. What is
> important is that we give users access to the specific info they need.

It is also important for that information to be available in one place.
When the information you need is split between two (or more) manuals, a
wiki, a HOW-TO and Wonder Tommy's blog, it sucks, no matter how well
cross-referenced or searchable it is.  There's a better way and Emacs
has it (for the most part).

I've never subscribed to the theory that just because a feature is
described on some web page out there, and not in the official manual,
that it's "documented".  Why people want to see this as the success of
the internet rather than as a failure of the documentation is beyond me.

Keep the information itself in one place that I can put on a tablet as a
PDF, or print out and take with me on an overnight.  Not everyone reads
their docs from within Emacs all of the time.

For what it's worth.

Jeff