From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: docstrings and elisp reference Date: Sat, 10 Jun 2017 10:31:16 +0300 Message-ID: <83fuf870zf.fsf@gnu.org> References: <0BB64F35-233A-471F-B99F-51F96C4E6CCB@gmail.com> <8360g99n07.fsf@gnu.org> <86lgp4q2xa.fsf@stephe-leake.org> <7acc7d4f-23cc-4b6a-b062-ef92805e465b@default> <878tl3rz38.fsf@x230.lts> <877f0ln3dx.fsf@x230.lts> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: blaine.gmane.org 1497079949 31782 195.159.176.226 (10 Jun 2017 07:32:29 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 10 Jun 2017 07:32:29 +0000 (UTC) Cc: e.e.f.prudhomme@gmail.com, stephen_leake@stephe-leake.org, drew.adams@oracle.com, emacs-devel@gnu.org To: rms@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Jun 10 09:32:20 2017 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 1dJase-0007pJ-6B for ged-emacs-devel@m.gmane.org; Sat, 10 Jun 2017 09:32:20 +0200 Original-Received: from localhost ([::1]:57523 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dJasj-00011c-GY for ged-emacs-devel@m.gmane.org; Sat, 10 Jun 2017 03:32:25 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49699) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dJas4-00011U-Eb for emacs-devel@gnu.org; Sat, 10 Jun 2017 03:31:45 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dJas1-00042J-9S for emacs-devel@gnu.org; Sat, 10 Jun 2017 03:31:44 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:43363) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dJas1-00042F-6F; Sat, 10 Jun 2017 03:31:41 -0400 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4116 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1dJars-0004U5-G1; Sat, 10 Jun 2017 03:31:32 -0400 In-reply-to: (message from Richard Stallman on Fri, 09 Jun 2017 23:19:48 -0400) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e 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:215551 Archived-At: > From: Richard Stallman > Date: Fri, 09 Jun 2017 23:19:48 -0400 > Cc: stephen_leake@stephe-leake.org, drew.adams@oracle.com, emacs-devel@gnu.org > > > - the type of the function return value > > That is not crucial in Lisp the way it is in Java. > Unlike Java, Lisp does not declare or limit the type of any values. It could be important for Texinfo in general, though, because it is used to describe other languages and facilities where this does matter. Likewise for other attributes you mention as unimportant for Lisp. > > - since when it was introduced > > That does not seem important to me. But we already do have this information for customizable variables at least. > > - it’s a hook variable > > We could define a systematic way to indicate this in doc strings. I think the names of hook variables always match a few specific regular expressions, so this information is already there.