Re: On being web-friendly and why info must die

[Richard Stallman]

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

  > There are quite a few places where the text in the emacs manual is
  > similar to the docstrings.

They are usually _similar_ in that they give much of the same
information.  The point is that they should not be _written the same
way_.

Examples are a different issue.  It might be useful for the Emacs Lisp
manual to have a sample program in it, and arrange to be able to run
it and insert its output.

But don't focus too much on documentation of Emacs Lisp functions.
Most of our manuals are not about Emacs and have nothing to do with
Emacs Lisp functions.

-- 
Dr Richard Stallman
President, Free Software Foundation
51 Franklin St
Boston MA 02110
USA
www.fsf.org  www.gnu.org
Skype: No way! That's nonfree (freedom-denying) software.
  Use Ekiga or an ordinary phone call.