From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: MON KEY Newsgroups: gmane.emacs.bugs Subject: bug#6756: 23.2; `describe-function' describing functions that aren't Date: Fri, 30 Jul 2010 22:50:04 -0400 Message-ID: References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Trace: dough.gmane.org 1280545682 23681 80.91.229.12 (31 Jul 2010 03:08:02 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 31 Jul 2010 03:08:02 +0000 (UTC) To: 6756@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jul 31 05:07:59 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Of2QZ-0007EC-54 for geb-bug-gnu-emacs@m.gmane.org; Sat, 31 Jul 2010 05:07:59 +0200 Original-Received: from localhost ([127.0.0.1]:37965 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Of2QX-0002Jh-T5 for geb-bug-gnu-emacs@m.gmane.org; Fri, 30 Jul 2010 23:07:57 -0400 Original-Received: from [140.186.70.92] (port=55254 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Of2QS-0002JB-Az for bug-gnu-emacs@gnu.org; Fri, 30 Jul 2010 23:07:53 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1Of2QR-0002JJ-4A for bug-gnu-emacs@gnu.org; Fri, 30 Jul 2010 23:07:52 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:50584) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Of2QR-0002JE-2m for bug-gnu-emacs@gnu.org; Fri, 30 Jul 2010 23:07:51 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Of29D-0003UY-Dv; Fri, 30 Jul 2010 22:50:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: MON KEY Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 31 Jul 2010 02:50:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 6756 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 6756-submit@debbugs.gnu.org id=B6756.128054459013411 (code B ref 6756); Sat, 31 Jul 2010 02:50:03 +0000 Original-Received: (at 6756) by debbugs.gnu.org; 31 Jul 2010 02:49:50 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Of28z-0003UG-V5 for submit@debbugs.gnu.org; Fri, 30 Jul 2010 22:49:50 -0400 Original-Received: from mail-wy0-f172.google.com ([74.125.82.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Of28y-0003UB-8G for 6756@debbugs.gnu.org; Fri, 30 Jul 2010 22:49:48 -0400 Original-Received: by wyb40 with SMTP id 40so1689736wyb.3 for <6756@debbugs.gnu.org>; Fri, 30 Jul 2010 19:50:04 -0700 (PDT) Original-Received: by 10.216.231.97 with SMTP id k75mr2472936weq.4.1280544604749; Fri, 30 Jul 2010 19:50:04 -0700 (PDT) Original-Received: by 10.216.49.84 with HTTP; Fri, 30 Jul 2010 19:50:04 -0700 (PDT) In-Reply-To: X-Google-Sender-Auth: pAfneOn3y4DVV84cifDvH1mhIZo X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Fri, 30 Jul 2010 22:50:03 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:39090 Archived-At: On Thu, Jul 29, 2010 at 6:55 PM, Juanma Barranquero wrote: > On Thu, Jul 29, 2010 at 19:22, MON KEY wrote: > If you try remove partial-completion from completion-styles you'll get > the behavior you want. > Thanks for the heads up. I'm quite sure I would never have found this information without your explicit pointer. > So it seems to be working as expected: describe-function* completes to > an element of COLLECTION according to the partial-completion style. > It would be working as expected assuming I could ascertain _what_ to expect. The docstring of `completing-read' should make mention of affecting vars. When stuff like this changes or is spread across multiple vars, fncns, and primitives and ample xrefs in the docstrings are not provided I find it virtually impossible to glean help from *Help*. The vars `completion-styles' and `completion-styles-alist' impact the behavior of (at min.) the following completion routines: `completing-read' `completion-try-completion' `completion-all-completions' `try-completion' `all-completions' yet none of the docs for these fncns make mention by xref to the affecting variables... though it is doubtful that an interested user would find much of use were she to find them by accident. C-h v `completion-styles' tells me: ,---- | | completion-styles is a variable defined in `minibuffer.el'. | Its value is | (basic partial-completion emacs22) | | List of completion styles to use. | The available styles are listed in `completion-styles-alist'. | | { ... Boilerplate customize and version history here ... } | `---- C-h v `completion-styles-alist' yields this heap of un-parseable verbosity: ,---- | {... Big 5 elt list each with 4 elts (including multi-lined | unreadable quoted lisp strings) ... } | | Documentation: | List of available completion styles. | Each element has the form (NAME TRY-COMPLETION ALL-COMPLETIONS DOC): | | { ... Form enumeration here ... } | `---- FWIW I increasingly find it unreasonable that *Help* defaults to _just_ pointing the user to `customize'. Why would I bother dropping into the miasma that is Custom when the docstring in *Help* can't be bothered to give a reasonably coherent explanation of _what_ I should customize and _why_ i should do so? *Help* needs Help. It isn't all that helpful that *Help* seems to increasingly (implicitly) suggest dropping into *Info* or custom to get help. > Juanma -- /s_P\