From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stephen Leake Newsgroups: gmane.emacs.devel Subject: Re: How to find when a function/var has been added Date: Thu, 06 Aug 2015 04:59:51 -0500 Message-ID: <86egjgaga0.fsf@stephe-leake.org> References: <55C25834.3020305@cumego.com> <83si7xsfjx.fsf@gnu.org> <55C279B0.5040708@cumego.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1438855231 4852 80.91.229.3 (6 Aug 2015 10:00:31 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 6 Aug 2015 10:00:31 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Aug 06 12:00:21 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 1ZNHyD-0007m4-3B for ged-emacs-devel@m.gmane.org; Thu, 06 Aug 2015 12:00:17 +0200 Original-Received: from localhost ([::1]:44216 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZNHyC-0006xG-I4 for ged-emacs-devel@m.gmane.org; Thu, 06 Aug 2015 06:00:16 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57199) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZNHy3-0006nb-AS for emacs-devel@gnu.org; Thu, 06 Aug 2015 06:00:12 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZNHy0-0006W5-4z for emacs-devel@gnu.org; Thu, 06 Aug 2015 06:00:07 -0400 Original-Received: from gproxy2-pub.mail.unifiedlayer.com ([69.89.18.3]:38384) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1ZNHxz-0006Ui-Ur for emacs-devel@gnu.org; Thu, 06 Aug 2015 06:00:04 -0400 Original-Received: (qmail 305 invoked by uid 0); 6 Aug 2015 10:00:02 -0000 Original-Received: from unknown (HELO cmgw2) (10.0.90.83) by gproxy2.mail.unifiedlayer.com with SMTP; 6 Aug 2015 10:00:02 -0000 Original-Received: from host114.hostmonster.com ([74.220.207.114]) by cmgw2 with id 1Mzx1r0022UdiVW01N00DW; Thu, 06 Aug 2015 04:00:00 -0600 X-Authority-Analysis: v=2.1 cv=O9qq4nNW c=1 sm=1 tr=0 a=CQdxDb2CKd3SRg4I0/XZPQ==:117 a=CQdxDb2CKd3SRg4I0/XZPQ==:17 a=DsvgjBjRAAAA:8 a=f5113yIGAAAA:8 a=9i_RQKNPAAAA:8 a=y7kgw_RnJtkA:10 a=IkcTkHD0fZMA:10 a=hEr_IkYJT6EA:10 a=x_XPkuGwIRMA:10 a=uRRa74qj2VoA:10 a=ttMgCLtsAAAA:8 a=h1uDSDkTZe6f9KqZ_1QA:9 a=QEXdDO2ut3YA:10 Original-Received: from [76.218.37.33] (port=50990 helo=TAKVER2) by host114.hostmonster.com with esmtpa (Exim 4.84) (envelope-from ) id 1ZNHxu-0002rk-Ry for emacs-devel@gnu.org; Thu, 06 Aug 2015 03:59:59 -0600 In-Reply-To: <55C279B0.5040708@cumego.com> (=?utf-8?Q?=22Przemys=C5=82aw?= Wojnowski"'s message of "Wed, 05 Aug 2015 23:01:36 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.5 (windows-nt) X-Identified-User: {2442:host114.hostmonster.com:stephele:stephe-leake.org} {sentby:smtp auth 76.218.37.33 authed with stephen_leake@stephe-leake.org} X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 69.89.18.3 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:188490 Archived-At: Przemys=C5=82aw Wojnowski writes: >>> What is the fastest way to find out since when a function/var is availa= ble in >>> Emacs? >> I use "git annotate". > It may be some solution for core Emacs developers, but you can't > expect a programmer, that wants to write an Emacs package, to do this. > > Adding simple "Since: x" to a doc is not very time consuming,=20 Not for one doc, but it adds up _very_ quickly. And it will be very easy to forget to change it on a later edit; no information is one thing, wrong information is worse. > but may > make life much easier to its users. I guess we disagree on that. In particular, it is only useful for a very small subset of functions/variables. The ones that you happen to need are useful, but there's no way to know in advance which ones that will be. I like Eli's 'git annotate' solution; that's an automated way to get mostly what you are asking for. It needs another step; relating a git hash to an Emacs version. I hope there's a git function that takes a hash and two tags and tells you if the hash occured between them. --=20 -- Stephe