From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Documenting NEWS features for 25.1 Date: Wed, 16 Dec 2015 13:11:13 +0200 Message-ID: <83oadq1wdq.fsf@gnu.org> References: <20151212115202.16784.72345@vcs.savannah.gnu.org> <83poy82xe0.fsf@gnu.org> <834mfj36ij.fsf@gnu.org> <83vb7y1yqg.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1450264274 4553 80.91.229.3 (16 Dec 2015 11:11:14 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 16 Dec 2015 11:11:14 +0000 (UTC) Cc: emacs-devel@gnu.org To: Shakthi Kannan Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Dec 16 12:11:06 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 1a99z6-0003t6-Gj for ged-emacs-devel@m.gmane.org; Wed, 16 Dec 2015 12:11:04 +0100 Original-Received: from localhost ([::1]:46605 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a99z5-0007Kq-T3 for ged-emacs-devel@m.gmane.org; Wed, 16 Dec 2015 06:11:03 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45000) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a99z1-0007Kd-W5 for emacs-devel@gnu.org; Wed, 16 Dec 2015 06:11:00 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a99yy-0006xj-Pb for emacs-devel@gnu.org; Wed, 16 Dec 2015 06:10:59 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:34438) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a99yy-0006xf-MQ; Wed, 16 Dec 2015 06:10:56 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4286 helo=HOME-C4E4A596F7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1a99yy-0008SZ-27; Wed, 16 Dec 2015 06:10:56 -0500 In-reply-to: (message from Shakthi Kannan on Wed, 16 Dec 2015 16:06:34 +0530) 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.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:196361 Archived-At: > Date: Wed, 16 Dec 2015 16:06:34 +0530 > From: Shakthi Kannan > Cc: Emacs developers > > Eli, > > --- > | *** Strings after `:documentation' are highlighted as docstrings. > \-- > > Is there a sample function that demonstrates the above that I can test > and verify? > > (defun test nil > "echo Hello, World!" > (message "Hello, World")) > > Where does :documentation fit in the above example? I don't know, sorry. Some NEWS entries turn out to be small research projects. What I usually do is use "git annotate" on NEWS to find what commit added the entry, then look at the commit itself, and if necessary also at discussions or bug reports it points to (or any related discussions on the 2 mailing lists around the date of the commit). If none of this gets you the answer, I guess contacting the author of the commit is yet another way to find out. Thanks.