From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Phil Sainty Newsgroups: gmane.emacs.bugs Subject: bug#52290: 28.0.90; Undocumented generalized variables Date: Sun, 05 Dec 2021 14:25:54 +1300 Message-ID: <5d87e4ab47875790076e932351fe8f25@webmail.orcon.net.nz> Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII; format=flowed Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="3882"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Orcon Webmail To: 52290@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Dec 05 02:27:16 2021 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mtgJA-0000pz-4W for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 05 Dec 2021 02:27:16 +0100 Original-Received: from localhost ([::1]:60058 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mtgJ8-000054-77 for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 04 Dec 2021 20:27:14 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:34790) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtgIw-00004s-AU for bug-gnu-emacs@gnu.org; Sat, 04 Dec 2021 20:27:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:44264) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mtgIw-0004tp-3C for bug-gnu-emacs@gnu.org; Sat, 04 Dec 2021 20:27:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mtgIv-0007Fc-Vq for bug-gnu-emacs@gnu.org; Sat, 04 Dec 2021 20:27:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Phil Sainty Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 05 Dec 2021 01:27:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 52290 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.163866757227774 (code B ref -1); Sun, 05 Dec 2021 01:27:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 5 Dec 2021 01:26:12 +0000 Original-Received: from localhost ([127.0.0.1]:55807 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mtgI8-0007Dt-4O for submit@debbugs.gnu.org; Sat, 04 Dec 2021 20:26:12 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:33480) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mtgI5-0007Dh-WD for submit@debbugs.gnu.org; Sat, 04 Dec 2021 20:26:10 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:34762) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtgI5-0008Ul-R6 for bug-gnu-emacs@gnu.org; Sat, 04 Dec 2021 20:26:09 -0500 Original-Received: from smtp-1.orcon.net.nz ([60.234.4.34]:44965) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtgI1-0004lM-Kd for bug-gnu-emacs@gnu.org; Sat, 04 Dec 2021 20:26:09 -0500 Original-Received: from [10.253.37.70] (port=42467 helo=webmail.orcon.net.nz) by smtp-1.orcon.net.nz with esmtpa (Exim 4.90_1) (envelope-from ) id 1mtgHq-0002a7-Mb for bug-gnu-emacs@gnu.org; Sun, 05 Dec 2021 14:25:57 +1300 Original-Received: from ip-14-137-22-223.kinect.net.nz ([14.137.22.223]) via [10.253.37.253] by webmail.orcon.net.nz with HTTP (HTTP/1.1 POST); Sun, 05 Dec 2021 14:25:54 +1300 X-Sender: psainty@orcon.net.nz X-GeoIP: -- Received-SPF: pass client-ip=60.234.4.34; envelope-from=psainty@orcon.net.nz; helo=smtp-1.orcon.net.nz X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:221554 Archived-At: Many standard generalized variables are not listed in the manual at (info "(elisp)Setting Generalized Variables") or otherwise documented as generalized vars so far as I can see. The omission of `buffer-local-value' was what led me to check these, as it's utilised by the likes of `electric-indent-local-mode' for the :variable declaration, which I found confusing until I'd looked at the code in detail, seen that `setf' was being used on that form, and found that gv.el did indeed define this as a generalized var even though the docs didn't mention it. Comparing the manual node with the contents of gv.el... In 27.2 there are fairly few omissions from the manual: - buffer-local-value - char-table-range - cond - cons - edebug-after - if - let - let* - logand - progn In 28.0.90 the list is huge: - buffer-file-name - buffer-local-value - buffer-modified-p - buffer-name - buffer-string - buffer-substring - char-table-range - cond - cons - current-buffer - current-column - current-global-map - current-input-mode - current-local-map - current-window-configuration - default-file-modes - documentation-property - edebug-after - eq - error - face-background - face-background-pixmap - face-font - face-foreground - face-underline-p - file-modes - frame-height - frame-parameters - frame-visible-p - frame-width - get-register - getenv - global-key-binding - gv-deref - if - let - let* - local-key-binding - logand - mark - mark-marker - marker-position - mouse-position - plist-get - point - point-marker - point-max - point-min - progn - read-mouse-position - screen-height - screen-width - selected-frame - selected-screen - selected-window - standard-case-table - substring - syntax-table - visited-file-modtime - window-height - window-width - x-get-secondary-selection This list of omissions is close to twice the length of the *documented* cases. I think the manual should list these, but also at this point I think the help for any generalized variable should *automatically* state that fact, so that any future omissions are still covered to some extent, and also so that non-standard generalized vars defined by other libraries will have some documentation. -Phil In GNU Emacs 28.0.90 (build 3, x86_64-pc-linux-gnu, X toolkit, cairo version 1.15.10, Xaw scroll bars) of 2021-12-03 built on phil-lp Repository revision: 292ae07e7150a9515b587bd98f9e93ab42c3fb29 Repository branch: master Windowing system distributor 'The X.Org Foundation', version 11.0.12008000 System Description: Ubuntu 18.04.6 LTS Configured using: 'configure --prefix=/home/phil/emacs/28.0/usr/local --with-x-toolkit=lucid --without-sound --with-native-compilation' Configured features: CAIRO DBUS FREETYPE GIF GLIB GMP GNUTLS GSETTINGS HARFBUZZ JPEG JSON LCMS2 LIBXML2 MODULES NATIVE_COMP NOTIFY INOTIFY PDUMPER PNG RSVG SECCOMP THREADS TIFF TOOLKIT_SCROLL_BARS X11 XDBE XIM XPM LUCID ZLIB Important settings: value of $LC_MONETARY: en_NZ.UTF-8 value of $LC_NUMERIC: en_NZ.UTF-8 value of $LC_TIME: en_NZ.UTF-8 value of $LANG: en_NZ.UTF-8 value of $XMODIFIERS: @im=ibus locale-coding-system: utf-8-unix Major mode: Lisp Interaction Minor modes in effect: tooltip-mode: t global-eldoc-mode: t eldoc-mode: t show-paren-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 blink-cursor-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t line-number-mode: t indent-tabs-mode: t transient-mark-mode: t Load-path shadows: None found. Features: (shadow mail-extr emacsbug message rmc puny dired dired-loaddefs rfc822 mml mml-sec epa derived epg rfc6068 epg-config gnus-util rmail rmail-loaddefs auth-source eieio eieio-core eieio-loaddefs password-cache json map text-property-search time-date mm-decode mm-bodies mm-encode mail-parse rfc2231 mailabbrev gmm-utils mailheader sendmail rfc2047 rfc2045 ietf-drums mm-util mail-prsvr mail-utils sort comp comp-cstr warnings subr-x rx cl-seq cl-macs cl-extra help-mode seq byte-opt gv cl-loaddefs cl-lib bytecomp byte-compile cconv rect mule-util jka-compr info iso-transl tooltip eldoc paren electric uniquify ediff-hook vc-hooks lisp-float-type elisp-mode 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 lisp-mode prog-mode register page tab-bar menu-bar rfn-eshadow isearch easymenu timer select scroll-bar mouse jit-lock font-lock syntax 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 emoji-zwj 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 lcms2 dynamic-setting system-font-setting font-render-setting cairo x-toolkit x multi-tty make-network-process native-compile emacs) Memory information: ((conses 16 105925 9366) (symbols 48 8419 1) (strings 32 29142 2540) (string-bytes 1 935587) (vectors 16 18250) (vector-slots 8 355739 12899) (floats 8 34 34) (intervals 56 826 11) (buffers 992 13))