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#1434: Docstring for `toggle-read-only' shouldn't imply thebuffer is file-visiting Date: Wed, 26 Nov 2008 10:08:30 -0800 Message-ID: <000601c94ff1$fd2f54e0$c2b22382@us.oracle.com> References: Reply-To: Drew Adams , 1434@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1227724365 12710 80.91.229.12 (26 Nov 2008 18:32:45 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 26 Nov 2008 18:32:45 +0000 (UTC) To: "'Juanma Barranquero'" , <1434@emacsbugs.donarmstrong.com>, "'Bug-Gnu-Emacs'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Nov 26 19:33:47 2008 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.50) id 1L5PCq-0000a7-Be for geb-bug-gnu-emacs@m.gmane.org; Wed, 26 Nov 2008 19:33:45 +0100 Original-Received: from localhost ([127.0.0.1]:52265 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L5PBg-0006gT-Ob for geb-bug-gnu-emacs@m.gmane.org; Wed, 26 Nov 2008 13:32:32 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1L5P9Y-0003lO-Hp for bug-gnu-emacs@gnu.org; Wed, 26 Nov 2008 13:30:20 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1L5P9V-0003in-Tl for bug-gnu-emacs@gnu.org; Wed, 26 Nov 2008 13:30:19 -0500 Original-Received: from [199.232.76.173] (port=58317 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L5P9V-0003iL-Jh for bug-gnu-emacs@gnu.org; Wed, 26 Nov 2008 13:30:17 -0500 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:35950) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1L5P9U-0007eC-4N for bug-gnu-emacs@gnu.org; Wed, 26 Nov 2008 13:30:17 -0500 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id mAQIUBh3012726; Wed, 26 Nov 2008 10:30:11 -0800 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id mAQIF3JE008509; Wed, 26 Nov 2008 10:15:03 -0800 X-Loop: don@donarmstrong.com Resent-From: "Drew Adams" Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Wed, 26 Nov 2008 18:15:03 +0000 Resent-Message-ID: Resent-Sender: don@donarmstrong.com X-Emacs-PR-Message: report 1434 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.12277229347171 (code B ref -1); Wed, 26 Nov 2008 18:15:03 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 26 Nov 2008 18:08:54 +0000 Original-Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id mAQI8oVb007165 for ; Wed, 26 Nov 2008 10:08:51 -0800 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1L5Ooj-0002gS-Pn for bug-gnu-emacs@gnu.org; Wed, 26 Nov 2008 13:08:49 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1L5Ooh-0002fL-Rb for bug-gnu-emacs@gnu.org; Wed, 26 Nov 2008 13:08:49 -0500 Original-Received: from [199.232.76.173] (port=53066 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L5Ooh-0002fB-KW for bug-gnu-emacs@gnu.org; Wed, 26 Nov 2008 13:08:47 -0500 Original-Received: from rcsinet11.oracle.com ([148.87.113.123]:38621 helo=rgminet11.oracle.com) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1L5Ooh-0004Sj-5J for bug-gnu-emacs@gnu.org; Wed, 26 Nov 2008 13:08:47 -0500 Original-Received: from rgminet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by rgminet11.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id mAQI9KI8031050 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 26 Nov 2008 18:09:21 GMT Original-Received: from acsmt701.oracle.com (acsmt701.oracle.com [141.146.40.71]) by rgminet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id mAQI8bJB009606; Wed, 26 Nov 2008 18:08:38 GMT Original-Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 26 Nov 2008 10:08:30 -0800 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: AclP3s2/pNLfwmgQS3q4TtlVsyiRpgAEtzJw X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 X-Source-IP: acsmt701.oracle.com [141.146.40.71] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A09020A.492D90A0.0125:SCFSTAT928724,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) X-CrossAssassin-Score: 2 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Resent-Date: Wed, 26 Nov 2008 13:30:19 -0500 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list 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:22703 Archived-At: > Most references to readonly-ness in files.el do talk about > file-visiting buffers, which makes sense. However, `toggle-read-only' > is useful for non-visiting buffers too, though the docstring seems to > imply otherwise. > > Docstring for `toggle-read-only' says: > > Change whether this buffer is visiting its file read-only. > With prefix argument ARG, make the buffer read-only if ARG is > positive, otherwise make it writable. If visiting file read-only > and `view-read-only' is non-nil, enter view mode. FWIW, I agree. When writing mode doc strings that describe some key bindings using \\[...], for instance, I typically toggle read-only in *Help*, to adjust line lengths there before correcting the source code.