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

[Mauro Aranda]

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.

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

- 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.

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


In GNU Emacs 28.0.50 (build 68, x86_64-pc-linux-gnu, cairo version 1.15.10)
 of 2020-09-25 built on tbb-desktop
Repository revision: 49efa8b2ff7c2e0f93d958fcca79d50d313b7e9b
Repository branch: widget-character-improvements-display-design
Windowing system distributor 'The X.Org Foundation', version 11.0.12008000
System Description: Ubuntu 18.04.5 LTS

Configured using:
 'configure --with-x-toolkit=no'

Configured features:
XPM JPEG TIFF GIF PNG CAIRO SOUND DBUS GSETTINGS GLIB NOTIFY INOTIFY
GNUTLS LIBXML2 FREETYPE HARFBUZZ ZLIB OLDXMENU X11 XDBE XIM MODULES
THREADS PDUMPER

Important settings:
  value of $LC_MONETARY: es_AR.UTF-8
  value of $LC_NUMERIC: es_AR.UTF-8
  value of $LC_TIME: es_AR.UTF-8
  value of $LANG: en_US.UTF-8
  locale-coding-system: utf-8-unix

Major mode: Org

Minor modes in effect:
  TeX-PDF-mode: t
  shell-dirtrack-mode: t
  global-semanticdb-minor-mode: t
  global-semantic-idle-scheduler-mode: t
  semantic-mode: t
  global-ede-mode: t
  ede-minor-mode: t
  tooltip-mode: t
  global-eldoc-mode: t
  electric-indent-mode: t
  mouse-wheel-mode: t
  tool-bar-mode: t
  menu-bar-mode: t
  file-name-shadow-mode: t
  global-font-lock-mode: t
  font-lock-mode: t
  auto-composition-mode: t
  auto-encryption-mode: t
  auto-compression-mode: t
  column-number-mode: t
  line-number-mode: t
  auto-fill-function: org-auto-fill-function
  transient-mark-mode: t

Load-path shadows:
None found.

