From debbugs-submit-bounces@debbugs.gnu.org Sun Aug 08 13:15:19 2010 Received: (at submit) by debbugs.gnu.org; 8 Aug 2010 17:15:19 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Oi9Sw-0002oh-Ms for submit@debbugs.gnu.org; Sun, 08 Aug 2010 13:15:19 -0400 Received: from mx10.gnu.org ([199.232.76.166]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Oi9Sv-0002oI-2G for submit@debbugs.gnu.org; Sun, 08 Aug 2010 13:15:17 -0400 Received: from lists.gnu.org ([199.232.76.165]:55615) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Oi9Tc-0000h4-4p for submit@debbugs.gnu.org; Sun, 08 Aug 2010 13:16:00 -0400 Received: from [140.186.70.92] (port=51246 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Oi9TT-0002FJ-2D for bug-gnu-emacs@gnu.org; Sun, 08 Aug 2010 13:15:55 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-4.2 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_MED, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1Oho1q-0002wn-Up for bug-gnu-emacs@gnu.org; Sat, 07 Aug 2010 14:21:55 -0400 Received: from rcsinet10.oracle.com ([148.87.113.121]:32685) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Oho1q-0002wV-Pt for bug-gnu-emacs@gnu.org; Sat, 07 Aug 2010 14:21:54 -0400 Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id o77ILpA7005162 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 7 Aug 2010 18:21:53 GMT Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155]) by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id o77Ejho3001180 for ; Sat, 7 Aug 2010 18:21:51 GMT Received: from abhmt005.oracle.com by acsmt354.oracle.com with ESMTP id 495200941281205297; Sat, 07 Aug 2010 11:21:37 -0700 Received: from dradamslap1 (/10.159.221.167) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 07 Aug 2010 11:21:37 -0700 From: "Drew Adams" To: Subject: 24.0.50; Wdired doc. Doc string of wdired-change-to-wdired-mode. Date: Sat, 7 Aug 2010 11:21:39 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: Acs2XWDovtV0/DS5QRCy/0OgoDRmjA== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5931 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-Spam-Score: -6.3 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.3 (------) emacs -Q C-h f wdired RET That shows the doc string of `wdired-change-to-wdired-mode', which ends with this: "See `wdired-mode'." The latter function (or var) is not a link, but it should be. Otherwise, how are you supposed to "see" it? C-h r i wdired Takes you to node Wdired. This node is woefully incomplete. It tells you very little about Wdired. There is no Wdired manual, so this node is all users have for doc. Well, that and `C-h m', once they are in `wdired-mode'. But that too is nearly useless - far from complete. This is all it says: File Names Editing mode. Press C-c C-c to make the changes to take effect and exit. To abort the edit, use C-c ESC. In this mode you can edit the names of the files, the target of the links and the permission bits of the files. You can `customize-group' wdired. Editing things out of the filenames, or adding or deleting lines is not allowed, because the rest of the buffer is read-only. That's it. Much of what it says is just how to turn it off! The main commands and keys for the mode should be described, at least summarily. At least tell users how to use the mode and what operations they can perform (e.g. how to toggle permissions). And the link for `customize-group', which you might think would take you to the Wdired Customize group, just gives you `C-h f customize-group' - useless. There is even a function, `wdired-customize', defined to customize all of the Wdired options. That is far better to use for a link than is `customize-group'. And what does this mean: "Editing things out of the filenames"? The Wdired doc really needs to be improved to make Wdired more useful and available. Also, why use `Edit filenames' in the mode line? We should use a proper mode name as the lighter, and use a single (possibly compound) word with proper capitalization. (This is UI, not doc per se, but is related.) In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600) of 2010-08-02 on 3249CTO Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4) --no-opt --cflags -Ic:/xpm/include' From debbugs-submit-bounces@debbugs.gnu.org Sun Aug 05 00:04:30 2012 Received: (at 6824) by debbugs.gnu.org; 5 Aug 2012 04:04:30 +0000 Received: from localhost ([127.0.0.1]:34330 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Sxs4s-0006ci-NI for submit@debbugs.gnu.org; Sun, 05 Aug 2012 00:04:30 -0400 Received: from mail-pb0-f44.google.com ([209.85.160.44]:42781) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Sxs4q-0006ca-Ne for 6824@debbugs.gnu.org; Sun, 05 Aug 2012 00:04:29 -0400 Received: by pbbrr4 with SMTP id rr4so1941831pbb.3 for <6824@debbugs.gnu.org>; Sat, 04 Aug 2012 20:56:43 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-type; bh=NGoCyuwhu6erq53YJQupxLa3u35A58Dy3o21XSlkhoc=; b=nR5RdGPZTo8ZaoXkdPksYoQfZG/n4pERYyi8o5thJosMI0aqx8v/au2I2Z6T2R/f/S GopX90uuzY4IfMxFwuO/3aUo3OPDP1ROrdB6OLnzsgnSjErK8iRQ18J4pVnXe9UKW3tk hmuj5wRYKukO8Yp++eqgZzy7162P1YA7SQFgU/a3h9OtldK7a950EzwWYyePh0fOd/ca Ean89o94KpiWXqSFAV40BuPlMgcg1vXBokEzSYvAxMF4RINFKXCK918YiMs45V9Ue8lK eBMLWtWy/S8QvGFW/ZtSy9b5blRU+p4wawN42s0cQQ1M4IqK0i3HiuMwxRx+wLdpxaB9 CuIQ== Received: by 10.68.213.234 with SMTP id nv10mr8880625pbc.56.1344139003205; Sat, 04 Aug 2012 20:56:43 -0700 (PDT) Received: from ulysses (cm162.gamma80.maxonline.com.sg. [202.156.80.162]) by mx.google.com with ESMTPS id qa5sm6118608pbb.19.2012.08.04.20.56.40 (version=SSLv3 cipher=OTHER); Sat, 04 Aug 2012 20:56:42 -0700 (PDT) From: Chong Yidong To: "Drew Adams" Subject: Re: bug#6824: 24.0.50; Wdired doc. Doc string of wdired-change-to-wdired-mode. References: Date: Sun, 05 Aug 2012 11:56:36 +0800 In-Reply-To: (Drew Adams's message of "Sat, 7 Aug 2010 11:21:39 -0700") Message-ID: <87a9yat2iz.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.1.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: 6824 Cc: 6824@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) "Drew Adams" writes: > emacs -Q > > C-h f wdired RET > > That shows the doc string of `wdired-change-to-wdired-mode', which ends > with this: "See `wdired-mode'." The latter function (or var) is not a > link, but it should be. Otherwise, how are you supposed to "see" it? This is fixed in the trunk. From debbugs-submit-bounces@debbugs.gnu.org Sun Aug 05 00:04:45 2012 Received: (at control) by debbugs.gnu.org; 5 Aug 2012 04:04:45 +0000 Received: from localhost ([127.0.0.1]:34333 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Sxs56-0006d7-U5 for submit@debbugs.gnu.org; Sun, 05 Aug 2012 00:04:45 -0400 Received: from mail-pb0-f44.google.com ([209.85.160.44]:42781) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Sxs55-0006ca-CR for control@debbugs.gnu.org; Sun, 05 Aug 2012 00:04:43 -0400 Received: by mail-pb0-f44.google.com with SMTP id rr4so1941831pbb.3 for ; Sat, 04 Aug 2012 20:56:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:subject:date:message-id:mime-version:content-type; bh=EFVFYwB2WoizI/9JIDZjVDqbIbtEMEMTSb323D17Ts4=; b=AunYhSCPPpK43wvLQfsGfav00XnjuzdhedO3VydD5X5oVFH09+YfLeKs/QlSne4Fqp YIz2So0HvS5hVniCJ7sF/1daxd6sgbJGmrjSGtdcbqd+faEUzkx4hfxbwDeXzS7joyXU kjcrv2I4BldHuD0o+RozpQ87IvXMJTd95IaAmvPjqQXgGX7bYftLiT+zD3qdHQUfcASh hn3EXvwBHWRtcFxHt/WV7jBW8HYXX4l3OsByXG9dm4Im5j76rScNuaW6jDGjBjzgbivu rlf95emQvxIw2U3NWcAfdg9l3Ds2d85xMIk7aEAyA5bQwtpGmeGOukMN2XRM+MQUhz4X RhUg== Received: by 10.68.138.169 with SMTP id qr9mr8920499pbb.27.1344139018158; Sat, 04 Aug 2012 20:56:58 -0700 (PDT) Received: from ulysses (cm162.gamma80.maxonline.com.sg. [202.156.80.162]) by mx.google.com with ESMTPS id hf4sm6123273pbc.4.2012.08.04.20.56.56 (version=SSLv3 cipher=OTHER); Sat, 04 Aug 2012 20:56:57 -0700 (PDT) From: Chong Yidong To: control@debbugs.gnu.org Subject: close 6824 Date: Sun, 05 Aug 2012 11:56:53 +0800 Message-ID: <87mx2a9eka.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) close 6824 thanks From unknown Sat Jun 14 19:10:31 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 02 Sep 2012 11:24:03 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator