From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Emanuel Berg Newsgroups: gmane.emacs.bugs Subject: bug#35163: 25.1; `narrow-to-region' docstring no mention of args Date: Fri, 05 Apr 2019 20:51:37 +0200 Message-ID: <868swoffpi.fsf@zoho.eu> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="935"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1 (gnu/linux) To: 35163@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Apr 05 20:55:39 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hCTzz-0018JE-0D for geb-bug-gnu-emacs@m.gmane.org; Fri, 05 Apr 2019 20:55:35 +0200 Original-Received: from localhost ([127.0.0.1]:45703 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hCTzy-0001qx-0R for geb-bug-gnu-emacs@m.gmane.org; Fri, 05 Apr 2019 14:55:34 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:47769) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hCTzo-0001oA-3s for bug-gnu-emacs@gnu.org; Fri, 05 Apr 2019 14:55:26 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hCTzi-0004tP-At for bug-gnu-emacs@gnu.org; Fri, 05 Apr 2019 14:55:22 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:60992) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hCTyU-0003SK-FZ for bug-gnu-emacs@gnu.org; Fri, 05 Apr 2019 14:55:13 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hCTyU-0000lw-C3 for bug-gnu-emacs@gnu.org; Fri, 05 Apr 2019 14:54:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Emanuel Berg Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 05 Apr 2019 18:54:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 35163 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.15544904172932 (code B ref -1); Fri, 05 Apr 2019 18:54:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 5 Apr 2019 18:53:37 +0000 Original-Received: from localhost ([127.0.0.1]:46303 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCTy5-0000lD-8X for submit@debbugs.gnu.org; Fri, 05 Apr 2019 14:53:37 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:60448) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCTy1-0000kw-3N for submit@debbugs.gnu.org; Fri, 05 Apr 2019 14:53:36 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:52503) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hCTwx-0001vE-Ur for submit@debbugs.gnu.org; Fri, 05 Apr 2019 14:53:26 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:45979) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hCTwu-0000ip-IA for bug-gnu-emacs@gnu.org; Fri, 05 Apr 2019 14:52:27 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hCTwi-0001ix-Qm for bug-gnu-emacs@gnu.org; Fri, 05 Apr 2019 14:52:18 -0400 Original-Received: from sender-pp-o92.zoho.eu ([185.20.209.252]:25724) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hCTwR-0000w3-7L for bug-gnu-emacs@gnu.org; Fri, 05 Apr 2019 14:52:09 -0400 ARC-Seal: i=1; a=rsa-sha256; t=1554490299; cv=none; d=zohomail.eu; s=zohoarc; b=eY7CLo+vASAtFIOJs/Ttl5lEzwEMxuk5BBb4TJYXNJIxQkBodkmKCp0ckMFjc2cSi4ZGQA+nb3X94OUqNnl8siISr6tWVGBe0Ij2JyRcx/0ZmyAMp6IksBNR8V9U2bW+dWjoQgsG6hPHX/d2AJzuO53E72zHWPdlb8ykUtN9H5E= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.eu; s=zohoarc; t=1554490299; h=Content-Type:Date:From:MIME-Version:Message-ID:Subject:To:ARC-Authentication-Results; bh=wgFgHUP9nFKlzL+sYeTFhyCDcWUZKCy92pscqVUfUFc=; b=SMahkDp501ZMNBLCQeXn9/b8u9wfhVgsvwRHlLv8nb71Fkf38hqiuPMy979GuRE9FYepe87Dv+vzXtVksMZqlyxhsXa9IjWINkrJTcDf5aUH47RBt+1nrUHTI/sBMxelR6pajS0OZmr4qndPl5KHOQhq6nSY6pONVQu9TYNKKGI= ARC-Authentication-Results: i=1; mx.zohomail.eu; dkim=pass header.i=zoho.eu; spf=pass smtp.mailfrom=moasenwood@zoho.eu; dmarc=pass header.from= header.from= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1554490299; s=admin; d=zoho.eu; i=moasenwood@zoho.eu; h=From:To:Subject:Date:Message-ID:MIME-Version:Content-Type; l=8227; bh=wgFgHUP9nFKlzL+sYeTFhyCDcWUZKCy92pscqVUfUFc=; b=IC8nWKakZe+F6ObHZAXvAwMPO36C1Aw8cPVyGy2F3Tk2ZGyOgyL75af5AbxG5pJI 7DFhEXN41bK8qSdfSK84RETi0+P3QbySNQ+/6ZU8twl0vdN04o+hMyLzXOm6CkgjUcA cSlwVaQptyoTHZLlpeZeqVm0ScPL2WDBHZPgbvzY= Original-Received: from raspberrypi.zoho.eu (c-b895225c.021-67-7570702.bbcust.telenor.se [92.34.149.184]) by mx.zoho.eu with SMTPS id 1554490298632683.1717604628724; Fri, 5 Apr 2019 20:51:38 +0200 (CEST) Mail-Copies-To: never X-ZohoMailClient: External X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:157232 Archived-At: 25.1; `narrow-to-region' docstring no mention of args The `narrow-to-region' docstring does not mention its arguments as is the norm. And it makes sense, often the first thing I do when I bring up the help buffer for a function is to search for a particular argument name to see what it does. In GNU Emacs 25.1.1 (arm-unknown-linux-gnueabihf, GTK+ Version 3.22.11) of 2017-09-16, modified by Debian built on bm-wb-02 System Description: Raspbian GNU/Linux 9.8 (stretch) Configured using: 'configure --build arm-linux-gnueabihf --prefix=/usr --sharedstatedir=/var/lib --libexecdir=/usr/lib --localstatedir=/var/lib --infodir=/usr/share/info --mandir=/usr/share/man --with-pop=yes --enable-locallisppath=/etc/emacs25:/etc/emacs:/usr/local/share/emacs/25.1/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/25.1/site-lisp:/usr/share/emacs/site-lisp --with-sound=alsa --build arm-linux-gnueabihf --prefix=/usr --sharedstatedir=/var/lib --libexecdir=/usr/lib --localstatedir=/var/lib --infodir=/usr/share/info --mandir=/usr/share/man --with-pop=yes --enable-locallisppath=/etc/emacs25:/etc/emacs:/usr/local/share/emacs/25.1/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/25.1/site-lisp:/usr/share/emacs/site-lisp --with-sound=alsa --with-x=yes --with-x-toolkit=gtk3 --with-toolkit-scroll-bars 'CFLAGS=-g -O2 -fdebug-prefix-map=/build/emacs25-pkwV6G/emacs25-25.1+1=. -fstack-protector-strong -Wformat -Werror=format-security -Wall' 'CPPFLAGS=-Wdate-time -D_FORTIFY_SOURCE=2' LDFLAGS=-Wl,-z,relro' Configured features: XPM JPEG TIFF GIF PNG RSVG IMAGEMAGICK SOUND GPM DBUS GCONF GSETTINGS NOTIFY ACL LIBSELINUX GNUTLS LIBXML2 FREETYPE M17N_FLT LIBOTF XFT ZLIB TOOLKIT_SCROLL_BARS GTK3 X11 Important settings: value of $LANG: en_GB.UTF-8 locale-coding-system: utf-8-unix Major mode: Fundamental Minor modes in effect: show-paren-mode: t shell-dirtrack-mode: t erc-list-mode: t erc-menu-mode: t erc-autojoin-mode: t erc-ring-mode: t erc-networks-mode: t erc-pcomplete-mode: t erc-match-mode: t erc-button-mode: t erc-fill-mode: t erc-stamp-mode: t erc-netsplit-mode: t erc-irccontrols-mode: t erc-noncommands-mode: t erc-move-to-prompt-mode: t erc-readonly-mode: t erc-scrolltobottom-mode: t global-eldoc-mode: t electric-indent-mode: t mouse-wheel-mode: t tool-bar-mode: t global-font-lock-mode: t font-lock-mode: t auto-composition-mode: t auto-compression-mode: t transient-mark-mode: t Recent messages: scroll-up-1: Beginning of buffer [6 times] ... o-) Saving file /home/incal/DO_THIS... Wrote /home/incal/DO_THIS Type "q" to restore previous buffer. hit: 123 This is the one occurrence. [2 times] Quit [2 times] Mark set Load-path shadows: /usr/share/emacs/25.1/site-lisp/debian-startup hides /usr/share/emacs/site-lisp/debian-startup /usr/share/emacs25/site-lisp/flim/md4 hides /usr/share/emacs/25.1/lisp/md4 /usr/share/emacs25/site-lisp/flim/hex-util hides /usr/share/emacs/25.1/lisp/hex-util ~/.emacs.d/lisp/abbrev hides /usr/share/emacs/25.1/lisp/abbrev ~/.emacs.d/emacs-init/gnus/server hides /usr/share/emacs/25.1/lisp/server /usr/share/emacs25/site-lisp/flim/sasl-ntlm hides /usr/share/emacs/25.1/lisp/net/sasl-ntlm /usr/share/emacs25/site-lisp/flim/sasl-cram hides /usr/share/emacs/25.1/lisp/net/sasl-cram /usr/share/emacs25/site-lisp/flim/ntlm hides /usr/share/emacs/25.1/lisp/net/ntlm /usr/share/emacs25/site-lisp/flim/sasl hides /usr/share/emacs/25.1/lisp/net/sasl /usr/share/emacs25/site-lisp/flim/hmac-def hides /usr/share/emacs/25.1/lisp/net/hmac-def /usr/share/emacs25/site-lisp/flim/hmac-md5 hides /usr/share/emacs/25.1/lisp/net/hmac-md5 /usr/share/emacs25/site-lisp/flim/sasl-digest hides /usr/share/emacs/25.1/lisp/net/sasl-digest /home/incal/.emacs.d/elpa/seq-2.20/seq hides /usr/share/emacs/25.1/lisp/emacs-lisp/seq /home/incal/.emacs.d/elpa/let-alist-1.0.5/let-alist hides /usr/share/emacs/25.1/lisp/emacs-lisp/let-alist Features: (shadow emacsbug conf-mode mm-archive sh-script smie executable mailalias w3m-cookie canlock url-http url-gw url-cache url-auth mail-extr qp gnus-async gnus-bcklg gnus-ml make-mode eieio-opt speedbar sb-image ezimage dframe find-func whitespace cus-edit cus-start cus-load tabify nnir cursor-sensor pop3 nndraft nnmh nnml network-stream nsm starttls gnus-agent nnvirtual nntp gnus-cache w3m-filter ffap paren xsel w3m-form google-translate-core-ui ido google-translate-core google-translate-tk url url-proxy url-privacy url-expand url-methods url-history url-cookie url-domsuf url-util url-parse url-vars json map lpr tramp-sh term disp-table ehelp my-faces t-mouse man tex-mode iterate-files seq-24 isbn my-bibtex bibtex slime-presentations slime-repl slime-parse bridge nroff-mode sgml-mode cobol-mode ada-mode which-func imenu align find-file checkdoc cc-mode cc-fonts cc-guess cc-menus cc-cmds cc-styles cc-align cc-engine cc-vars cc-defs guile summary message-my moggle mail-to-many mail smtpmail sendmail font-lock-add global-keys yank-my wrap-search w3m-unisearch w3m-search spell-new ispell sort-my sort slime etags xref project arc-mode archive-mode noutline outline easy-mmode hyperspec shell-cli revert-buffer-my lisp-new ielm kill keys help-new debug apropos dired-x compile-my mode-line compile article gnus-cite dl bookmarks w3m-bookmark file-write-to erc-my fill-new quit gnus-my group group-summary gnus-srvr gnus-score score-mode gnus-msg gnus-art mm-uu mml2015 mm-view mml-smime smime dig mailcap gnus-sum gnus-group gnus-undo gnus-start gnus-cloud nnimap nnmail mail-source tls gnutls utf7 netrc nnoo parse-time gnus-spec gnus-int gnus-range gnus-win message rfc822 mml mml-sec epg mm-decode mm-bodies mm-encode mail-parse rfc2231 rfc2047 rfc2045 ietf-drums mailabbrev gmm-utils mailheader gnus gnus-ems nnheader mail-utils edit tabs dired-my w3m-my w3m-tabs w3m-session w3m browse-url doc-view jka-compr image-mode timezone w3m-hist w3m-fb bookmark-w3m w3m-ems w3m-ccl ccl w3m-favicon w3m-image w3m-proc w3m-util time-my linux-shell files-my tramp tramp-compat tramp-loaddefs trampver ucs-normalize shell advice sudo-user-path find-command window-new count get-search-string caps-back buffer-menu switch-to-buffer super scroll dired close buc switch-to-buffer-regexp subr-x align-new erc-list erc-menu erc-join erc-ring erc-networks erc-pcomplete pcomplete comint ansi-color ring erc-track erc-match erc-button wid-edit erc-fill erc-stamp erc-netsplit erc-goodies erc erc-backend erc-compat format-spec auth-source cl-seq eieio eieio-core cl-macs gnus-util time-date mm-util help-fns mail-prsvr password-cache thingatpt pp my-string search-regexp-in-files finder-inf info slime-autoloads package epg-config seq byte-opt gv bytecomp byte-compile cl-extra help-mode easymenu cconv cl-loaddefs pcase cl-lib w3m-load mule-util tooltip eldoc electric uniquify ediff-hook vc-hooks lisp-float-type mwheel x-win term/common-win x-dnd tool-bar dnd fontset image regexp-opt fringe tabulated-list newcomment elisp-mode lisp-mode prog-mode register page menu-bar rfn-eshadow timer select scroll-bar mouse jit-lock font-lock syntax facemenu font-core frame 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 charscript case-table epa-hook jka-cmpr-hook help simple abbrev minibuffer cl-preloaded nadvice loaddefs button faces cus-face macroexp files text-properties overlay sha1 md5 base64 format env code-pages mule custom widget hashtable-print-readable backquote dbusbind inotify dynamic-setting system-font-setting font-render-setting move-toolbar gtk x-toolkit x multi-tty make-network-process emacs) Memory information: ((conses 8 562500 116792) (symbols 24 49692 133) (miscs 20 414 2943) (strings 16 124316 18946) (string-bytes 1 3748017) (vectors 8 73884) (vector-slots 4 1902625 44262) (floats 8 605 859) (intervals 28 10539 2722) (buffers 520 96)) -- underground experts united http://user.it.uu.se/~embe8573