[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: docstrings and elisp reference
From: |
Richard Stallman |
Subject: |
Re: docstrings and elisp reference |
Date: |
Sun, 18 Jun 2017 15:52:25 -0400 |
[[[ 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.
- Re: docstrings and elisp reference, (continued)
- Re: docstrings and elisp reference, Eli Zaretskii, 2017/06/07
- Re: docstrings and elisp reference, Dmitry Gutov, 2017/06/06
- RE: docstrings and elisp reference, Drew Adams, 2017/06/06
- Re: docstrings and elisp reference, Dmitry Gutov, 2017/06/06
- Re: docstrings and elisp reference, Eli Zaretskii, 2017/06/07
- Re: docstrings and elisp reference, Dmitry Gutov, 2017/06/17
- Re: docstrings and elisp reference, Alan Mackenzie, 2017/06/17
- Re: docstrings and elisp reference, Dmitry Gutov, 2017/06/17
- Re: docstrings and elisp reference, Alan Mackenzie, 2017/06/17
- Re: docstrings and elisp reference, Eli Zaretskii, 2017/06/17
- Re: docstrings and elisp reference,
Richard Stallman <=
- Re: docstrings and elisp reference, Richard Stallman, 2017/06/17
- Re: docstrings and elisp reference, John Wiegley, 2017/06/20
- Re: docstrings and elisp reference, Eli Zaretskii, 2017/06/17
- Re: docstrings and elisp reference, Stefan Monnier, 2017/06/17
- Re: docstrings and elisp reference, Paul Eggert, 2017/06/17
- RE: docstrings and elisp reference, Drew Adams, 2017/06/17
- Re: docstrings and elisp reference, Thien-Thi Nguyen, 2017/06/19
- RE: docstrings and elisp reference, Drew Adams, 2017/06/07
- RE: docstrings and elisp reference, Drew Adams, 2017/06/07
- Re: docstrings and elisp reference, Richard Stallman, 2017/06/07