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

When you want to refer to documentation on a function whose context
you already basically know, you probably want the doc string, because
doc strings are made for that.  The manual is made for when you want
to learn about a certain feature, including various functions and
variables.

They are both important, and each should be written in the way that is
best for its job.  Which means, quite differently.

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