all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: "Drew Adams" <drew.adams@oracle.com>
To: "'Emacs-Devel devel'" <emacs-devel@gnu.org>
Subject: autoload cookies for defcustoms
Date: Sat, 23 Jan 2010 10:31:28 -0800	[thread overview]
Message-ID: <2DC911234A9B4A6ABD34459FB8C26C1C@us.oracle.com> (raw)

Just curious. Is there a policy, for the Lisp code distributed with Emacs, about
using autoload cookies for defcustoms? If so, what is it?

Looking through the code, it seems that most defcustoms are not autoloaded, but
some are. And in the same library some might be and others not.

Some use `purecopy' for their values, so I guess it makes sense to autoload
those. But it's not clear which came first, the cookie or the decision to use
`purecopy'. 

If, in some library, only the options that use `purecopy' are autoloaded,
doesn't that give a misleading impression to users of `C-h v'? They see only the
`purecopy' ones (before loading), which aren't necessarily the most important to
know about.

IOW, are there two conflicting criteria for autoloading an option: (1) its
importance or frequency of use or the need for users to know about it before
loading vs (2) the purely technical (implementation) criterion of its use of
`purecopy'. Shouldn't the only criterion be use- and user-centered (i.e., #1)?

Some options that do not use `purecopy' are nevertheless autoloaded. And some
that do use `purecopy' do not have an autoload cookie - e.g.,
`epa-file-name-regexp', `automount-dir-prefix', `directory-free-space-program',
`search-whitespace-regexp', `jka-compr-load-suffixes', `rmail-file-name',
`site-run-file', `initial-scratch-message', `vc-directory-exclusion-list',
`adaptive-fill-regexp', `adaptive-fill-first-line-regexp'. (Is that wrong, or
are all of those libraries always preloaded?)

If there is no general policy, and this is decided individually for each
defcustom, then just what considerations affect the judgment? And why is there
such variability among libraries?

The same question could apply to command definitions, but there there doesn't
seem to be such a difference among libraries for them. Most commands seem to
have autoload cookies (just as most options do not), and I'm guessing that those
commands that do not are considered to be less often used.





             reply	other threads:[~2010-01-23 18:31 UTC|newest]

Thread overview: 18+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2010-01-23 18:31 Drew Adams [this message]
2010-01-23 20:24 ` autoload cookies for defcustoms Lennart Borgman
2010-01-23 20:38   ` Drew Adams
2010-01-25  2:56 ` Stefan Monnier
2010-01-25  5:13   ` Drew Adams
2010-01-25 15:31     ` Stefan Monnier
2010-01-25 20:36       ` Drew Adams
2010-01-26  2:05         ` Stefan Monnier
2010-01-26  3:12           ` Drew Adams
2010-01-26 11:51         ` Juanma Barranquero
2010-08-29  9:46   ` Wojciech Meyer
2010-08-29 19:11     ` Glenn Morris
2010-08-30 12:30       ` Wojciech Meyer
2010-08-30 15:54         ` Stefan Monnier
2010-08-30 23:20         ` Glenn Morris
2010-08-30 23:52           ` Wojciech Meyer
2010-08-31  3:32           ` Andy Wingo
2010-08-31  8:04             ` Stefan Monnier

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

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

  git send-email \
    --in-reply-to=2DC911234A9B4A6ABD34459FB8C26C1C@us.oracle.com \
    --to=drew.adams@oracle.com \
    --cc=emacs-devel@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.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.