Documentation, documentation, documentation #emacs
Of course the builtin documentation of Emacs is aimed at proficient elisp programmers, but... sometimes it would be nice to have a couple of extra words to help the casual elisp programmer.
Example: I remember that
car returns the first element of a list and the rest of the list, but I haven't memorized which is which, so I consult the online help (
C-h f cdr/car):
"car is a built-in function in `C source code'. (car LIST) Return the car of LIST. If arg is nil, return nil."
"cdr is a built-in function in `C source code'. (cdr LIST) Return the cdr of LIST. If arg is nil, return nil."
Which is just maddingly unhelpful!
Would it really degrade that much from the experience of the super knowledgable Emacs gurus to throw in a "(the first element)" and "(the rest of the list)" in those documentation strings?
I had to refer to wikipedia to get it right.
Update: Ok, it wouldn't: bug report, commit.
Update 2: Ok, decision reversed.
To avoid spam many websites make you fill out a CAPTCHA, or log in via an account at a corporation such as Twitter, Facebook, Google or even Microsoft GitHub.
I have chosen to use a more old school method of spam prevention.
To post a comment here, you need to:
¹ Such as Thunderbird, Pan, slrn, tin or Gnus (part of Emacs).
- Configure a newsreader¹ to connect to the server
- Open the newsgroup called
1119using nntps (nntp over TLS).
lantern.koldfrontand post a follow up to the article.
Or, you can fill in this form: