From: Carsten Dominik <carsten.dominik@gmail.com>
To: Achim Gratz <Stromeko@nexgo.de>
Cc: emacs-orgmode@gnu.org
Subject: Re: missing autoload cookies for defcustom?
Date: Sun, 9 Oct 2011 17:50:37 +0200 [thread overview]
Message-ID: <325572BB-9F81-4717-88B1-BD6CE033BDDF@gmail.com> (raw)
In-Reply-To: <87lisub39r.fsf@Rainer.invalid>
On 9.10.2011, at 17:20, Achim Gratz wrote:
>
> While playing aroud with different configurations I've noticed that you
> can't customize some variables unless you've loaded org first and then
> used a function from the file where they are defined. It's of course a
> bit difficult to know which function to use or file to load when all you
> want to do is customizing a variable that you've read about in the
> manual or on Worg.
Yes, this is an issue.
>
> It seems that all defcustom forms that are not defined in org.el (and
> maybe even those) should get an autoload cookie so that they are
> collected into org-install.el and Emacs knows where to find them even if
> their source file had not been loaded yet. The following perl
> invocation fixes all occurences of defcustom that aren't already having
> an autoload cookie set.
>
> perl -i -p \
> -e 'BEGIN{$o=0;}' \
> -e 'if ( /^\s*\(defcustom/ ) {' \
> -e ' print ";;;###autoload\n" unless $o;' \
> -e '} else {' \
> -e ' $o=/^;;;###autoload/;' \
> -e '}' \
> lisp/*.el
>
> (the \s* in the regex is for a mis-indented item in org-feed.el)
>
> This should produce the following diffstat on current master:
>
> lisp/ob-exp.el | 1 +
> lisp/ob-js.el | 1 +
> lisp/ob-lisp.el | 1 +
> lisp/ob-lob.el | 1 +
> lisp/ob-plantuml.el | 1 +
> lisp/ob-scheme.el | 1 +
> lisp/ob-sh.el | 1 +
> lisp/ob-tangle.el | 6 ++
> lisp/ob.el | 2 +
> lisp/org-agenda.el | 94 +++++++++++++++++++++
> lisp/org-archive.el | 7 ++
> lisp/org-ascii.el | 5 +
> lisp/org-attach.el | 7 ++
> lisp/org-bbdb.el | 4 +
> lisp/org-beamer.el | 9 ++
> lisp/org-bibtex.el | 9 ++
> lisp/org-capture.el | 3 +
> lisp/org-clock.el | 26 ++++++
> lisp/org-crypt.el | 3 +
> lisp/org-ctags.el | 3 +
> lisp/org-docbook.el | 16 ++++
> lisp/org-entities.el | 2 +
> lisp/org-exp-blocks.el | 4 +
> lisp/org-exp.el | 43 ++++++++++
> lisp/org-faces.el | 8 ++
> lisp/org-feed.el | 7 ++
> lisp/org-footnote.el | 6 ++
> lisp/org-freemind.el | 2 +
> lisp/org-gnus.el | 2 +
> lisp/org-habit.el | 7 ++
> lisp/org-html.el | 35 ++++++++
> lisp/org-icalendar.el | 16 ++++
> lisp/org-id.el | 8 ++
> lisp/org-indent.el | 4 +
> lisp/org-inlinetask.el | 3 +
> lisp/org-jsinfo.el | 3 +
> lisp/org-latex.el | 37 +++++++++
> lisp/org-list.el | 14 +++
> lisp/org-mac-message.el | 1 +
> lisp/org-mew.el | 1 +
> lisp/org-mhe.el | 1 +
> lisp/org-mobile.el | 13 +++
> lisp/org-mouse.el | 2 +
> lisp/org-protocol.el | 4 +
> lisp/org-publish.el | 11 +++
> lisp/org-remember.el | 10 +++
> lisp/org-src.el | 9 ++
> lisp/org-table.el | 21 +++++
> lisp/org-taskjuggler.el | 8 ++
> lisp/org-timer.el | 2 +
> lisp/org-wl.el | 6 ++
> lisp/org.el | 207 +++++++++++++++++++++++++++++++++++++++++++++++
> 52 files changed, 698 insertions(+), 0 deletions(-)
>
> This is obviously quite heavy-handed and there is vocal opposition among
> the Emacs maintainers towards autoloading defcustoms. While I partly
> understand their rationale, I don't think it applies to org-mode (these
> autoloads only become effective when org-install is loaded).
This is not correct for Org when it is distributed with Emacs. Emacs
builds its own autoload files, and it would pull in all these defcustoms.
The work-around Org itself provides is to provide a command to load all
the autolod files, so that then, the defcustoms will be available.
The function is `org-require-autoloaded-modules'. Also, if you
run `M-x org-customize', this will happen automatically.
Maybe we just need to document this in a good place?
- Carsten
> Also, I
> don't really see what the alternative should be, unless all those
> defcustoms would be moved into separate files that would then be
> required by org-install (I'm not suggesting to do that, BTW). Also it
> appears that there is no way to autoload a defgroup form, so that one
> would need to be handled in a different way, maybe by moving all
> defgroups into org.el. Thoughts?
>
>
> Regards,
> Achim.
> --
> +<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+
>
> SD adaptations for KORG EX-800 and Poly-800MkII V0.9:
> http://Synth.Stromeko.net/Downloads.html#KorgSDada
>
>
next prev parent reply other threads:[~2011-10-09 15:50 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2011-10-09 15:20 missing autoload cookies for defcustom? Achim Gratz
2011-10-09 15:50 ` Carsten Dominik [this message]
2011-10-09 16:26 ` Achim Gratz
2011-10-10 5:26 ` Carsten Dominik
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.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=325572BB-9F81-4717-88B1-BD6CE033BDDF@gmail.com \
--to=carsten.dominik@gmail.com \
--cc=Stromeko@nexgo.de \
--cc=emacs-orgmode@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 public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
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).