[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#15809: [External] : Re: bug#15809: 24.3.50; wrong defcustom type for
From: |
Drew Adams |
Subject: |
bug#15809: [External] : Re: bug#15809: 24.3.50; wrong defcustom type for `suggest-key-bindings' |
Date: |
Sat, 25 Sep 2021 01:50:25 +0000 |
> > FWIW, "natural number", like "whole number", unfortunately
> > has two different meanings, 1... and 0..., depending on
> > who is talking.
> >
> >
> https://urldefense.com/v3/__https://en.wikipedia.org/wiki/Natural_numbe
> r__;!!ACWV5N9M2RV99hQ!YF8_QIyGvA34pZcXQ5IY8wSQQwrUUykjIfLCvd5eidW2mRgqe
> d8BnAbe2sG274Mx$
> >
> > Emacs has predicate `natnump', with alias `wholenump',
> > meaning 0... So the doc for a defcustom type that
> > mentions "natural number" had better make clear which is
> > meant. It can do that by mentioning predicate `natnump'.
>
> The docstring of `natnump' defines it as "a nonnegative integer".
Which is why one fix is to mention `natnump'. But
that makes a reader check the doc string of `natnump'.
It's about "the doc for a defcustom type that mentions
'natural number'". It's the defcustom type that needs
the doc love. The doc of `natnump' is OK already.