From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Jorge Morais Neto Newsgroups: gmane.emacs.bugs Subject: bug#24890: 25.1; Several documentation problems Date: Thu, 10 Nov 2016 12:36:58 -0200 Message-ID: References: <834m3ji36h.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1478788719 26976 195.159.176.226 (10 Nov 2016 14:38:39 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 10 Nov 2016 14:38:39 +0000 (UTC) Cc: 24890@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Nov 10 15:38:34 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c4qUX-0003zD-8I for geb-bug-gnu-emacs@m.gmane.org; Thu, 10 Nov 2016 15:38:13 +0100 Original-Received: from localhost ([::1]:46866 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c4qUa-0006lj-BR for geb-bug-gnu-emacs@m.gmane.org; Thu, 10 Nov 2016 09:38:16 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45888) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c4qUQ-0006kK-Ub for bug-gnu-emacs@gnu.org; Thu, 10 Nov 2016 09:38:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c4qUM-0003p1-Mf for bug-gnu-emacs@gnu.org; Thu, 10 Nov 2016 09:38:06 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:36428) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1c4qUM-0003or-JS for bug-gnu-emacs@gnu.org; Thu, 10 Nov 2016 09:38:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1c4qUM-00060K-Ap for bug-gnu-emacs@gnu.org; Thu, 10 Nov 2016 09:38:02 -0500 X-Loop: help-debbugs@gnu.org 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: Original-Received: via spool by 24890-submit@debbugs.gnu.org id=B24890.147878862723009 (code B ref 24890); Thu, 10 Nov 2016 14:38:02 +0000 Original-Received: (at 24890) by debbugs.gnu.org; 10 Nov 2016 14:37:07 +0000 Original-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 Original-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 Original-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) Original-Received: by 10.233.220.68 with HTTP; Thu, 10 Nov 2016 06:36:58 -0800 (PST) In-Reply-To: <834m3ji36h.fsf@gnu.org> X-Google-Sender-Auth: zbHLIAg0vrg1nw6Z5UJGhkq8jag X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:125550 Archived-At: 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/