bug#43611: 28.0.50; Some mismatches between documentation and custom types

[Lars Ingebrigtsen]

Mauro Aranda <maurooaranda@gmail.com> writes:

> This report is about some mismatches between what the docstring says,
> and what the custom types allow, in cus-start.el.
>
> - cursor-type-types
> Two problems here:
> 1. The :tag for the (hbar . HEIGHT) option reads:
> Horizontal bar with specified width.
> It should say height.

OK, fixed.

> 2. The custom-type doesn't allow the (box . SIZE) option, described in
> the docstring.

  (box . SIZE)    display a filled box cursor, but make it
                  hollow if cursor is under masked image larger than
                  SIZE pixels in either dimension.

So I guess SIZE is an integer?  Then this should be correct, and I've
added it:

         (cons :tag "Box with specified size"
               (const box) integer)

> - hscroll-step
> The docstring says the value can be nil or 0, but the type is just
> number.  0 and nil have the same effect, according to the docstring, but
> it would be nice if the user could set it to nil if he wants to, using
> the Custom interface.

OK, fixed.

> - scalable-fonts-allowed
> The type is boolean, but the docstring says it can also be a list of
> regular expressions.

Ditto.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no