From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: Drew Adams <drew.adams@oracle.com>
Newsgroups: gmane.emacs.bugs
Subject: bug#21171: 25.0.50;
	Please document (and index) `with-silent-modifications' in Elisp
	manual
Date: Fri, 31 Jul 2015 13:58:38 -0700 (PDT)
Message-ID: <5a5ff08e-0a5f-4ef9-bdd1-5e4afd08b4d1@default>
References: <71a1f5f8-8295-419b-a5bc-33c36662c2d6@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 1438376366 23143 80.91.229.3 (31 Jul 2015 20:59:26 GMT)
X-Complaints-To: usenet@ger.gmane.org
NNTP-Posting-Date: Fri, 31 Jul 2015 20:59:26 +0000 (UTC)
To: 21171@debbugs.gnu.org
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Jul 31 22:59:13 2015
Return-path: <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>
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 <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	id 1ZLHOY-0008Ff-Ui
	for geb-bug-gnu-emacs@m.gmane.org; Fri, 31 Jul 2015 22:59:11 +0200
Original-Received: from localhost ([::1]:45994 helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	id 1ZLHOY-0004aq-91
	for geb-bug-gnu-emacs@m.gmane.org; Fri, 31 Jul 2015 16:59:10 -0400
Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57348)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1ZLHOV-0004ai-6s
	for bug-gnu-emacs@gnu.org; Fri, 31 Jul 2015 16:59:08 -0400
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1ZLHOR-0004ih-2K
	for bug-gnu-emacs@gnu.org; Fri, 31 Jul 2015 16:59:07 -0400
Original-Received: from debbugs.gnu.org ([140.186.70.43]:34650)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1ZLHOQ-0004iG-VS
	for bug-gnu-emacs@gnu.org; Fri, 31 Jul 2015 16:59:02 -0400
Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1ZLHOQ-0001lB-Cr
	for bug-gnu-emacs@gnu.org; Fri, 31 Jul 2015 16:59:02 -0400
X-Loop: help-debbugs@gnu.org
Resent-From: Drew Adams <drew.adams@oracle.com>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@gnu.org
Resent-Date: Fri, 31 Jul 2015 20:59:02 +0000
Resent-Message-ID: <handler.21171.B21171.14383763246742@debbugs.gnu.org>
Resent-Sender: help-debbugs@gnu.org
X-GNU-PR-Message: followup 21171
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
Original-Received: via spool by 21171-submit@debbugs.gnu.org id=B21171.14383763246742
	(code B ref 21171); Fri, 31 Jul 2015 20:59:02 +0000
Original-Received: (at 21171) by debbugs.gnu.org; 31 Jul 2015 20:58:44 +0000
Original-Received: from localhost ([127.0.0.1]:36096 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <debbugs-submit-bounces@debbugs.gnu.org>)
	id 1ZLHO8-0001kf-5o
	for submit@debbugs.gnu.org; Fri, 31 Jul 2015 16:58:44 -0400
Original-Received: from aserp1040.oracle.com ([141.146.126.69]:28494)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <drew.adams@oracle.com>) id 1ZLHO5-0001kX-Rv
	for 21171@debbugs.gnu.org; Fri, 31 Jul 2015 16:58:42 -0400
Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234])
	by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with
	ESMTP id t6VKwevf004031
	(version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK)
	for <21171@debbugs.gnu.org>; Fri, 31 Jul 2015 20:58:41 GMT
Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75])
	by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id t6VKwe2F006287
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL)
	for <21171@debbugs.gnu.org>; Fri, 31 Jul 2015 20:58:40 GMT
Original-Received: from abhmp0006.oracle.com (abhmp0006.oracle.com [141.146.116.12])
	by userv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t6VKwerB026522
	for <21171@debbugs.gnu.org>; Fri, 31 Jul 2015 20:58:40 GMT
In-Reply-To: <71a1f5f8-8295-419b-a5bc-33c36662c2d6@default>
X-Priority: 3
X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9  (901082) [OL
	12.0.6691.5000 (x86)]
X-Source-IP: aserv0022.oracle.com [141.146.126.234]
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" <bug-gnu-emacs.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/bug-gnu-emacs>
List-Post: <mailto:bug-gnu-emacs@gnu.org>
List-Help: <mailto:bug-gnu-emacs-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=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:105252
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/105252>

> Subject line says it all.

Nope.  And please state explicitly everything that it does -
just what it saves and restores, inhibits, etc.  Otherwise,
from the simple doc string alone it is not obvious what
code (bindings etc.) this can replace.  Yes, a user can
consult the source code, but there is no reason not to
describe what it does in more detail than just "pretending
it does not modify the buffer".