unofficial mirror of help-gnu-emacs@gnu.org
 help / color / mirror / Atom feed
From: steve-humphreys@gmx.com
To: Stefan Monnier <monnier@iro.umontreal.ca>
Cc: help-gnu-emacs@gnu.org
Subject: Re: Hooks in minor modes
Date: Fri, 30 Apr 2021 06:12:19 +0200	[thread overview]
Message-ID: <trinity-19c03ca0-3e44-4cc1-b3f1-d2206dc8354c-1619755939523@3c-app-mailcom-bs05> (raw)
In-Reply-To: <jwvsg38bgfn.fsf-monnier+emacs@gnu.org>

That would mean that simply calling

  (require 'my-minor-mode)

would not automatically activate the functionality provided by
'my-minor-mode', unless the user specifically calls another
function called 'activate-my-minor-mode'.

'my-minor-mode' is a top-level mode that calls other elisp files
for accessing a range of functionalities (e.g. other minor-modes
for various programming languages and additional utilities for
colour highlighting, traversing text, auto-completion and so on).

Quite suitable for new users because they can simply call just
the following two commands.

  (require 'my-minor-mode)
  (activate-my-minor-mode)



> Sent: Friday, April 30, 2021 at 3:31 PM
> From: "Stefan Monnier" <monnier@iro.umontreal.ca>
> To: help-gnu-emacs@gnu.org
> Subject: Re: Hooks in minor modes
>
> > Is it acceptable to set mode hooks in a minor mode so that the minor
> > mode is available by default, rather than requiring the user to include
> >
> >   (add-hook 'texinfo-mode-hook 'my-minor-mode))
>
> Depends when you do that and it likely depends whom you ask.
>
> The convention that we strongly encourage to follow is that *loading* an
> ELisp file should not noticeably change Emacs's behavior (among other
> things, because files may be loaded without the user's explicit
> request).  So doing such an `add-hook` at the top-level of your file
> would probably not be considered as acceptable from that point of view
> (unless activating `my-minor-mode` by default has no visible effect,
> which is definitely possible but unusual).
>
>
>         Stefan
>
>
>



  reply	other threads:[~2021-04-30  4:12 UTC|newest]

Thread overview: 23+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-04-29 23:33 Hooks in minor modes steve-humphreys
2021-04-29 23:43 ` Emanuel Berg via Users list for the GNU Emacs text editor
2021-04-30  3:31 ` Stefan Monnier
2021-04-30  4:12   ` steve-humphreys [this message]
2021-04-30  4:33     ` Emanuel Berg via Users list for the GNU Emacs text editor
2021-04-30  4:43       ` require (was: Re: Hooks in minor modes) Emanuel Berg via Users list for the GNU Emacs text editor
2021-04-30  5:03         ` Emanuel Berg via Users list for the GNU Emacs text editor
2021-04-30  5:44           ` Jean Louis
2021-04-30 21:53             ` Emanuel Berg via Users list for the GNU Emacs text editor
2021-04-30 23:16               ` Jean Louis
2021-05-01  0:26                 ` Emanuel Berg via Users list for the GNU Emacs text editor
2021-05-01  5:49                   ` Jean Louis
2021-05-01  6:09                     ` Emanuel Berg via Users list for the GNU Emacs text editor
2021-05-01  9:23                       ` Jean Louis
2021-05-04  2:29                         ` Emanuel Berg via Users list for the GNU Emacs text editor
2021-05-04  5:40                           ` Yuri Khan
2021-05-04  6:02                             ` Emanuel Berg via Users list for the GNU Emacs text editor
2021-04-30 17:27           ` FW: [External] : " Drew Adams
2021-04-30 22:17             ` Emanuel Berg via Users list for the GNU Emacs text editor
2021-05-01  0:49               ` FW: " Drew Adams
2021-05-01  0:53                 ` Emanuel Berg via Users list for the GNU Emacs text editor
2021-04-30  5:17     ` Hooks in minor modes Stefan Monnier
2021-04-30  5:32       ` Emanuel Berg via Users list for the GNU Emacs text editor

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=trinity-19c03ca0-3e44-4cc1-b3f1-d2206dc8354c-1619755939523@3c-app-mailcom-bs05 \
    --to=steve-humphreys@gmx.com \
    --cc=help-gnu-emacs@gnu.org \
    --cc=monnier@iro.umontreal.ca \
    /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).