From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: New behavior Date: Sun, 16 Sep 2018 11:09:33 -0700 (PDT) Message-ID: References: << <83zhwljmzf.fsf@gnu.org> <8F4ACB78-C9A4-4F85-8E69-CF4A1FE3D597@scratch.space> <83o9d0jlwd.fsf@gnu.org> >> <<<837ejlifmy.fsf@gnu.org>>> <> <<83zhwhgyv5.fsf@gnu.org>> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1537121268 27281 195.159.176.226 (16 Sep 2018 18:07:48 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 16 Sep 2018 18:07:48 +0000 (UTC) Cc: van@scratch.space, emacs-devel@gnu.org To: Eli Zaretskii , Drew Adams Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Sep 16 20:07:43 2018 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1g1bSR-00070A-DJ for ged-emacs-devel@m.gmane.org; Sun, 16 Sep 2018 20:07:43 +0200 Original-Received: from localhost ([::1]:59827 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g1bUX-0005fk-Vb for ged-emacs-devel@m.gmane.org; Sun, 16 Sep 2018 14:09:54 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50431) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g1bUO-0005fc-LQ for emacs-devel@gnu.org; Sun, 16 Sep 2018 14:09:45 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1g1bUN-0007RG-Uf for emacs-devel@gnu.org; Sun, 16 Sep 2018 14:09:44 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:46330) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1g1bUK-0007Hn-5t; Sun, 16 Sep 2018 14:09:40 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w8GI8uBt030291; Sun, 16 Sep 2018 18:09:36 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=8QMvZffTfeiz0T4Rup5IPTCFVZo5ce7y/eYxykLViY8=; b=fVDWtXHUHbjElsEfw5jnEa8Z3DK1j/siaI0zAc5+9fNlqzTviohaN7kHozTBrbt6mmZs i/Q95ZXQFI+QRKQrNXHhXlZohHeBh7NS1Y2Q5Mzk+PZYIiIccgpfn68Sg1ZsZ/8gdz7e N087ysxa41bH+shdqo5Xpq7mQsvGe9FFHd+Q0i6+wH/2Z/TYnOJK2KprHEkHEEvwpAop WfbzTEMLclf25xQc1z9PZe93TAI2Q15iORGEgecBigMFmmEha8iOh9Aatm3n2ZcYswnD EFI5F6imlB5AXHh24S2jSZrNKA7pMe11RcB7nPufMT1S4u6f+YNxTMaNu3h1ns4HRGpy fA== Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by aserp2120.oracle.com with ESMTP id 2mgt1pb1w3-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 16 Sep 2018 18:09:36 +0000 Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id w8GI9YDJ005190 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 16 Sep 2018 18:09:35 GMT Original-Received: from abhmp0001.oracle.com (abhmp0001.oracle.com [141.146.116.7]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id w8GI9Y8Q021631; Sun, 16 Sep 2018 18:09:34 GMT In-Reply-To: <<83zhwhgyv5.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4735.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9017 signatures=668708 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=583 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1807170000 definitions=main-1809160195 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] X-Received-From: 141.146.126.78 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 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" Xref: news.gmane.org gmane.emacs.devel:229857 Archived-At: > > That users should not, and generally do not, need to know Lisp > > to customize a user option is not a reason that the doc for that > > option should not mention the Lisp values. It's true that there > > is no obligation for the doc to mention the Lisp values, but it > > generally helps users to do so - so it typically _should_. >=20 > There's also no catastrophe if users will read the source to find that > out. Especially those who want to know and use Lisp. No catastrophe, no. No catastrophe even if Emacs provided no doc strings anywhere.=20 The point is that doc helps users, including those who, like you and me, generally have no problem reading the source code. Being able to consult the source code is the best thing about Emacs. But being able to do that is not a reason not to help users by describing argument values and option values in doc strings.