From unknown Mon Jun 23 02:25:24 2025 X-Loop: help-debbugs@gnu.org Subject: bug#24890: 25.1; Several documentation problems Resent-From: Jorge Morais Neto Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 06 Nov 2016 21:16:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 24890 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 24890@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.147846691425270 (code B ref -1); Sun, 06 Nov 2016 21:16:01 +0000 Received: (at submit) by debbugs.gnu.org; 6 Nov 2016 21:15:14 +0000 Received: from localhost ([127.0.0.1]:47177 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c3UmX-0006ZV-C9 for submit@debbugs.gnu.org; Sun, 06 Nov 2016 16:15:14 -0500 Received: from eggs.gnu.org ([208.118.235.92]:36336) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c3UmU-0006ZI-Su for submit@debbugs.gnu.org; Sun, 06 Nov 2016 16:15:11 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c3UmM-0003xG-DH for submit@debbugs.gnu.org; Sun, 06 Nov 2016 16:15:05 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,FREEMAIL_FROM, T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:53978) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1c3UmM-0003x6-9w for submit@debbugs.gnu.org; Sun, 06 Nov 2016 16:15:02 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:55533) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c3UmI-0007rz-E4 for bug-gnu-emacs@gnu.org; Sun, 06 Nov 2016 16:15:02 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c3UmE-0003rv-Vj for bug-gnu-emacs@gnu.org; Sun, 06 Nov 2016 16:14:58 -0500 Received: from mail-qt0-x22e.google.com ([2607:f8b0:400d:c0d::22e]:33579) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1c3UmE-0003qR-Mt for bug-gnu-emacs@gnu.org; Sun, 06 Nov 2016 16:14:54 -0500 Received: by mail-qt0-x22e.google.com with SMTP id p16so76948791qta.0 for ; Sun, 06 Nov 2016 13:14:54 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:from:date:message-id:subject:to :content-transfer-encoding; bh=phfJkd4GpE9p8ypCG1em4sVpdnuRiAzi3AAJQNJ9Bdc=; b=XkdLLEELDNqe/3RRnNvkONEp71Zg6jUSkdUGKinHzUr0xV6l/GdP7fBTcjtQk8C4uC 8COg7vdKFysaNBEU3cccdd0VmeHH8tppbOIflFJ5mH99RbsJA5bzRRPzQwM8DcI7m6ik G6JQLpBfzRwlEpbKpdAVMwN1lsdtdB21kDNr6/PGGe7F6BXMhMpCJTCH8xPPgt1h7OXO rT4ZKQHxHUXkN5ISXEQu17+tmd+jzgxOPAO0rNXrmc+3Dm1gCe5hQ8bsvH6h57Ifatrx Lc57i/9OF5ovgM3M7fbKvrpau/3Kw1DP9y2XU+GRENKnXjdJ5I6PpmxUIC1u/ldN0UxH kMiQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:sender:from:date:message-id:subject :to:content-transfer-encoding; bh=phfJkd4GpE9p8ypCG1em4sVpdnuRiAzi3AAJQNJ9Bdc=; b=H4p6WjdCyySBunnWZjQlwYwb/s+Jbbu9fs6cmJOUHa+n6GeRPPxakuHFT1bnZu5g/Y 3IWzt9affHm9CxhRT7RVCC4xlEx9jKA9F4LSDfEsf4+hJSqgOgsXiAXyDoexndQKs8Nx Wrangf6AhAsqF0/LSPbTVmIgtL6d25BUIbnMmBHRruHuqNRB1YxX0inAWkOOXI/tvqci se8z6fmLM9QWqgyhM9Ub+5t+BZuVOGX7EfNSBEyZPPB87Ajo7QiBYSK4qHRWdtooxRdM WhDWutC3vyQT/JowDYjbS0dqnPCWDOLXdeDegQZIdflx6fwJMJvMxL08do4muJf7IjPh lCnQ== X-Gm-Message-State: ABUngve6lDLddh6epRbpa+ki7dMENTkQiQjj/euevFzj/V7Hch8IqTsGC6y8oY7RFD14pMI7F6gvhZWmgJys+A== X-Received: by 10.200.47.38 with SMTP id j35mr3625771qta.136.1478466893524; Sun, 06 Nov 2016 13:14:53 -0800 (PST) MIME-Version: 1.0 Received: by 10.55.180.129 with HTTP; Sun, 6 Nov 2016 13:14:52 -0800 (PST) From: Jorge Morais Neto Date: Sun, 6 Nov 2016 19:14:52 -0200 X-Google-Sender-Auth: aU7s_262---9SvhMt3iDMo9gqK4 Message-ID: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable 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-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) I am sorry for having taken this long to report these problems as I said I would. 1) outline-hide-sublevels and outline-hide-other\\ The docstrings and the manual should say that each of these commands rev= eals everything it does not actively hide. For example, outline-hide-subleve= ls reveals the top N levels of headlines and the top headless body, and all= else is hidden. So if N is 2 and some level 1 tree was folded, its children = will be actively revealed. Also, please document that, for outline-hide-sublevels, N defaults to th= e level of the current headline. Finally, perhaps the manual should mention that hide-sublevels, hide-oth= er and some other commands are actually deprecated aliases. 2) [[info:emacs#Outline Visibility]] informs that hide-body does not hide the top headless body. This information should also be in the docstring. Also, maybe the manual should inform that "hide-body" is a deprecated alias fo= r "outline-hide-body". 3) Tutorial 1. In section "* AUTO SAVE", the tutorial mentions "recover-file" where "recover-this-file" would be better and perhaps recover-session would= be best. 2. Why does section "* MULTIPLE FRAMES" use "M-x make-frame" and "M-x delete-frame" instead of "C-x 5 2" and "C-x 5 0" respectively? 3. In section "* GETTING MORE HELP": 1) #+BEGIN_QUOTE Multi-character commands such as C-x C-s and (if you have no META = or EDIT or ALT key) v are also allowed after C-h c. #+END_QUOTE The way that is written, some user might think that "C-h c v"= only works if the terminal lacks a META or EDIT or Alt key. I suggest replacing the parenthesized text by "(alternative to M-v)", positi= oned just after "v". 2) #+BEGIN_QUOTE C-h a Command Apropos. Type in a keyword and Emacs will list all the commands whose names contain that keyword. These commands can all= be invoked with META-x. For some commands, Command Apropos will also= list a one or two character sequence which runs the same command. #+END_QUOTE In the last sentence please replace "one or two" =E2=86=92 "short"= , as some commands (like find-file-other-frame) have character sequences of = 3-4 chars. 3) #+BEGIN_QUOTE C-h i Read included Manuals (a.k.a. Info). This command puts you into a special buffer called `*info*' where you can read manuals for the packages installed on your system. Type m emacs to read = the Emacs manual. If you have never before used Info, type ? and Emac= s will take you on a guided tour of Info mode facilities. #+END_QUOTE The guided tour is provided by "h". "?" is also useful, but provi= des Info-summary, not the tutorial. Complete beginners need "h" first= , then "?" for a quick reminder each time they forget a keybinding. 4) [[info:emacs#Exiting]] says C-z is bound to suspend-emacs. It is actually bound to suspend-frame. Only several paragraphs below does the manual report = the correct information. Please correct the first mention of "C-z". 5) [[info:emacs#Mode Line]] omits the "@" of emacsclient frames. 6) [[info:emacs#Completion Styles]] on partial-completion Says that #+BEGIN_QUOTE Furthermore, a =E2=80=98*=E2=80=99 in the minibuffer text is treated as = a =E2=80=9Cwildcard=E2=80=9D=E2=80=94it matches any character at the corresponding position in the completion alternative. #+END_QUOTE Actually it matches any /string/ at the corresponding position. 7) "list-command-history" docstring is confusing. It says "List history of commands typed to minibuffer." This does not clearly explain that the command lists the history of commands that /used/ the minibuffer, includ= ing those that were invoked by keys. 8) [[info:emacs#Yes or No Prompts]] 1. Swaps "M-v" with "C-v". 2. In the last paragraph it says: #+BEGIN_QUOTE use the history commands =E2=80=98M-p=E2=80=99 and =E2=80=98M-f=E2=80= =99, etc. #+END_QUOTE It probably meant M-n instead of M-f. 9) [[info:emacs#Help Mode]] says: #+BEGIN_QUOTE While retracing your steps, you can go forward by using =E2=80=98C-c C-b= =E2=80=99 (=E2=80=98help-go-forward=E2=80=99). #+END_QUOTE "help-go-forward" is not "C-c C-b". Also, the section omits the handy single-letter aliases: "l" ("C-c C-b")= , "r" ("C-c C-f"). 10) [[info:emacs#Misc Help]]: In the paragraph for describe-mode, please me= ntion that it shows the key bindings, which is very useful. 11) "set-mark-command" docstring omits the behavior of activating the mark. Also it says: #+BEGIN_QUOTE Also push the old mark on global mark ring, if the previous mark was se= t in another buffer. #+END_QUOTE Actually, AFAICT it pushes to the global mark ring /the mark just set/. 12) "C-[" for "" and "C-i" for ""\\ The manual and probably also the tutorial should mention at the beginni= ng that C-[ is an alias for . It is very useful because C-[ is faste= r to type. Sometimes the difference is big, such as in "C-x ESC ESC" =E2=86= =92 "C-x C-[ C-[". In fact it is sometimes faster to type C-[ * than M-*. C-i as an alias for TAB is also very useful. For example, to bring an = Org buffer to startup visibility, "C-u C-u C-i" is faster to type than "C-u C-u ". 13) [[info:elisp#Coding Conventions]] #+BEGIN_QUOTE =E2=80=A2 If loading the file adds functions to hooks, define a functio= n =E2=80=98FEATURE-unload-hook=E2=80=99, where FEATURE is the name of the= feature the package provides, and make it undo any such changes. Using =E2=80=98unload-fea= ture=E2=80=99 to unload the file will run this function. #+END_QUOTE info:elisp#Unloading, however, mentions /FEATURE-unload-function/ inste= ad of /FEATURE-unload-hook/. 14) [[info:emacs#Other Repeating Search]]: In my test, "M-s o" does not "Run =E2=80=98occur=E2=80=99 using the search string of the last incremental string search." Instea= d it calls "occur" and asks for the pattern. The pattern can then be yanked= with "M-n". 15) [[info:emacs#Dynamic Abbrevs]] imprecision =E2=80=93 it says: #+BEGIN_QUOTE After scanning the current buffer, =E2=80=98M-/=E2=80=99 normally searc= hes other buffers, unless you have set =E2=80=98dabbrev-check-all-buffers=E2=80=99 to =E2= =80=98nil=E2=80=99. #+END_QUOTE Actually, according to the docstrings of "dabbrev-check-all-buffers" an= d "dabbrev-check-other-buffers", the "unless=E2=80=A6" part is imprecise.= I suggest rewriting to #+BEGIN_QUOTE After scanning the current buffer, =E2=80=98M-/=E2=80=99 normally searc= hes other buffers. This can be customized via the options "dabbrev-check-other-buffers" an= d "dabbrev-check-all-buffers". #+END_QUOTE Also, the docstring of "dabbrev-expand" should mention these two option= s. And it should fully describe the behavior when both options are left at their defaults. Currently it does not say what happens by default if n= o suitable preceding word is found in the buffers accepted by the functio= n pointed out by dabbrev-friend-buffer-function. In GNU Emacs 25.1.1 (x86_64-unknown-linux-gnu, GTK+ Version 3.18.9) of 2016-09-18 built on jorge-HP-G42 Windowing system distributor 'The X.Org Foundation', version 11.0.11804000 System Description: Ubuntu 16.04.1 LTS Configured using: 'configure --prefix=3D/usr/local/emacs/ --with-modules' 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 MODULES Important settings: value of $LC_CTYPE: pt_BR.UTF-8 value of $LC_MONETARY: pt_BR.UTF-8 value of $LC_NUMERIC: pt_BR.UTF-8 value of $LC_TIME: en_DK.UTF-8 value of $LANG: en_US.UTF-8 value of $XMODIFIERS: @im=3Dibus locale-coding-system: utf-8-unix Major mode: Org Minor modes in effect: diff-auto-refine-mode: t recentf-mode: t org-bullets-mode: t flyspell-mode: t column-enforce-mode: t helm-descbinds-mode: t helm-mode: t shell-dirtrack-mode: t async-bytecomp-package-mode: t window-numbering-mode: t global-edit-server-edit-mode: t show-paren-mode: t global-whitespace-mode: t tooltip-mode: t global-eldoc-mode: t electric-quote-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 size-indication-mode: t column-number-mode: t line-number-mode: t auto-fill-function: org-auto-fill-function transient-mark-mode: t Recent messages: Reverting buffer =E2=80=98agenda=E2=80=99. Saving file /home/jorge/org/agenda/gen=C3=A9rico.org... Wrote /home/jorge/org/agenda/gen=C3=A9rico.org Reverting buffer =E2=80=98agenda=E2=80=99. Saved text until "-buffers is non-nil (it defaults to t). " Save your position in the tutorial? (y or n) n Tutorial position not saved q is undefined Load-path shadows: /home/jorge/.emacs.d/elpa/org-bullets-20140918.1137/org-bullets hides /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-bullets ~/.emacs.d/lisp/dired-aux hides /usr/local/emacs/share/emacs/25.1/lisp/dire= d-aux /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-fortran hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-fortran /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-mhe hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-mhe /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-docview hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-docview /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-eshell hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-eshell /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-tangle hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-tangle /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-plot hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-plot /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-calc hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-calc /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-crypt hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-crypt /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-js hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-js /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-irc hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-irc /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-publish hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-publish /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-latex hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-latex /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-scala hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-scala /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-icalendar hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-icalendar /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-gnuplot hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-gnuplot /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-beamer hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-beamer /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-C hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-C /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-bibtex hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-bibtex /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-entities hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-entities /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-core hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-core /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-colview hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-colview /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org hides /usr/local/emacs/share/emacs/25.1/lisp/org/org /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-ocaml hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-ocaml /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-id hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-id /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-install hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-install /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-loaddefs hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-loaddefs /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-pcomplete hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-pcomplete /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-odt hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-odt /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-sass hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-sass /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-org hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-org /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-table hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-table /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-eval hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-eval /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-compat hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-compat /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-octave hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-octave /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-ascii hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-ascii /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-org hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-org /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-ledger hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-ledger /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-capture hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-capture /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-io hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-io /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-R hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-R /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-texinfo hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-texinfo /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-gnus hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-gnus /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-emacs-lisp hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-emacs-lisp /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-sql hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-sql /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-bbdb hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-bbdb /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-exp hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-exp /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-clojure hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-clojure /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-plantuml hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-plantuml /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-table hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-table /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-man hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-man /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-feed hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-feed /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-awk hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-awk /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-keys hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-keys /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-ruby hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-ruby /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-info hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-info /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-dot hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-dot /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-ditaa hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-ditaa /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-ref hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-ref /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-habit hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-habit /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-maxima hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-maxima /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-inlinetask hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-inlinetask /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-macs hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-macs /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-timer hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-timer /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-clock hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-clock /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-md hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-md /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-lisp hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-lisp /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-lob hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-lob /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-html hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-html /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-rmail hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-rmail /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-sqlite hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-sqlite /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-archive hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-archive /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-agenda hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-agenda /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-version hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-version /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-css hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-css /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-screen hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-screen /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-footnote hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-footnote /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-faces hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-faces /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-asymptote hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-asymptote /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-python hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-python /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-scheme hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-scheme /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-comint hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-comint /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-ctags hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-ctags /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-makefile hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-makefile /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-list hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-list /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-java hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-java /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-src hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-src /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-w3m hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-w3m /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-indent hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-indent /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-mscgen hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-mscgen /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-element hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-element /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-picolisp hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-picolisp /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-attach hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-attach /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-haskell hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-haskell /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-macro hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-macro /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-latex hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-latex /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-shen hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-shen /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-mobile hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-mobile /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-perl hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-perl /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-mouse hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-mouse /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-matlab hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-matlab /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-datetree hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-datetree /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-protocol hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-protocol /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-lilypond hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-lilypond Features: (shadow sort mail-extr emacsbug helm-ring two-column chistory term/xterm xterm tutorial sendmail gnus-msg gnus-art mm-uu mml2015 mm-view mml-smime smime dig gnus-sum gnus-group gnus-undo gnus-start gnus-cloud nnimap nnmail mail-source utf7 netrc nnoo gnus-spec gnus-int gnus-range gnus-win gnus gnus-ems nnheader org-timer org-colview org-attach vc-git reporter tabify eieio-opt speedbar sb-image ezimage dframe face-remap helm-font dabbrev org-capture timezone diff-mode diff wdired helm-dabbrev term ehelp org-lint ox-odt rng-loc rng-uri rng-parse rng-match rng-dt rng-util rng-pttrn nxml-parse nxml-ns nxml-enc xmltok nxml-util ox-latex ox-icalendar ox-html table ox-ascii ox-publish ox org-archive autorevert help-at-pt cal-move parse-time org-clock char-fold misearch multi-isearch iso-transl tramp-cache tramp-sh recentf tree-widget ido cal-iso solar cal-dst cal-julian appt org-eldoc org-bullets flyspell org-depend org-w3m org-rmail org-mhe org-irc org-info org-id org-gnus org-docview doc-view subr-x jka-compr image-mode org-bibtex bibtex org-bbdb org-element avl-tree J-org diary-lib diary-loaddefs orgtbl-show-header org-table org-protocol org-mobile org-agenda org-expiry filenotify org org-macro org-footnote org-pcomplete org-list org-faces org-entities noutline outline org-version ob-emacs-lisp ob ob-tangle org-src ob-ref ob-lob ob-table ob-keys ob-exp ob-comint ob-core ob-eval org-compat org-macs org-loaddefs find-func mm-archive message rfc822 mml mml-sec mailabbrev gmm-utils mailheader mm-decode mm-bodies mm-encode url-handlers mail-utils network-stream nsm starttls url-http tls gnutls mail-parse rfc2231 rfc2047 rfc2045 ietf-drums url-gw url-cache url-auth epg winner helm-command helm-elisp helm-eval edebug rainbow-delimiters column-enforce-mode cl ispell edit-server-htmlize html2text cus-edit wid-edit helm-descbinds helm-mode helm-files rx tramp tramp-compat tramp-loaddefs trampver ucs-normalize shell pcomplete ffap thingatpt helm-buffers helm-elscreen helm-tags helm-bookmark helm-adaptive helm-info bookmark pp helm-locate helm-grep helm-regexp helm-external helm-net browse-url xml url url-proxy url-privacy url-expand url-methods url-history url-cookie url-domsuf url-util url-parse auth-source gnus-util mm-util help-fns mail-prsvr password-cache url-vars mailcap helm-utils compile comint ansi-color ring helm-help helm-types helm derived helm-source eieio-compat eieio eieio-core helm-multi-match helm-lib cl-seq helm-config helm-easymenu edmacro kmacro cl-macs async-bytecomp async J-bc window-numbering edit-server solarized-light-theme solarized color dash easy-mmode advice dired+ image-dired format-spec image-file dired-aux dired-x dired finder-inf info package epg-config seq byte-opt gv bytecomp byte-compile cl-extra help-mode cconv cl-loaddefs pcase cl-lib disp-table paren whitespace cus-start cus-load holidays hol-loaddefs cal-menu easymenu calendar cal-loaddefs J-local server time-date 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 16 2655637 322584) (symbols 48 67629 10) (miscs 40 15820 16990) (strings 32 286913 56350) (string-bytes 1 9933897) (vectors 16 87909) (vector-slots 8 2268496 189885) (floats 8 1374 1152) (intervals 56 378977 14831) (buffers 976 124) (heap 1024 185650 16507)) --=20 =E2=80=A2 I am Brazilian. I hope my English is correct and I welcome corre= ctions. =E2=80=A2 Please adopt free formats like PDF, ODF, Org, LaTeX, Opus, WebM a= nd 7z. =E2=80=A2 Free (as in free speech) software for Android: https://f-droid.or= g/ From unknown Mon Jun 23 02:25:24 2025 X-Loop: help-debbugs@gnu.org Subject: bug#24890: 25.1; Several documentation problems Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 07 Nov 2016 17:57:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24890 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Jorge Morais Neto Cc: 24890@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 24890-submit@debbugs.gnu.org id=B24890.14785413959343 (code B ref 24890); Mon, 07 Nov 2016 17:57:01 +0000 Received: (at 24890) by debbugs.gnu.org; 7 Nov 2016 17:56:35 +0000 Received: from localhost ([127.0.0.1]:48636 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c3o9q-0002Qd-TZ for submit@debbugs.gnu.org; Mon, 07 Nov 2016 12:56:35 -0500 Received: from eggs.gnu.org ([208.118.235.92]:35570) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c3o9o-0002QP-Kr for 24890@debbugs.gnu.org; Mon, 07 Nov 2016 12:56:33 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c3o9g-0000Qt-Bk for 24890@debbugs.gnu.org; Mon, 07 Nov 2016 12:56:27 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_50,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:39963) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c3o9g-0000Qp-7Y; Mon, 07 Nov 2016 12:56:24 -0500 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2167 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1c3o9f-0002Fo-GP; Mon, 07 Nov 2016 12:56:23 -0500 Date: Mon, 07 Nov 2016 19:56:54 +0200 Message-Id: <834m3ji36h.fsf@gnu.org> From: Eli Zaretskii In-reply-to: (message from Jorge Morais Neto on Sun, 6 Nov 2016 19:14:52 -0200) References: MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -7.9 (-------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -7.9 (-------) > From: Jorge Morais Neto > Date: Sun, 6 Nov 2016 19:14:52 -0200 > > I am sorry for having taken this long to report these problems as I > said I would. Thank you for your report. In the future, please consider dividing such long reports into chunks that pertain to related issues. It is hard to discuss and manage a report about so many unrelated subjects. > 1) outline-hide-sublevels and outline-hide-other\\ > The docstrings and the manual should say that each of these commands reveals > everything it does not actively hide. AFAIU, "everything" here boils down to the top body without a heading, if any. Because the fact that all the levels N and above are revealed is mentioned in the doc string already, right? I added a sentence about the heading-less body being unhidden. > Also, please document that, for outline-hide-sublevels, N defaults to the > level of the current headline. Done. I also documented the effect of the prefix argument. > Finally, perhaps the manual should mention that hide-sublevels, hide-other > and some other commands are actually deprecated aliases. I simply replaced the obsolete names with the current ones. > 2) [[info:emacs#Outline Visibility]] informs that hide-body does not > hide the top headless body. This information should also be in the > docstring. Added. > Also, maybe the manual should inform that "hide-body" is a > deprecated alias for "outline-hide-body". See above: I replaced the obsolete name. > 3) Tutorial > 1. In section "* AUTO SAVE", the tutorial mentions "recover-file" where > "recover-this-file" would be better and perhaps recover-session would be > best. > 2. Why does section "* MULTIPLE FRAMES" use "M-x make-frame" and > "M-x delete-frame" instead of "C-x 5 2" and "C-x 5 0" respectively? > 3. In section "* GETTING MORE HELP": > 1) > #+BEGIN_QUOTE > Multi-character commands such as C-x C-s and (if you have no META or > EDIT or ALT key) v are also allowed after C-h c. > #+END_QUOTE > The way that is written, some user might think that "C-h c v" only > works if the terminal lacks a META or EDIT or Alt key. I suggest > replacing the parenthesized text by "(alternative to M-v)", positioned > just after "v". > 2) > #+BEGIN_QUOTE > C-h a Command Apropos. Type in a keyword and Emacs will list all the > commands whose names contain that keyword. These commands can all be > invoked with META-x. For some commands, Command Apropos will also list > a one or two character sequence which runs the same command. > #+END_QUOTE > In the last sentence please replace "one or two" → "short", as some > commands (like find-file-other-frame) have character sequences of 3-4 > chars. > 3) > #+BEGIN_QUOTE > C-h i Read included Manuals (a.k.a. Info). This command puts you into a > special buffer called `*info*' where you can read manuals for the > packages installed on your system. Type m emacs to read the > Emacs manual. If you have never before used Info, type ? and Emacs > will take you on a guided tour of Info mode facilities. > #+END_QUOTE > The guided tour is provided by "h". "?" is also useful, but provides > Info-summary, not the tutorial. Complete beginners need "h" first, > then "?" for a quick reminder each time they forget a keybinding. All fixed. > 4) [[info:emacs#Exiting]] says C-z is bound to suspend-emacs. It is > actually bound to suspend-frame. Only several paragraphs below does > the manual report the correct information. Please correct the > first mention of "C-z". Fixed. > 5) [[info:emacs#Mode Line]] omits the "@" of emacsclient frames. Added. > 6) [[info:emacs#Completion Styles]] on partial-completion > Says that > #+BEGIN_QUOTE > Furthermore, a ‘*’ in the minibuffer text is treated as a “wildcard”—it > matches any character at the corresponding position in the completion > alternative. > #+END_QUOTE > Actually it matches any /string/ at the corresponding position. Fixed. > 7) "list-command-history" docstring is confusing. It says "List history of > commands typed to minibuffer." This does not clearly explain that the > command lists the history of commands that /used/ the minibuffer, including > those that were invoked by keys. Fixed. > 8) [[info:emacs#Yes or No Prompts]] > 1. Swaps "M-v" with "C-v". > 2. In the last paragraph it says: > #+BEGIN_QUOTE > use the history commands ‘M-p’ and ‘M-f’, etc. > #+END_QUOTE > It probably meant M-n instead of M-f. Both fixed. > 9) [[info:emacs#Help Mode]] says: > #+BEGIN_QUOTE > While retracing your steps, you can go forward by using ‘C-c C-b’ > (‘help-go-forward’). > #+END_QUOTE > "help-go-forward" is not "C-c C-b". > > Also, the section omits the handy single-letter aliases: "l" ("C-c C-b"), "r" > ("C-c C-f"). Fixed. > 10) [[info:emacs#Misc Help]]: In the paragraph for describe-mode, please mention > that it shows the key bindings, which is very useful. Done. > 11) "set-mark-command" docstring omits the behavior of activating the mark. > Also it says: > #+BEGIN_QUOTE > Also push the old mark on global mark ring, if the previous mark was set > in another buffer. > #+END_QUOTE > Actually, AFAICT it pushes to the global mark ring /the mark just set/. Fixed. > 12) "C-[" for "" and "C-i" for ""\\ > The manual and probably also the tutorial should mention at the beginning > that C-[ is an alias for . It is very useful because C-[ is faster to > type. Sometimes the difference is big, such as in "C-x ESC ESC" → "C-x C-[ > C-[". In fact it is sometimes faster to type C-[ * than M-*. > > C-i as an alias for TAB is also very useful. For example, to bring an Org > buffer to startup visibility, "C-u C-u C-i" is faster to type than > "C-u C-u ". I understand your point, but I don't see how telling this in a (very large) manual will make these conveniences visible enough to justify the changes. We don't even have a section in the manual that describes special keys, to begin with. > 13) [[info:elisp#Coding Conventions]] > #+BEGIN_QUOTE > • If loading the file adds functions to hooks, define a function > ‘FEATURE-unload-hook’, where FEATURE is the name of the feature the package > provides, and make it undo any such changes. Using ‘unload-feature’ to > unload the file will run this function. > #+END_QUOTE > info:elisp#Unloading, however, mentions /FEATURE-unload-function/ instead of > /FEATURE-unload-hook/. They can both be used, but the -hook variant is obsolete, so I replaced it with -function. > 14) [[info:emacs#Other Repeating Search]]: In my test, "M-s o" does not "Run ‘occur’ > using the search string of the last incremental string search." Instead it > calls "occur" and asks for the pattern. The pattern can then be yanked with > "M-n". I cannot reproduce this. The feature works for me as documented. Did you invoke "M-s o" during the incremental search, i.e. after typing "C-s SOME-TEXT"? > 15) [[info:emacs#Dynamic Abbrevs]] imprecision – it says: > #+BEGIN_QUOTE > After scanning the current buffer, ‘M-/’ normally searches other buffers, > unless you have set ‘dabbrev-check-all-buffers’ to ‘nil’. > #+END_QUOTE > > Actually, according to the docstrings of "dabbrev-check-all-buffers" and > "dabbrev-check-other-buffers", the "unless…" part is imprecise. I suggest > rewriting to > #+BEGIN_QUOTE > After scanning the current buffer, ‘M-/’ normally searches other buffers. > This can be customized via the options "dabbrev-check-other-buffers" and > "dabbrev-check-all-buffers". > #+END_QUOTE Done. > Also, the docstring of "dabbrev-expand" should mention these two options. Added. Also added a couple of other relevant options. > And it should fully describe the behavior when both options are left at > their defaults. Currently it does not say what happens by default if no > suitable preceding word is found in the buffers accepted by the function > pointed out by dabbrev-friend-buffer-function. Not sure what you mean by the last sentence: did you mean the error that is signaled? All the changes were done on the emacs-25 branch, except the tutorial, whose fixes were pushed to master (because tutorial translations need to catch up). Thanks. From unknown Mon Jun 23 02:25:24 2025 X-Loop: help-debbugs@gnu.org Subject: bug#24890: 25.1; Several documentation problems Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 07 Nov 2016 18:07:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24890 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii , Jorge Morais Neto Cc: 24890@debbugs.gnu.org Received: via spool by 24890-submit@debbugs.gnu.org id=B24890.147854200410307 (code B ref 24890); Mon, 07 Nov 2016 18:07:01 +0000 Received: (at 24890) by debbugs.gnu.org; 7 Nov 2016 18:06:44 +0000 Received: from localhost ([127.0.0.1]:48645 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c3oJg-0002gA-Er for submit@debbugs.gnu.org; Mon, 07 Nov 2016 13:06:44 -0500 Received: from aserp1040.oracle.com ([141.146.126.69]:49720) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c3oJf-0002fw-4k for 24890@debbugs.gnu.org; Mon, 07 Nov 2016 13:06:43 -0500 Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id uA7I6ah5005052 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 7 Nov 2016 18:06:37 GMT Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id uA7I6aED006688 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Mon, 7 Nov 2016 18:06:36 GMT Received: from abhmp0001.oracle.com (abhmp0001.oracle.com [141.146.116.7]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id uA7I6XOK028810; Mon, 7 Nov 2016 18:06:34 GMT MIME-Version: 1.0 Message-ID: <14b1d7f9-22cc-4391-972e-8e28ff8ee23e@default> Date: Mon, 7 Nov 2016 10:06:29 -0800 (PST) From: Drew Adams References: <834m3ji36h.fsf@gnu.org> In-Reply-To: <834m3ji36h.fsf@gnu.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6753.5000 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0021.oracle.com [156.151.31.71] X-Spam-Score: -7.8 (-------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -7.8 (-------) Thanks, to both of you, for working on this! From unknown Mon Jun 23 02:25:24 2025 X-Loop: help-debbugs@gnu.org Subject: bug#24890: 25.1; Several documentation problems Resent-From: Jorge Morais Neto Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 10 Nov 2016 14:38:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24890 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 24890@debbugs.gnu.org Received: via spool by 24890-submit@debbugs.gnu.org id=B24890.147878862723009 (code B ref 24890); Thu, 10 Nov 2016 14:38:02 +0000 Received: (at 24890) by debbugs.gnu.org; 10 Nov 2016 14:37:07 +0000 Received: from localhost ([127.0.0.1]:51827 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c4qTT-0005z3-2z for submit@debbugs.gnu.org; Thu, 10 Nov 2016 09:37:07 -0500 Received: from mail-qk0-f171.google.com ([209.85.220.171]:33782) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c4qTQ-0005yX-SR for 24890@debbugs.gnu.org; Thu, 10 Nov 2016 09:37:05 -0500 Received: by mail-qk0-f171.google.com with SMTP id x190so296025565qkb.0 for <24890@debbugs.gnu.org>; Thu, 10 Nov 2016 06:37:04 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:from:date:message-id :subject:to:cc:content-transfer-encoding; bh=9wq1vaz1ywer+FViEfr1cb+J6AZkG1u5LE7uGj7XfIc=; b=A2gGoVGxFVgHOIS7hmSRSZi38ix/xFCwcEWqV2YEt6+D+SUtm1l0kjWgBZjPbt1yO0 XG+VhJDzYNhocBMNDRFuP6yoFCmvEcmGYAQFZLL5hp8qjWnef8Ucm6d4RsCuxYuR38Zs H4qId9fFmeEj0/o9z++hjSrrX6NfX2241E/aoxRggBFTp0V3ZPFk/GlfQbG1PxbapMex 1wrvHyJxZ7AxJtIu4WTh1yOqJ6j7YocfCcAZ6IHTvb1SBHOF5fdd0mVt/XCVv/9pdSuc sMSi5bZ3CIS3L5CSvlpNTaIvi/t0oofCfl/ABfp+cJcuUTiCVbVX/YZ00locQLjEy//2 RjiA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:sender:in-reply-to:references:from :date:message-id:subject:to:cc:content-transfer-encoding; bh=9wq1vaz1ywer+FViEfr1cb+J6AZkG1u5LE7uGj7XfIc=; b=GCxCR9oTatk0Z8UVPWU/OLuHjt6NY9nRH2dDkqFMMTf0LxTqQsns+5+02aDFdfMNwy f8BG6YInBDOQXbiOUgOGrOCK928UjRPFQo5ECg/5+GQNoZKrLUHDhd3qI4O4OLiABGmU Rh+ccAeO3nZCInuK187bpax4uz/ddeYAc387wEh0qDdvXXKlEqhWyhQ8Mq8wq1MUe2+s Xfo0BTEHH3FJeYOkjmIMCGl9GD2mSQGXVc9ROohPjKZsmJLLHqi6vq10IMkccXnaVwOP ryn0bMTuAfGZvr8UnQThLC8+wDNJZGUJIAV4cg4Zqkqzyhm731hMmRdVwshvkdkWBXjz DtJA== X-Gm-Message-State: ABUngvftHGf+UoUs5EpuuErYP/2xrECKnzHwFpdVflrrzT/bSjHLAlladeKknbSCkDRDytEiT2RKE43U8tRtrA== X-Received: by 10.55.175.198 with SMTP id y189mr288649qke.293.1478788619029; Thu, 10 Nov 2016 06:36:59 -0800 (PST) MIME-Version: 1.0 Received: by 10.233.220.68 with HTTP; Thu, 10 Nov 2016 06:36:58 -0800 (PST) In-Reply-To: <834m3ji36h.fsf@gnu.org> References: <834m3ji36h.fsf@gnu.org> From: Jorge Morais Neto Date: Thu, 10 Nov 2016 12:36:58 -0200 X-Google-Sender-Auth: zbHLIAg0vrg1nw6Z5UJGhkq8jag Message-ID: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.4 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.4 (--) Sorry I took this long to reply. On 7 November 2016 at 15:56, Eli Zaretskii wrote: >> From: Jorge Morais Neto > In the future, please consider dividing such long reports into chunks > that pertain to related issues. It is hard to discuss and manage a > report about so many unrelated subjects. OK. >> 1) outline-hide-sublevels and outline-hide-other\\ >> The docstrings and the manual should say that each of these commands = reveals >> everything it does not actively hide. > > AFAIU, "everything" here boils down to the top body without a heading, > if any. Because the fact that all the levels N and above are revealed > is mentioned in the doc string already, right? In git (branch emacs-25), the docstring of outline-hide-sublevels is only: "Hide everything but the top LEVELS levels of headers, in whole buffer. This also unhides the top heading-less body, if any. Interactively, the prefix argument supplies the value of LEVELS. When invoked without a prefix argument, LEVELS defaults to the level of the current heading, or to 1 if the current line is not a heading." In my understanding, this still does not fully document the behavior of actively revealing all headers up to level LEVELS. The docstring of outline-hide-other is also incomplete in this sense because it does not fully document that it actively reveals the body of the current entry (it then becomes visible even if it was previously hidden). >> 14) [[info:emacs#Other Repeating Search]]: In my test, "M-s o" does not = "Run =E2=80=98occur=E2=80=99 >> using the search string of the last incremental string search." Ins= tead it >> calls "occur" and asks for the pattern. The pattern can then be yan= ked with >> "M-n". > > I cannot reproduce this. The feature works for me as documented. Did > you invoke "M-s o" during the incremental search, i.e. after typing > "C-s SOME-TEXT"? The manual says: Run =E2=80=98occur=E2=80=99 using the search string of the last increme= ntal string search. You can also run =E2=80=98M-s o=E2=80=99 when an incremental s= earch is active; this uses the current search string. If I understand English correctly (I am Brazilian) the first sentence cited above says that if you run an incremental search, exit it (e.g. by pressing RET), and later type M-s o, it will automatically run =E2=80=98occur=E2=80=99 using the search string of the last incremental str= ing search. >> And it should fully describe the behavior when both options are left= at >> their defaults. Currently it does not say what happens by default i= f no >> suitable preceding word is found in the buffers accepted by the func= tion >> pointed out by dabbrev-friend-buffer-function. > > Not sure what you mean by the last sentence: did you mean the error > that is signaled? I mean the fact that, in that case, "dabbrev searches all the other buffers, except those named in =E2=80=98dabbrev-ignored-buffer-names=E2=80= =99, or matched by =E2=80=98dabbrev-ignored-regexps=E2=80=99." (according to dabbrev-check-all-buffers docstring). Thank you very much for improving Emacs! @Drew: you are welcome. Regards --=20 =E2=80=A2 I am Brazilian. I hope my English is correct and I welcome corre= ctions. =E2=80=A2 Please adopt free formats like PDF, ODF, Org, LaTeX, Opus, WebM a= nd 7z. =E2=80=A2 Free (as in free speech) software for Android: https://f-droid.or= g/ From unknown Mon Jun 23 02:25:24 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Jorge Morais Neto Subject: bug#24890: closed (Re: bug#24890: 25.1; Several documentation problems) Message-ID: References: <838tsrfgig.fsf@gnu.org> X-Gnu-PR-Message: they-closed 24890 X-Gnu-PR-Package: emacs Reply-To: 24890@debbugs.gnu.org Date: Thu, 10 Nov 2016 16:27:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1478795222-1573-1" This is a multi-part message in MIME format... ------------=_1478795222-1573-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #24890: 25.1; Several documentation problems which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 24890@debbugs.gnu.org. --=20 24890: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D24890 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1478795222-1573-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 24890-done) by debbugs.gnu.org; 10 Nov 2016 16:26:24 +0000 Received: from localhost ([127.0.0.1]:52461 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c4sBE-0000OU-Fz for submit@debbugs.gnu.org; Thu, 10 Nov 2016 11:26:24 -0500 Received: from eggs.gnu.org ([208.118.235.92]:49838) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c4sBD-0000OI-6R for 24890-done@debbugs.gnu.org; Thu, 10 Nov 2016 11:26:23 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c4sB4-00017m-UF for 24890-done@debbugs.gnu.org; Thu, 10 Nov 2016 11:26:18 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_50,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:45129) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c4sB4-00017h-Qv; Thu, 10 Nov 2016 11:26:14 -0500 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4760 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1c4sB3-0008Vd-GU; Thu, 10 Nov 2016 11:26:14 -0500 Date: Thu, 10 Nov 2016 18:26:15 +0200 Message-Id: <838tsrfgig.fsf@gnu.org> From: Eli Zaretskii To: Jorge Morais Neto In-reply-to: (message from Jorge Morais Neto on Thu, 10 Nov 2016 12:36:58 -0200) Subject: Re: bug#24890: 25.1; Several documentation problems References: <834m3ji36h.fsf@gnu.org> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -7.9 (-------) X-Debbugs-Envelope-To: 24890-done Cc: 24890-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -7.9 (-------) > From: Jorge Morais Neto > Date: Thu, 10 Nov 2016 12:36:58 -0200 > Cc: 24890@debbugs.gnu.org > > >> 1) outline-hide-sublevels and outline-hide-other\\ > >> The docstrings and the manual should say that each of these commands reveals > >> everything it does not actively hide. > > > > AFAIU, "everything" here boils down to the top body without a heading, > > if any. Because the fact that all the levels N and above are revealed > > is mentioned in the doc string already, right? > In git (branch emacs-25), the docstring of outline-hide-sublevels is only: > "Hide everything but the top LEVELS levels of headers, in whole buffer. > This also unhides the top heading-less body, if any. > > Interactively, the prefix argument supplies the value of LEVELS. > When invoked without a prefix argument, LEVELS defaults to the level > of the current heading, or to 1 if the current line is not a heading." > > In my understanding, this still does not fully document the behavior > of actively revealing all headers up to level LEVELS. Maybe I'm missing something, but what does "Hide everything but the top LEVELS levels of headers" mean, if not that all the headers of those levels are revealed? > The docstring of outline-hide-other is also incomplete in this sense > because it does not fully document that it actively reveals the body > of the current entry (it then becomes visible even if it was > previously hidden). Once again, I'm at a loss. The doc string says Hide everything except current body and parent and top-level headings. IOW, it hides everything, leaving the current body revealed. How else can this phrase be interpreted? > >> 14) [[info:emacs#Other Repeating Search]]: In my test, "M-s o" does not "Run ‘occur’ > >> using the search string of the last incremental string search." Instead it > >> calls "occur" and asks for the pattern. The pattern can then be yanked with > >> "M-n". > > > > I cannot reproduce this. The feature works for me as documented. Did > > you invoke "M-s o" during the incremental search, i.e. after typing > > "C-s SOME-TEXT"? > The manual says: > Run ‘occur’ using the search string of the last incremental string > search. You can also run ‘M-s o’ when an incremental search is > active; this uses the current search string. > > If I understand English correctly (I am Brazilian) the first sentence > cited above says that if you run an incremental search, exit it (e.g. > by pressing RET), and later type M-s o, it will automatically run > ‘occur’ using the search string of the last incremental string search. To have occur use the last search string, you need to type "M-n" at the prompt. I've now clarified this in the manual. > >> And it should fully describe the behavior when both options are left at > >> their defaults. Currently it does not say what happens by default if no > >> suitable preceding word is found in the buffers accepted by the function > >> pointed out by dabbrev-friend-buffer-function. > > > > Not sure what you mean by the last sentence: did you mean the error > > that is signaled? > I mean the fact that, in that case, "dabbrev searches all the other > buffers, except those named in ‘dabbrev-ignored-buffer-names’, or > matched by ‘dabbrev-ignored-regexps’." (according to > dabbrev-check-all-buffers docstring). That is already in the doc string. Thanks. ------------=_1478795222-1573-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 6 Nov 2016 21:15:14 +0000 Received: from localhost ([127.0.0.1]:47177 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c3UmX-0006ZV-C9 for submit@debbugs.gnu.org; Sun, 06 Nov 2016 16:15:14 -0500 Received: from eggs.gnu.org ([208.118.235.92]:36336) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c3UmU-0006ZI-Su for submit@debbugs.gnu.org; Sun, 06 Nov 2016 16:15:11 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c3UmM-0003xG-DH for submit@debbugs.gnu.org; Sun, 06 Nov 2016 16:15:05 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,FREEMAIL_FROM, T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:53978) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1c3UmM-0003x6-9w for submit@debbugs.gnu.org; Sun, 06 Nov 2016 16:15:02 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:55533) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c3UmI-0007rz-E4 for bug-gnu-emacs@gnu.org; Sun, 06 Nov 2016 16:15:02 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c3UmE-0003rv-Vj for bug-gnu-emacs@gnu.org; Sun, 06 Nov 2016 16:14:58 -0500 Received: from mail-qt0-x22e.google.com ([2607:f8b0:400d:c0d::22e]:33579) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1c3UmE-0003qR-Mt for bug-gnu-emacs@gnu.org; Sun, 06 Nov 2016 16:14:54 -0500 Received: by mail-qt0-x22e.google.com with SMTP id p16so76948791qta.0 for ; Sun, 06 Nov 2016 13:14:54 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:from:date:message-id:subject:to :content-transfer-encoding; bh=phfJkd4GpE9p8ypCG1em4sVpdnuRiAzi3AAJQNJ9Bdc=; b=XkdLLEELDNqe/3RRnNvkONEp71Zg6jUSkdUGKinHzUr0xV6l/GdP7fBTcjtQk8C4uC 8COg7vdKFysaNBEU3cccdd0VmeHH8tppbOIflFJ5mH99RbsJA5bzRRPzQwM8DcI7m6ik G6JQLpBfzRwlEpbKpdAVMwN1lsdtdB21kDNr6/PGGe7F6BXMhMpCJTCH8xPPgt1h7OXO rT4ZKQHxHUXkN5ISXEQu17+tmd+jzgxOPAO0rNXrmc+3Dm1gCe5hQ8bsvH6h57Ifatrx Lc57i/9OF5ovgM3M7fbKvrpau/3Kw1DP9y2XU+GRENKnXjdJ5I6PpmxUIC1u/ldN0UxH kMiQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:sender:from:date:message-id:subject :to:content-transfer-encoding; bh=phfJkd4GpE9p8ypCG1em4sVpdnuRiAzi3AAJQNJ9Bdc=; b=H4p6WjdCyySBunnWZjQlwYwb/s+Jbbu9fs6cmJOUHa+n6GeRPPxakuHFT1bnZu5g/Y 3IWzt9affHm9CxhRT7RVCC4xlEx9jKA9F4LSDfEsf4+hJSqgOgsXiAXyDoexndQKs8Nx Wrangf6AhAsqF0/LSPbTVmIgtL6d25BUIbnMmBHRruHuqNRB1YxX0inAWkOOXI/tvqci se8z6fmLM9QWqgyhM9Ub+5t+BZuVOGX7EfNSBEyZPPB87Ajo7QiBYSK4qHRWdtooxRdM WhDWutC3vyQT/JowDYjbS0dqnPCWDOLXdeDegQZIdflx6fwJMJvMxL08do4muJf7IjPh lCnQ== X-Gm-Message-State: ABUngve6lDLddh6epRbpa+ki7dMENTkQiQjj/euevFzj/V7Hch8IqTsGC6y8oY7RFD14pMI7F6gvhZWmgJys+A== X-Received: by 10.200.47.38 with SMTP id j35mr3625771qta.136.1478466893524; Sun, 06 Nov 2016 13:14:53 -0800 (PST) MIME-Version: 1.0 Received: by 10.55.180.129 with HTTP; Sun, 6 Nov 2016 13:14:52 -0800 (PST) From: Jorge Morais Neto Date: Sun, 6 Nov 2016 19:14:52 -0200 X-Google-Sender-Auth: aU7s_262---9SvhMt3iDMo9gqK4 Message-ID: Subject: 25.1; Several documentation problems To: bug-gnu-emacs@gnu.org Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable 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-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) I am sorry for having taken this long to report these problems as I said I would. 1) outline-hide-sublevels and outline-hide-other\\ The docstrings and the manual should say that each of these commands rev= eals everything it does not actively hide. For example, outline-hide-subleve= ls reveals the top N levels of headlines and the top headless body, and all= else is hidden. So if N is 2 and some level 1 tree was folded, its children = will be actively revealed. Also, please document that, for outline-hide-sublevels, N defaults to th= e level of the current headline. Finally, perhaps the manual should mention that hide-sublevels, hide-oth= er and some other commands are actually deprecated aliases. 2) [[info:emacs#Outline Visibility]] informs that hide-body does not hide the top headless body. This information should also be in the docstring. Also, maybe the manual should inform that "hide-body" is a deprecated alias fo= r "outline-hide-body". 3) Tutorial 1. In section "* AUTO SAVE", the tutorial mentions "recover-file" where "recover-this-file" would be better and perhaps recover-session would= be best. 2. Why does section "* MULTIPLE FRAMES" use "M-x make-frame" and "M-x delete-frame" instead of "C-x 5 2" and "C-x 5 0" respectively? 3. In section "* GETTING MORE HELP": 1) #+BEGIN_QUOTE Multi-character commands such as C-x C-s and (if you have no META = or EDIT or ALT key) v are also allowed after C-h c. #+END_QUOTE The way that is written, some user might think that "C-h c v"= only works if the terminal lacks a META or EDIT or Alt key. I suggest replacing the parenthesized text by "(alternative to M-v)", positi= oned just after "v". 2) #+BEGIN_QUOTE C-h a Command Apropos. Type in a keyword and Emacs will list all the commands whose names contain that keyword. These commands can all= be invoked with META-x. For some commands, Command Apropos will also= list a one or two character sequence which runs the same command. #+END_QUOTE In the last sentence please replace "one or two" =E2=86=92 "short"= , as some commands (like find-file-other-frame) have character sequences of = 3-4 chars. 3) #+BEGIN_QUOTE C-h i Read included Manuals (a.k.a. Info). This command puts you into a special buffer called `*info*' where you can read manuals for the packages installed on your system. Type m emacs to read = the Emacs manual. If you have never before used Info, type ? and Emac= s will take you on a guided tour of Info mode facilities. #+END_QUOTE The guided tour is provided by "h". "?" is also useful, but provi= des Info-summary, not the tutorial. Complete beginners need "h" first= , then "?" for a quick reminder each time they forget a keybinding. 4) [[info:emacs#Exiting]] says C-z is bound to suspend-emacs. It is actually bound to suspend-frame. Only several paragraphs below does the manual report = the correct information. Please correct the first mention of "C-z". 5) [[info:emacs#Mode Line]] omits the "@" of emacsclient frames. 6) [[info:emacs#Completion Styles]] on partial-completion Says that #+BEGIN_QUOTE Furthermore, a =E2=80=98*=E2=80=99 in the minibuffer text is treated as = a =E2=80=9Cwildcard=E2=80=9D=E2=80=94it matches any character at the corresponding position in the completion alternative. #+END_QUOTE Actually it matches any /string/ at the corresponding position. 7) "list-command-history" docstring is confusing. It says "List history of commands typed to minibuffer." This does not clearly explain that the command lists the history of commands that /used/ the minibuffer, includ= ing those that were invoked by keys. 8) [[info:emacs#Yes or No Prompts]] 1. Swaps "M-v" with "C-v". 2. In the last paragraph it says: #+BEGIN_QUOTE use the history commands =E2=80=98M-p=E2=80=99 and =E2=80=98M-f=E2=80= =99, etc. #+END_QUOTE It probably meant M-n instead of M-f. 9) [[info:emacs#Help Mode]] says: #+BEGIN_QUOTE While retracing your steps, you can go forward by using =E2=80=98C-c C-b= =E2=80=99 (=E2=80=98help-go-forward=E2=80=99). #+END_QUOTE "help-go-forward" is not "C-c C-b". Also, the section omits the handy single-letter aliases: "l" ("C-c C-b")= , "r" ("C-c C-f"). 10) [[info:emacs#Misc Help]]: In the paragraph for describe-mode, please me= ntion that it shows the key bindings, which is very useful. 11) "set-mark-command" docstring omits the behavior of activating the mark. Also it says: #+BEGIN_QUOTE Also push the old mark on global mark ring, if the previous mark was se= t in another buffer. #+END_QUOTE Actually, AFAICT it pushes to the global mark ring /the mark just set/. 12) "C-[" for "" and "C-i" for ""\\ The manual and probably also the tutorial should mention at the beginni= ng that C-[ is an alias for . It is very useful because C-[ is faste= r to type. Sometimes the difference is big, such as in "C-x ESC ESC" =E2=86= =92 "C-x C-[ C-[". In fact it is sometimes faster to type C-[ * than M-*. C-i as an alias for TAB is also very useful. For example, to bring an = Org buffer to startup visibility, "C-u C-u C-i" is faster to type than "C-u C-u ". 13) [[info:elisp#Coding Conventions]] #+BEGIN_QUOTE =E2=80=A2 If loading the file adds functions to hooks, define a functio= n =E2=80=98FEATURE-unload-hook=E2=80=99, where FEATURE is the name of the= feature the package provides, and make it undo any such changes. Using =E2=80=98unload-fea= ture=E2=80=99 to unload the file will run this function. #+END_QUOTE info:elisp#Unloading, however, mentions /FEATURE-unload-function/ inste= ad of /FEATURE-unload-hook/. 14) [[info:emacs#Other Repeating Search]]: In my test, "M-s o" does not "Run =E2=80=98occur=E2=80=99 using the search string of the last incremental string search." Instea= d it calls "occur" and asks for the pattern. The pattern can then be yanked= with "M-n". 15) [[info:emacs#Dynamic Abbrevs]] imprecision =E2=80=93 it says: #+BEGIN_QUOTE After scanning the current buffer, =E2=80=98M-/=E2=80=99 normally searc= hes other buffers, unless you have set =E2=80=98dabbrev-check-all-buffers=E2=80=99 to =E2= =80=98nil=E2=80=99. #+END_QUOTE Actually, according to the docstrings of "dabbrev-check-all-buffers" an= d "dabbrev-check-other-buffers", the "unless=E2=80=A6" part is imprecise.= I suggest rewriting to #+BEGIN_QUOTE After scanning the current buffer, =E2=80=98M-/=E2=80=99 normally searc= hes other buffers. This can be customized via the options "dabbrev-check-other-buffers" an= d "dabbrev-check-all-buffers". #+END_QUOTE Also, the docstring of "dabbrev-expand" should mention these two option= s. And it should fully describe the behavior when both options are left at their defaults. Currently it does not say what happens by default if n= o suitable preceding word is found in the buffers accepted by the functio= n pointed out by dabbrev-friend-buffer-function. In GNU Emacs 25.1.1 (x86_64-unknown-linux-gnu, GTK+ Version 3.18.9) of 2016-09-18 built on jorge-HP-G42 Windowing system distributor 'The X.Org Foundation', version 11.0.11804000 System Description: Ubuntu 16.04.1 LTS Configured using: 'configure --prefix=3D/usr/local/emacs/ --with-modules' 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 MODULES Important settings: value of $LC_CTYPE: pt_BR.UTF-8 value of $LC_MONETARY: pt_BR.UTF-8 value of $LC_NUMERIC: pt_BR.UTF-8 value of $LC_TIME: en_DK.UTF-8 value of $LANG: en_US.UTF-8 value of $XMODIFIERS: @im=3Dibus locale-coding-system: utf-8-unix Major mode: Org Minor modes in effect: diff-auto-refine-mode: t recentf-mode: t org-bullets-mode: t flyspell-mode: t column-enforce-mode: t helm-descbinds-mode: t helm-mode: t shell-dirtrack-mode: t async-bytecomp-package-mode: t window-numbering-mode: t global-edit-server-edit-mode: t show-paren-mode: t global-whitespace-mode: t tooltip-mode: t global-eldoc-mode: t electric-quote-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 size-indication-mode: t column-number-mode: t line-number-mode: t auto-fill-function: org-auto-fill-function transient-mark-mode: t Recent messages: Reverting buffer =E2=80=98agenda=E2=80=99. Saving file /home/jorge/org/agenda/gen=C3=A9rico.org... Wrote /home/jorge/org/agenda/gen=C3=A9rico.org Reverting buffer =E2=80=98agenda=E2=80=99. Saved text until "-buffers is non-nil (it defaults to t). " Save your position in the tutorial? (y or n) n Tutorial position not saved q is undefined Load-path shadows: /home/jorge/.emacs.d/elpa/org-bullets-20140918.1137/org-bullets hides /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-bullets ~/.emacs.d/lisp/dired-aux hides /usr/local/emacs/share/emacs/25.1/lisp/dire= d-aux /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-fortran hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-fortran /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-mhe hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-mhe /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-docview hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-docview /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-eshell hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-eshell /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-tangle hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-tangle /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-plot hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-plot /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-calc hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-calc /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-crypt hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-crypt /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-js hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-js /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-irc hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-irc /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-publish hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-publish /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-latex hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-latex /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-scala hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-scala /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-icalendar hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-icalendar /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-gnuplot hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-gnuplot /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-beamer hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-beamer /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-C hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-C /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-bibtex hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-bibtex /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-entities hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-entities /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-core hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-core /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-colview hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-colview /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org hides /usr/local/emacs/share/emacs/25.1/lisp/org/org /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-ocaml hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-ocaml /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-id hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-id /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-install hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-install /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-loaddefs hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-loaddefs /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-pcomplete hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-pcomplete /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-odt hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-odt /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-sass hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-sass /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-org hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-org /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-table hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-table /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-eval hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-eval /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-compat hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-compat /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-octave hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-octave /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-ascii hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-ascii /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-org hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-org /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-ledger hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-ledger /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-capture hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-capture /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-io hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-io /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-R hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-R /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-texinfo hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-texinfo /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-gnus hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-gnus /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-emacs-lisp hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-emacs-lisp /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-sql hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-sql /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-bbdb hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-bbdb /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-exp hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-exp /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-clojure hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-clojure /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-plantuml hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-plantuml /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-table hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-table /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-man hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-man /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-feed hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-feed /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-awk hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-awk /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-keys hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-keys /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-ruby hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-ruby /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-info hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-info /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-dot hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-dot /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-ditaa hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-ditaa /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-ref hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-ref /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-habit hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-habit /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-maxima hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-maxima /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-inlinetask hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-inlinetask /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-macs hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-macs /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-timer hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-timer /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-clock hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-clock /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-md hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-md /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-lisp hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-lisp /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-lob hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-lob /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-html hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-html /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-rmail hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-rmail /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-sqlite hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-sqlite /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-archive hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-archive /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-agenda hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-agenda /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-version hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-version /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-css hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-css /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-screen hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-screen /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-footnote hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-footnote /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-faces hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-faces /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-asymptote hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-asymptote /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-python hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-python /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-scheme hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-scheme /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-comint hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-comint /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-ctags hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-ctags /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-makefile hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-makefile /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-list hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-list /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-java hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-java /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-src hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-src /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-w3m hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-w3m /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-indent hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-indent /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-mscgen hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-mscgen /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-element hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-element /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-picolisp hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-picolisp /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-attach hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-attach /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-haskell hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-haskell /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-macro hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-macro /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ox-latex hides /usr/local/emacs/share/emacs/25.1/lisp/org/ox-latex /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-shen hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-shen /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-mobile hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-mobile /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-perl hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-perl /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-mouse hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-mouse /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-matlab hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-matlab /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-datetree hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-datetree /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/org-protocol hides /usr/local/emacs/share/emacs/25.1/lisp/org/org-protocol /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/ob-lilypond hides /usr/local/emacs/share/emacs/25.1/lisp/org/ob-lilypond Features: (shadow sort mail-extr emacsbug helm-ring two-column chistory term/xterm xterm tutorial sendmail gnus-msg gnus-art mm-uu mml2015 mm-view mml-smime smime dig gnus-sum gnus-group gnus-undo gnus-start gnus-cloud nnimap nnmail mail-source utf7 netrc nnoo gnus-spec gnus-int gnus-range gnus-win gnus gnus-ems nnheader org-timer org-colview org-attach vc-git reporter tabify eieio-opt speedbar sb-image ezimage dframe face-remap helm-font dabbrev org-capture timezone diff-mode diff wdired helm-dabbrev term ehelp org-lint ox-odt rng-loc rng-uri rng-parse rng-match rng-dt rng-util rng-pttrn nxml-parse nxml-ns nxml-enc xmltok nxml-util ox-latex ox-icalendar ox-html table ox-ascii ox-publish ox org-archive autorevert help-at-pt cal-move parse-time org-clock char-fold misearch multi-isearch iso-transl tramp-cache tramp-sh recentf tree-widget ido cal-iso solar cal-dst cal-julian appt org-eldoc org-bullets flyspell org-depend org-w3m org-rmail org-mhe org-irc org-info org-id org-gnus org-docview doc-view subr-x jka-compr image-mode org-bibtex bibtex org-bbdb org-element avl-tree J-org diary-lib diary-loaddefs orgtbl-show-header org-table org-protocol org-mobile org-agenda org-expiry filenotify org org-macro org-footnote org-pcomplete org-list org-faces org-entities noutline outline org-version ob-emacs-lisp ob ob-tangle org-src ob-ref ob-lob ob-table ob-keys ob-exp ob-comint ob-core ob-eval org-compat org-macs org-loaddefs find-func mm-archive message rfc822 mml mml-sec mailabbrev gmm-utils mailheader mm-decode mm-bodies mm-encode url-handlers mail-utils network-stream nsm starttls url-http tls gnutls mail-parse rfc2231 rfc2047 rfc2045 ietf-drums url-gw url-cache url-auth epg winner helm-command helm-elisp helm-eval edebug rainbow-delimiters column-enforce-mode cl ispell edit-server-htmlize html2text cus-edit wid-edit helm-descbinds helm-mode helm-files rx tramp tramp-compat tramp-loaddefs trampver ucs-normalize shell pcomplete ffap thingatpt helm-buffers helm-elscreen helm-tags helm-bookmark helm-adaptive helm-info bookmark pp helm-locate helm-grep helm-regexp helm-external helm-net browse-url xml url url-proxy url-privacy url-expand url-methods url-history url-cookie url-domsuf url-util url-parse auth-source gnus-util mm-util help-fns mail-prsvr password-cache url-vars mailcap helm-utils compile comint ansi-color ring helm-help helm-types helm derived helm-source eieio-compat eieio eieio-core helm-multi-match helm-lib cl-seq helm-config helm-easymenu edmacro kmacro cl-macs async-bytecomp async J-bc window-numbering edit-server solarized-light-theme solarized color dash easy-mmode advice dired+ image-dired format-spec image-file dired-aux dired-x dired finder-inf info package epg-config seq byte-opt gv bytecomp byte-compile cl-extra help-mode cconv cl-loaddefs pcase cl-lib disp-table paren whitespace cus-start cus-load holidays hol-loaddefs cal-menu easymenu calendar cal-loaddefs J-local server time-date 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 16 2655637 322584) (symbols 48 67629 10) (miscs 40 15820 16990) (strings 32 286913 56350) (string-bytes 1 9933897) (vectors 16 87909) (vector-slots 8 2268496 189885) (floats 8 1374 1152) (intervals 56 378977 14831) (buffers 976 124) (heap 1024 185650 16507)) --=20 =E2=80=A2 I am Brazilian. I hope my English is correct and I welcome corre= ctions. =E2=80=A2 Please adopt free formats like PDF, ODF, Org, LaTeX, Opus, WebM a= nd 7z. =E2=80=A2 Free (as in free speech) software for Android: https://f-droid.or= g/ ------------=_1478795222-1573-1-- From unknown Mon Jun 23 02:25:24 2025 X-Loop: help-debbugs@gnu.org Subject: bug#24890: 25.1; Several documentation problems Resent-From: Jorge Morais Neto Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 10 Nov 2016 18:11:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24890 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 24890-done@debbugs.gnu.org Received: via spool by 24890-done@debbugs.gnu.org id=D24890.147880142911437 (code D ref 24890); Thu, 10 Nov 2016 18:11:02 +0000 Received: (at 24890-done) by debbugs.gnu.org; 10 Nov 2016 18:10:29 +0000 Received: from localhost ([127.0.0.1]:52606 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c4tnx-0002yP-0H for submit@debbugs.gnu.org; Thu, 10 Nov 2016 13:10:29 -0500 Received: from mail-qk0-f169.google.com ([209.85.220.169]:32898) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c4tnu-0002yB-A3 for 24890-done@debbugs.gnu.org; Thu, 10 Nov 2016 13:10:27 -0500 Received: by mail-qk0-f169.google.com with SMTP id x190so304493488qkb.0 for <24890-done@debbugs.gnu.org>; Thu, 10 Nov 2016 10:10:26 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:from:date:message-id :subject:to:cc:content-transfer-encoding; bh=ceNzuko4QYGFT0LO1OYDsJ0hiOI0BnsFH1aPm+OMyKc=; b=qonD12gJ1cCKdfmMoM3NbfwPdUo5pgEiJpwmkMRPW7PKnBWoXdols2TSmfV3NFDIdH /cJ/0iD1uHx+Gd5umCsN+7MgzdFloLVSEaCeDfAxODrACw+c4aTg03EA6u4cDDUgKtTR 2jFtYXuCOA5exbyPYkmmgyeVr7vtrR75ge1DvUSrLpHGPY3JtohYLkfwtDXt8I4VCfVi aXJ6BQuCgAgKVbLeSMpltHzKiNBe2tjXzzASK+NI7Ls0ZM65C+prL01ajXDxO31P9ILo OarxU7zgD2v3BaUOKCnIA/gt/R22IWGabU/AdyPmB+by5SP+1ciSyzm/A7m/K35ASUZj rIWQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:sender:in-reply-to:references:from :date:message-id:subject:to:cc:content-transfer-encoding; bh=ceNzuko4QYGFT0LO1OYDsJ0hiOI0BnsFH1aPm+OMyKc=; b=K+dIY4+PzYY6/25Sa2jbzSTFUi73pGSV5bhsoUgSQp9+7OpjFIypCF+kXkPfQO09Jw CtM3qf1n3D1F33POkXmfPR7qxe5+EfDOg2VRB75hhI0G/oxa7ovC6ORTpdLx77SUhspH HgD7hUTCXnaAAkX8fWFWzcbNddQ3t0rmK6XGJeoEcQlpIWDJYI6w+AmYKnGOIucLP2sp TU4kikWQ7JBvHLuRHXbBiUQ0acv2l8T6KqmLrd2AQmGSXYbn66EF/VS1AUQmPeP3le5Z HaPkieSSvf4+XanHfIn37ImQTXY8t9m4Fi22IF7Qk/b6Oy/lA7842ACY43v8BMtnq2aM JYGg== X-Gm-Message-State: ABUngvceuxe5ctS0XMCpR56k04Nfkkl1chHn2fBZuvpEonYJCy5zOAUHk1ifkOnO6tkfklquDwWLYfnAM+3Ohw== X-Received: by 10.55.180.135 with SMTP id d129mr6607325qkf.96.1478801420819; Thu, 10 Nov 2016 10:10:20 -0800 (PST) MIME-Version: 1.0 Received: by 10.233.220.68 with HTTP; Thu, 10 Nov 2016 10:10:19 -0800 (PST) In-Reply-To: <838tsrfgig.fsf@gnu.org> References: <834m3ji36h.fsf@gnu.org> <838tsrfgig.fsf@gnu.org> From: Jorge Morais Neto Date: Thu, 10 Nov 2016 16:10:19 -0200 X-Google-Sender-Auth: tjDZ9g81cXmtbS_aJZj70H-ZgiE Message-ID: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.5 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.5 (/) On 10 November 2016 at 14:26, Eli Zaretskii wrote: >> From: Jorge Morais Neto >> Date: Thu, 10 Nov 2016 12:36:58 -0200 >> Cc: 24890@debbugs.gnu.org >> In git (branch emacs-25), the docstring of outline-hide-sublevels is onl= y: >> "Hide everything but the top LEVELS levels of headers, in whole buffer. >> This also unhides the top heading-less body, if any. >> [...] > > Maybe I'm missing something, but what does "Hide everything but the > top LEVELS levels of headers" mean, if not that all the headers of > those levels are revealed? I parse that excerpt as "Hide (everything but the top LEVELS levels of headers)", with parenthesis used for grouping as in Mathematics. But in an outline buffer, "everything but the top LEVELS levels of headers" means "headers of level > LEVELS and all bodies". Therefore I interpret the excerpt as "hide (headers of level > LEVELS and all bodies)", with no action for headers of level =E2=89=A4 LEVELS. Thus if a header of level =E2=89=A4 LEVELS started hidden, in principle it would stay hidden. Perhaps I am just misunderstanding English. My native and primary language is Portuguese. If you think the current wording is clear then we can leave it as is. > To have occur use the last search string, you need to type "M-n" at > the prompt. I've now clarified this in the manual. Thank you. --=20 =E2=80=A2 I am Brazilian. I hope my English is correct and I welcome corre= ctions. =E2=80=A2 Please adopt free formats like PDF, ODF, Org, LaTeX, Opus, WebM a= nd 7z. =E2=80=A2 Free (as in free speech) software for Android: https://f-droid.or= g/ From unknown Mon Jun 23 02:25:24 2025 X-Loop: help-debbugs@gnu.org Subject: bug#24890: 25.1; Several documentation problems Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 10 Nov 2016 18:54:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24890 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Jorge Morais Neto Cc: 24890@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 24890-submit@debbugs.gnu.org id=B24890.147880400615407 (code B ref 24890); Thu, 10 Nov 2016 18:54:02 +0000 Received: (at 24890) by debbugs.gnu.org; 10 Nov 2016 18:53:26 +0000 Received: from localhost ([127.0.0.1]:52643 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c4uTV-00040R-VH for submit@debbugs.gnu.org; Thu, 10 Nov 2016 13:53:26 -0500 Received: from eggs.gnu.org ([208.118.235.92]:42375) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c4uTU-00040E-8w for 24890@debbugs.gnu.org; Thu, 10 Nov 2016 13:53:24 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c4uTO-0000V5-DL for 24890@debbugs.gnu.org; Thu, 10 Nov 2016 13:53:19 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_50,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:47188) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c4uTO-0000Uz-AH; Thu, 10 Nov 2016 13:53:18 -0500 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4888 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1c4uTM-000292-R2; Thu, 10 Nov 2016 13:53:17 -0500 Date: Thu, 10 Nov 2016 20:53:15 +0200 Message-Id: <83r36jdv50.fsf@gnu.org> From: Eli Zaretskii In-reply-to: (message from Jorge Morais Neto on Thu, 10 Nov 2016 16:10:19 -0200) References: <834m3ji36h.fsf@gnu.org> <838tsrfgig.fsf@gnu.org> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -7.9 (-------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -7.9 (-------) > From: Jorge Morais Neto > Date: Thu, 10 Nov 2016 16:10:19 -0200 > Cc: 24890-done@debbugs.gnu.org > > On 10 November 2016 at 14:26, Eli Zaretskii wrote: > >> From: Jorge Morais Neto > >> Date: Thu, 10 Nov 2016 12:36:58 -0200 > >> Cc: 24890@debbugs.gnu.org > >> In git (branch emacs-25), the docstring of outline-hide-sublevels is only: > >> "Hide everything but the top LEVELS levels of headers, in whole buffer. > >> This also unhides the top heading-less body, if any. > >> [...] > > > > Maybe I'm missing something, but what does "Hide everything but the > > top LEVELS levels of headers" mean, if not that all the headers of > > those levels are revealed? > > I parse that excerpt as "Hide (everything but the top LEVELS levels of > headers)", with parenthesis used for grouping as in Mathematics. But > in an outline buffer, "everything but the top LEVELS levels of > headers" means "headers of level > LEVELS and all bodies". Therefore > I interpret the excerpt as "hide (headers of level > LEVELS and all > bodies)", with no action for headers of level ≤ LEVELS. Thus if a > header of level ≤ LEVELS started hidden, in principle it would stay > hidden. Perhaps I am just misunderstanding English. My native and > primary language is Portuguese. If you think the current wording is > clear then we can leave it as is. Yes, I think it's clear. From unknown Mon Jun 23 02:25:24 2025 X-Loop: help-debbugs@gnu.org Subject: bug#24890: 25.1; Several documentation problems Resent-From: Jorge Morais Neto Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 12 Nov 2016 19:03:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24890 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 24890@debbugs.gnu.org Received: via spool by 24890-submit@debbugs.gnu.org id=B24890.147897736810768 (code B ref 24890); Sat, 12 Nov 2016 19:03:01 +0000 Received: (at 24890) by debbugs.gnu.org; 12 Nov 2016 19:02:48 +0000 Received: from localhost ([127.0.0.1]:55143 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c5dZf-0002nc-Uj for submit@debbugs.gnu.org; Sat, 12 Nov 2016 14:02:48 -0500 Received: from mail-qk0-f173.google.com ([209.85.220.173]:34532) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c5dZe-0002nN-Kf for 24890@debbugs.gnu.org; Sat, 12 Nov 2016 14:02:47 -0500 Received: by mail-qk0-f173.google.com with SMTP id q130so55750519qke.1 for <24890@debbugs.gnu.org>; Sat, 12 Nov 2016 11:02:46 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:from:date:message-id :subject:to:cc:content-transfer-encoding; bh=11hLIjpdiOtRCjG/+VwZq9var1/Y6DNiEDFBq9FiVnI=; b=CRxD5kYiCvilHY0bMwtekV1iTu6De9VvWpGCQMrrwsqJXsomSCbdXCOe0Esq/+wIHR oMR3v5tIKSvdljOF+Nb+1tpTXg+5hvKslNsEIIhMLf4vpHJbnon/HSB5sl74UoyNUgvi jQRT9h6t+N5lB4xbFyWV1XFOG0/aj35XdoMhLeuD28pLaxG5r+mTz4rUaapfMO63Hnuw 4wPqe42W1ZWsE8B8jKVhpEs7naSTHGPYT+nXo2Xq7/8QGYXuOaygqUvK1G9kbQBNaC16 yTkHRH+iiEyNT4oWMKoY+2U3j/plJv3NJAyRwEk400a1qcNgBUD7Jl+zLI1OvA10fh2s 9waw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:sender:in-reply-to:references:from :date:message-id:subject:to:cc:content-transfer-encoding; bh=11hLIjpdiOtRCjG/+VwZq9var1/Y6DNiEDFBq9FiVnI=; b=Zl/axezCpxbHm/r2lD5m/4SXWVKjxZV0wUFf3kJZdKzSm0ydIo5zxODQATUIaMqw3d zuyJOHWLUxKweUz67iH26OFfZROOaCN0RyztSLoGJoN7v8lGJ2Fqw0MESegyRhyxg0vK YIqPkd/LueeAA3lv3OsGlV716IN8vsl0BlvcWPywKwKAewuRV8QQ0cxInh/jvtoit0xw 0tEnnvYtbI3O6S5VoTJiJ3dc4nLjdzbLnfu5B3sPa404KjMkBeiDeFIi+3qVaGnasqp+ htV1RpKxf3cWbEpq4NgPPQ1Pd4/AwGYjO0iTDgofGIRUc8j4xBbZZOIRGUy1I/2BEy4L Xquw== X-Gm-Message-State: ABUngvfaHYTxE2DAvzbsbAt5g2MuqkqHCpNcylSON254fI63zRFmd/D01LZnZc1nBqkPRhXsOAbn3OVzXRmRcQ== X-Received: by 10.55.203.22 with SMTP id d22mr10473594qkj.240.1478977361172; Sat, 12 Nov 2016 11:02:41 -0800 (PST) MIME-Version: 1.0 Received: by 10.55.185.70 with HTTP; Sat, 12 Nov 2016 11:02:40 -0800 (PST) In-Reply-To: <834m3ji36h.fsf@gnu.org> References: <834m3ji36h.fsf@gnu.org> From: Jorge Morais Neto Date: Sat, 12 Nov 2016 17:02:40 -0200 X-Google-Sender-Auth: v7qB-kvg0ThGPPGSUgsDUBv5xuc Message-ID: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.2 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.2 (/) On 7 November 2016 at 15:56, Eli Zaretskii wrote: >> From: Jorge Morais Neto >> Finally, perhaps the manual should mention that hide-sublevels, hide-= other >> and some other commands are actually deprecated aliases. > > I simply replaced the obsolete names with the current ones. Thank you. Could you also update [[info:emacs#Foldout]]? It still mention= s obsolete aliases. --=20 =E2=80=A2 I am Brazilian. I hope my English is correct and I welcome corre= ctions. =E2=80=A2 Please adopt free formats like PDF, ODF, Org, LaTeX, Opus, WebM a= nd 7z. =E2=80=A2 Free (as in free speech) software for Android: https://f-droid.or= g/ From unknown Mon Jun 23 02:25:24 2025 X-Loop: help-debbugs@gnu.org Subject: bug#24890: 25.1; Several documentation problems Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 12 Nov 2016 19:42:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24890 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Jorge Morais Neto Cc: 24890@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 24890-submit@debbugs.gnu.org id=B24890.147897969614563 (code B ref 24890); Sat, 12 Nov 2016 19:42:01 +0000 Received: (at 24890) by debbugs.gnu.org; 12 Nov 2016 19:41:36 +0000 Received: from localhost ([127.0.0.1]:55163 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c5eBD-0003mp-SK for submit@debbugs.gnu.org; Sat, 12 Nov 2016 14:41:36 -0500 Received: from eggs.gnu.org ([208.118.235.92]:58498) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c5eBC-0003md-Ox for 24890@debbugs.gnu.org; Sat, 12 Nov 2016 14:41:35 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c5eB4-0006Df-Bz for 24890@debbugs.gnu.org; Sat, 12 Nov 2016 14:41:29 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-2.9 required=5.0 tests=BAYES_40,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:39453) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c5eB4-0006DZ-96; Sat, 12 Nov 2016 14:41:26 -0500 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4448 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1c5eB3-0007ox-1M; Sat, 12 Nov 2016 14:41:26 -0500 Date: Sat, 12 Nov 2016 21:41:27 +0200 Message-Id: <83inrscwpk.fsf@gnu.org> From: Eli Zaretskii In-reply-to: (message from Jorge Morais Neto on Sat, 12 Nov 2016 17:02:40 -0200) References: <834m3ji36h.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -7.9 (-------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -7.9 (-------) > From: Jorge Morais Neto > Date: Sat, 12 Nov 2016 17:02:40 -0200 > Cc: 24890@debbugs.gnu.org > > On 7 November 2016 at 15:56, Eli Zaretskii wrote: > >> From: Jorge Morais Neto > >> Finally, perhaps the manual should mention that hide-sublevels, hide-other > >> and some other commands are actually deprecated aliases. > > > > I simply replaced the obsolete names with the current ones. > Thank you. Could you also update [[info:emacs#Foldout]]? It still mentions > obsolete aliases. Done.