Features:
(shadow emacsbug sendmail qp log-view tex-info tex texinfo sh-script
executable org-element avl-tree ol-eww ol-rmail ol-mhe ol-irc ol-info
ol-gnus nnselect nnir ol-docview doc-view jka-compr image-mode exif
ol-bibtex bibtex ol-bbdb ol-w3m ielm cl-print debug backtrace ruby-mode
smie rng-cmpct rng-nxml rng-valid rng-loc rng-uri rng-parse nxml-parse
rng-match rng-pttrn nxml-ns nxml-mode nxml-outln nxml-rap sgml-mode
nxml-util nxml-enc xmltok semantic/bovine/make semantic/bovine/make-by
ede/project-am ede/autoconf-edit autoconf autoconf-mode
ede/makefile-edit ede/make make-mode markdown-mode rx color dired-aux
ede/dired shell grep semantic/tag-write ede/locate macrostep-c cmacexp
macrostep ctune cppc pcase semantic/tag-file semantic/db-file data-debug
cedet-files semantic/bovine/c semantic/decorate/include
semantic/decorate/mode semantic/decorate pulse hideif
semantic/bovine/c-by semantic/bovine/gcc semantic/dep semantic/bovine
semantic/analyze/refs semantic/db-find semantic/db-ref semantic/db-mode
semantic/idle semantic/analyze semantic/sort semantic/scope
semantic/analyze/fcn semantic/format semantic/tag-ls semantic/find
semantic/ctxt edmacro kmacro cc-mode cc-fonts cc-guess cc-menus cc-cmds
cc-styles cc-align cc-engine cc-vars cc-defs smerge-mode diff whitespace
eieio-opt help-fns radix-tree magit-utils dash vc-bzr vc-src vc-sccs
vc-svn vc-cvs vc-rcs vc-dir ewoc log-edit pcvs-util semantic/lex-spp
ede/emacs semantic/db semantic/util-modes semantic/util semantic
semantic/tag semantic/lex semantic/fw mode-local vc-git diff-mode
bug-reference misearch multi-isearch mule-util cl-extra help-mode
gnus-fun smiley gnus-cite mail-extr gnus-async gnus-bcklg gnus-agent
gnus-srvr gnus-score score-mode nnvirtual nntp gnus-ml gnus-msg
disp-table nndoc gnus-cache gnus-dup gnus-art mm-uu mml2015 mm-view
mml-smime smime dig gnus-sum shr kinsoku svg dom gnus-group gnus-undo
gnus-start gnus-dbus dbus gnus-cloud nnimap nnmail mail-source utf7
netrc nnoo parse-time gnus-spec gnus-int gnus-range gnus-win mm-archive
message rfc822 mml mml-sec epa epg epg-config mailabbrev gmm-utils
mailheader gnutls network-stream url-cache crm debbugs-gnu add-log
debbugs soap-client mm-decode mm-bodies mm-encode url-http url-auth
mail-parse rfc2231 url-gw nsm rmc puny warnings rng-xsd rng-dt rng-util
xsd-regexp emms-librefm-stream emms-librefm-scrobbler
emms-playlist-limit emms-volume emms-volume-mixerctl emms-volume-pulse
emms-volume-amixer emms-i18n emms-history emms-score emms-stream-info
emms-metaplaylist-mode emms-bookmarks emms-cue emms-mode-line-icon
emms-browser sort emms-playlist-sort emms-last-played emms-player-xine
emms-player-mpd tq emms-playing-time emms-lyrics emms-url url url-proxy
url-privacy url-expand url-methods url-history url-cookie url-domsuf
url-util mailcap emms-streams emms-show-all emms-tag-editor emms-mark
emms-mode-line emms-cache emms-info-tinytag emms-info-metaflac
emms-info-opusinfo emms-info-ogginfo emms-info-mp3info emms-info
later-do emms-playlist-mode emms-player-vlc emms-player-mpv
emms-player-mplayer emms-player-simple emms-source-playlist
emms-source-file locate dired dired-loaddefs emms-setup emms emms-compat
gnus nnheader gnus-util rmail rmail-loaddefs rfc2047 rfc2045 ietf-drums
text-property-search mail-utils mm-util mail-prsvr cus-start cus-load
org-capture deeper-blue-theme init-org org-clock org ob ob-tangle ob-ref
ob-lob ob-table ob-exp org-macro org-footnote org-src ob-comint
org-pcomplete pcomplete org-list org-faces org-entities org-version
ob-emacs-lisp ob-core ob-eval org-table ol org-keys org-compat advice
org-macs org-loaddefs format-spec find-func cal-menu calendar
cal-loaddefs init-social newsticker newst-treeview tree-widget
newst-plainview newst-reader newst-ticker newst-backend iso8601
time-date xml derived init-cedet ede/speedbar ede/files ede ede/detect
ede/base ede/auto ede/source eieio-base eieio-speedbar speedbar ezimage
dframe eieio-custom wid-edit cedet init-octave init-rmail init-vc vc
vc-dispatcher init-cc-mode init-c init-yasnippet init-eshell eshell
esh-cmd esh-ext esh-opt esh-proc esh-io esh-arg esh-module esh-groups
esh-util init-lisp slime compile etags fileloop generator xref project
arc-mode archive-mode noutline outline easy-mmode pp comint ansi-color
ring hyperspec thingatpt init-global finder-inf init-package tex-site
slime-autoloads info package easymenu browse-url url-handlers url-parse
auth-source cl-seq eieio eieio-core cl-macs eieio-loaddefs
password-cache json subr-x map url-vars seq byte-opt gv bytecomp
byte-compile cconv cl-loaddefs cl-lib tooltip eldoc electric uniquify
ediff-hook vc-hooks lisp-float-type mwheel term/x-win x-win
term/common-win x-dnd tool-bar dnd fontset image regexp-opt fringe
tabulated-list replace newcomment text-mode elisp-mode lisp-mode
prog-mode register page tab-bar menu-bar rfn-eshadow isearch timer
select scroll-bar mouse jit-lock font-lock syntax facemenu font-core
term/tty-colors frame minibuffer cl-generic cham georgian utf-8-lang
misc-lang vietnamese tibetan thai tai-viet lao korean japanese eucjp-ms
cp51932 hebrew greek romanian slovak czech european ethiopic indian
cyrillic chinese composite charscript charprop case-table epa-hook
jka-cmpr-hook help simple abbrev obarray cl-preloaded nadvice button
loaddefs faces cus-face macroexp files window text-properties overlay
sha1 md5 base64 format env code-pages mule custom widget
hashtable-print-readable backquote threads dbusbind inotify
dynamic-setting system-font-setting font-render-setting cairo x
multi-tty make-network-process emacs)

Memory information:
((conses 16 1345052 101974)
 (symbols 48 49775 2)
 (strings 32 281832 33407)
 (string-bytes 1 7358138)
 (vectors 16 109138)
 (vector-slots 8 1799298 138816)
 (floats 8 465 339)
 (intervals 56 71694 1388)
 (buffers 992 199))