Re: docstrings and elisp reference

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

  > 2) my remark about javadoc was not intended to suggest a
  > replacement of the current documentation, but to have a document
  > that has all the docstring information (Emacs API) in one
  > place. It would be an alternative to the info system, with exactly
  > the same contents. It would be a great tool to find API
  > information and also very practical to check if the rules defined
  > in the GNU Coding Standards are respected.

All the doc strings are found together in one place: Emacs.
That's a program, not a document.  But why in practice would it be
better to have them all in one document?

It should not be hard to write a Lisp program which will write
that document into a file, straight from Emacs.


-- 
Dr Richard Stallman
President, Free Software Foundation (gnu.org, fsf.org)
Internet Hall-of-Famer (internethalloffame.org)
Skype: No way! See stallman.org/skype.html.