unofficial mirror of help-gnu-emacs@gnu.org
 help / color / mirror / Atom feed
From: Tim Johnson <tim@akwebsoft.com>
To: MLEmacs <Help-gnu-emacs@gnu.org>
Subject: Proper use of function form
Date: Sun, 26 Apr 2020 15:27:15 -0800	[thread overview]
Message-ID: <ce9f11f3-dd60-838c-5fc9-980bd99ff2ab@akwebsoft.com> (raw)

Here is a key definition:

(define-key jinja2-mode-map (kbd "C-c i") #'jinja2-insert-var)

As I understand it, the sharp-quote (#') tells the compiler that 
jinja2-insert-var is meant to be a function

The following quotation:

"it is always good practice to sharp quote every symbol that is the name 
of a function, whether it's going into a |mapcar|, an |apply|, a 
|funcall|, or anything else."

Can be found at 
https://endlessparentheses.com/get-in-the-habit-of-using-sharp-quote.html

fuurther text there describes the special 'function form for which the 
sharp-quote is a shorthand.

Suppose we are processing a sexp of alternating strings and symbols:

(setq my-keypairs '("h" my-h-func "g" my-g-func "f" my-f-func))

and using iteration to *programmatically* call define-key for multiple 
key definitions as in

(define-key mymap                               ;; add to keymap
     (kbd (concat ldr (nth ndx mylist)))    ;; sequence as in "g"
     (nth (+ ndx 1) mylist))                      ;; command as in my-g-func

The form above is indeed a snippet from a defun that I have used for years

Would it be better to change (nth (+ ndx 1) mylist) to (function (nth (+ 
ndx 1) mylist)) ?

I note that help for 'function states a preference for using it with 
function objects, but says nothing about processing a list. Hence I am 
lobbying wiser heads than mine for opinions before I implement something 
that might cause subtle problems down the road.

Emacs is GNU Emacs 26.3 (build 2, x86_64-pc-linux-gnu, X toolkit, Xaw 
scroll bars)
on ubuntu 16.04

Thanks

-- f
Tim
tj49.com



             reply	other threads:[~2020-04-26 23:27 UTC|newest]

Thread overview: 7+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-04-26 23:27 Tim Johnson [this message]
2020-04-27  0:05 ` Proper use of function form Michael Heerdegen
2020-04-27  0:43   ` Tim Johnson
2020-04-27  0:48 ` Noam Postavsky
2020-04-27  1:58   ` Tim Johnson
2020-04-27  8:06 ` Emanuel Berg via Users list for the GNU Emacs text editor
2020-04-27 19:12   ` Tim Johnson

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=ce9f11f3-dd60-838c-5fc9-980bd99ff2ab@akwebsoft.com \
    --to=tim@akwebsoft.com \
    --cc=Help-gnu-emacs@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).