unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: Stefan Monnier <monnier@iro.umontreal.ca>
To: emacs-devel@gnu.org
Subject: Re: scroll-down with pixel transition
Date: Fri, 21 Apr 2017 09:29:55 -0400	[thread overview]
Message-ID: <jwvshl1ubzf.fsf-monnier+gmane.emacs.devel@gnu.org> (raw)
In-Reply-To: 834lxib7jy.fsf@gnu.org

>>>>> "Eli" == Eli Zaretskii <eliz@gnu.org> writes:

>> From: Richard Stallman <rms@gnu.org>
>> Date: Thu, 20 Apr 2017 22:05:25 -0400
>> Cc: eliz@gnu.org, tkk@misasa.okayama-u.ac.jp, yuri.v.khan@gmail.com,
>> cpitclaudel@gmail.com, emacs-devel@gnu.org
>> 
>> Our convention is to end user option names in '-flag', when they are
>> for users to set.  Let's document that, if it isn't already.

> It is not currently documented in code conventions.

I think it used to be there, but I demoted it to:

    @item @dots{}-flag
    The value is significant only as to whether it is @code{nil} or not.
    Since such variables often end up acquiring more values over time,
    this convention is not strongly recommended.

in variables.texi.
In my experience, using FOO instead of FOO-flag is a better choice.

Also, many boolean config variables can be introduced as minor modes
(in which case their name should end in "-mode").


        Stefan




  parent reply	other threads:[~2017-04-21 13:29 UTC|newest]

Thread overview: 63+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2017-04-09 23:49 scroll-down with pixel transition Tak Kunihiro
2017-04-10  5:58 ` Eli Zaretskii
2017-04-10  7:06   ` Tak Kunihiro
2017-04-10  7:42     ` Eli Zaretskii
2017-04-10 22:24       ` Tak Kunihiro
2017-04-11  7:44         ` Eli Zaretskii
2017-04-12 12:13           ` Tak Kunihiro
2017-04-12 12:43             ` Eli Zaretskii
2017-04-13  7:02               ` Tak Kunihiro
2017-04-13  7:21                 ` Eli Zaretskii
2017-04-13  8:12                   ` Tak Kunihiro
2017-04-13  8:20                     ` Eli Zaretskii
2017-04-13  8:40                       ` Tak Kunihiro
2017-04-13  9:04                         ` Eli Zaretskii
2017-04-13  9:22                           ` Tak Kunihiro
2017-04-13 10:24                             ` Eli Zaretskii
2017-04-14  2:40                               ` Tak Kunihiro
2017-04-14  7:37                                 ` Eli Zaretskii
2017-04-14 22:32                                   ` Tak Kunihiro
2017-04-15 10:13                                     ` Eli Zaretskii
2017-04-16  8:35                                       ` Tak Kunihiro
2017-04-16 10:26                                         ` Eli Zaretskii
2017-04-16 12:17                                           ` Tak Kunihiro
2017-04-16 16:51                                             ` Eli Zaretskii
2017-04-16 18:00                                               ` Eli Zaretskii
2017-04-16 23:06                                                 ` Tak Kunihiro
2017-04-17  8:54                                                   ` Eli Zaretskii
2017-04-17 23:15                                                     ` Tak Kunihiro
2017-04-19 12:21                                                       ` Tak Kunihiro
2017-04-19 12:38                                                         ` Kaushal Modi
2017-04-19 12:42                                                           ` Kaushal Modi
2017-04-19 14:44                                                           ` Eli Zaretskii
2017-04-19 15:02                                                             ` Stefan Monnier
2017-04-19 15:07                                                             ` Kaushal Modi
2017-04-19 15:37                                                               ` Eli Zaretskii
2017-04-19 15:49                                                                 ` Kaushal Modi
2017-04-19 16:10                                                                   ` Eli Zaretskii
     [not found]                                                                   ` <<83zifcbcoc.fsf@gnu.org>
2017-04-19 17:33                                                                     ` Drew Adams
2017-04-19 18:21                                                                       ` Lars Brinkhoff
2017-04-21  2:05                                                                   ` Richard Stallman
2017-04-21  6:26                                                                     ` Eli Zaretskii
2017-04-21  8:52                                                                       ` Tak Kunihiro
2017-04-30 12:13                                                                         ` Tak Kunihiro
2017-05-13 17:27                                                                           ` Eli Zaretskii
2017-04-21 13:21                                                                       ` Perry E. Metzger
2017-04-21 13:36                                                                         ` Eli Zaretskii
2017-04-21 14:24                                                                           ` Option name conventions (was Re: scroll-down with pixel transition) Perry E. Metzger
2017-04-21 13:29                                                                       ` Stefan Monnier [this message]
2017-04-21 15:47                                                                         ` scroll-down with pixel transition Drew Adams
2017-04-22  2:31                                                                       ` Richard Stallman
2017-04-22  7:54                                                                         ` Eli Zaretskii
2017-04-23  0:03                                                                           ` Richard Stallman
2017-04-23 12:32                                                                             ` Stefan Monnier
2017-04-25 19:40                                                                               ` Richard Stallman
2017-04-25 20:06                                                                                 ` Dmitry Gutov
2017-04-25 20:38                                                                                   ` Stefan Monnier
2017-04-26 17:16                                                                                     ` Richard Stallman
2017-04-26 17:15                                                                                   ` Richard Stallman
2017-04-15 14:31                                     ` Clément Pit-Claudel
2017-04-15 14:57                                       ` Eli Zaretskii
2017-04-15 15:33                                         ` Clément Pit-Claudel
2017-04-13  8:35                   ` Yuri Khan
2017-04-13  8:57                     ` Eli Zaretskii

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=jwvshl1ubzf.fsf-monnier+gmane.emacs.devel@gnu.org \
    --to=monnier@iro.umontreal.ca \
    --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 public inbox

	https://git.savannah.gnu.org/cgit/emacs.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).