From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#18027: 24.4.50; doc of `rectangle-mark-mode' Date: Tue, 15 Jul 2014 13:52:52 -0700 (PDT) Message-ID: <5cf7f935-ce73-4afa-8aae-0eb4d1cc4a49@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1405457679 29935 80.91.229.3 (15 Jul 2014 20:54:39 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 15 Jul 2014 20:54:39 +0000 (UTC) To: 18027@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Jul 15 22:54:32 2014 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1X79k4-00062b-Pm for geb-bug-gnu-emacs@m.gmane.org; Tue, 15 Jul 2014 22:54:29 +0200 Original-Received: from localhost ([::1]:36614 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X79k4-000393-ET for geb-bug-gnu-emacs@m.gmane.org; Tue, 15 Jul 2014 16:54:28 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:35676) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X79jq-00038O-Ay for bug-gnu-emacs@gnu.org; Tue, 15 Jul 2014 16:54:24 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1X79jf-0001Ox-3o for bug-gnu-emacs@gnu.org; Tue, 15 Jul 2014 16:54:14 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:60601) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X79jf-0001Oj-1T for bug-gnu-emacs@gnu.org; Tue, 15 Jul 2014 16:54:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1X79je-0005eL-Kf for bug-gnu-emacs@gnu.org; Tue, 15 Jul 2014 16:54:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 15 Jul 2014 20:54:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 18027 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.140545761321669 (code B ref -1); Tue, 15 Jul 2014 20:54:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 15 Jul 2014 20:53:33 +0000 Original-Received: from localhost ([127.0.0.1]:55867 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1X79jB-0005dO-3D for submit@debbugs.gnu.org; Tue, 15 Jul 2014 16:53:33 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:33668) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1X79j8-0005dA-54 for submit@debbugs.gnu.org; Tue, 15 Jul 2014 16:53:31 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1X79ir-0001GM-9S for submit@debbugs.gnu.org; Tue, 15 Jul 2014 16:53:24 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:45039) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X79ir-0001GB-7M for submit@debbugs.gnu.org; Tue, 15 Jul 2014 16:53:13 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:35216) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X79ii-00035Y-Fl for bug-gnu-emacs@gnu.org; Tue, 15 Jul 2014 16:53:13 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1X79iZ-00018s-Ky for bug-gnu-emacs@gnu.org; Tue, 15 Jul 2014 16:53:04 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:33873) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1X79iZ-00018h-Dt for bug-gnu-emacs@gnu.org; Tue, 15 Jul 2014 16:52:55 -0400 Original-Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id s6FKqrpv019515 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Tue, 15 Jul 2014 20:52:54 GMT Original-Received: from aserz7021.oracle.com (aserz7021.oracle.com [141.146.126.230]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s6FKqqVo002707 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Tue, 15 Jul 2014 20:52:53 GMT Original-Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by aserz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s6FKqqLm020220 for ; Tue, 15 Jul 2014 20:52:52 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6691.5000 (x86)] X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:91574 Archived-At: (emacs) `Rectangles' says this: The command `C-x ' (`rectangle-mark-mode') makes a "rectangular region". It is a new feature introduced in GNU Emacs 24.4, and most commands now are still unaware of it, but kill and yank (*note Killing::) do work on the rectangle. 1. The manual should not be saying anything about something being new in such-and-such a release. It should always document the current release. It can, if helpful, say something explicit about an older release, but it has no business saying anything about "new" features. New features should be described in NEWS. 2. If some feature is limited, just say what the limitations are. Do not say anything about "currently" or "now". 3. This doc is not very helpful. It does not say what a "rectangular region" is or what it is for or what you can do with it or how. It says that this command makes one of these thingies, but it says nothing about what it makes it from - in particular, it says nothing about the relation of the region to "a rectangular region". And it says nothing about the appearance of the thing that it makes. In short, it tells you pretty much NOTHING about what this command is about. In GNU Emacs 24.4.50.1 (i686-pc-mingw32) of 2014-06-28 on ODIEONE Bzr revision: 117431 rgm@gnu.org-20140628015517-eku6hj8mpgcvfnso Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D/c/Devel/emacs/snapshot/trunk --enable-checking=3Dyes,glyphs 'CFLAGS=3D-O0 -g3' LDFLAGS=3D-Lc:/Devel/emacs/lib 'CPPFLAGS=3D-DGC_MCHECK=3D1 -Ic:/Devel/emacs/include''