From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: David Kastrup Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] master b533552 2/5: Documentation fixes re quotes Date: Wed, 02 Sep 2015 07:19:03 +0200 Message-ID: <87oahl1jqw.fsf@fencepost.gnu.org> References: <20150831061236.27796.57762@vcs.savannah.gnu.org> <55E3F3AD.2010602@yandex.ru> <55E3F6B6.20205@cs.ucla.edu> <55E3F88A.50003@yandex.ru> <55E3F9D7.6040601@cs.ucla.edu> <55E64B4B.3030006@cs.ucla.edu> <87vbbt1uh9.fsf@fencepost.gnu.org> <55E6514F.1020300@cs.ucla.edu> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1441171189 20296 80.91.229.3 (2 Sep 2015 05:19:49 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 2 Sep 2015 05:19:49 +0000 (UTC) Cc: rms@gnu.org, emacs-devel@gnu.org To: Paul Eggert Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Sep 02 07:19:49 2015 Return-path: Envelope-to: ged-emacs-devel@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 1ZX0Sa-0004ME-B8 for ged-emacs-devel@m.gmane.org; Wed, 02 Sep 2015 07:19:48 +0200 Original-Received: from localhost ([::1]:33639 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZX0SZ-0002DY-IL for ged-emacs-devel@m.gmane.org; Wed, 02 Sep 2015 01:19:47 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:35025) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZX0SW-0002D8-6K for emacs-devel@gnu.org; Wed, 02 Sep 2015 01:19:45 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZX0SV-0007Cw-Av for emacs-devel@gnu.org; Wed, 02 Sep 2015 01:19:44 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:57435) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZX0SS-0007C3-R1; Wed, 02 Sep 2015 01:19:40 -0400 Original-Received: from localhost ([127.0.0.1]:43021 helo=lola) by fencepost.gnu.org with esmtp (Exim 4.82) (envelope-from ) id 1ZX0SL-0006ul-Ed; Wed, 02 Sep 2015 01:19:33 -0400 Original-Received: by lola (Postfix, from userid 1000) id 0A3C6E327D; Wed, 2 Sep 2015 07:19:03 +0200 (CEST) In-Reply-To: <55E6514F.1020300@cs.ucla.edu> (Paul Eggert's message of "Tue, 1 Sep 2015 18:30:55 -0700") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:189445 Archived-At: Paul Eggert writes: > David Kastrup wrote: >> In fact, in many DOC strings writing 'xxx as an isolated expression you >> have instead substituted `xxx' instead. > > I did that only when the 'xxx appeared to be a not-properly-quoted > value, not an isolated source-code expression. Are you seriously suggesting that people wrote things like 'safe for a symbol value because they forgot a closing quote character? Let's see a few examples from the most recent quote-changing diff: ID-FORMAT specifies the preferred format of attributes uid and gid (see -below) - valid values are 'string and 'integer. The latter is the +below) - valid values are `string' and `integer'. The latter is the default, but we plan to change that, so you should specify a non-nil value doc: /* List of potentially supported image types. -Each element of the list is a symbol for an image type, like 'jpeg or 'png. +Each element of the list is a symbol for an image type, like `jpeg' or `png'. To check whether it is really supported, use `image-type-available-p'. */); DEFUN ("set-message-beep", Fset_message_beep, Sset_message_beep, 1, 1, 0, doc: /* Set the sound generated when the bell is rung. -SOUND is 'asterisk, 'exclamation, 'hand, 'question, 'ok, or 'silent -to use the corresponding system sound for the bell. The 'silent sound +SOUND is `asterisk', `exclamation', `hand', `question', `ok', or `silent' +to use the corresponding system sound for the bell. The `silent' sound prevents Emacs from making any sound at all. > In cases where it was an expression I escaped the apostrophe. > Admittedly there are some gray areas, and in areas where I > misinterpreted please feel free to change it back. How is one supposed to resolve anything in discussion when you constantly and habitually spin the facts and play word games and play dumb? -- David Kastrup