emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: How to find when a function/var has been added


From: Stephen Leake
Subject: Re: How to find when a function/var has been added
Date: Thu, 06 Aug 2015 04:59:51 -0500
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/24.5 (windows-nt)

Przemysław Wojnowski <address@hidden> writes:

>>> What is the fastest way to find out since when a function/var is available 
>>> 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, 

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.

-- 
-- Stephe



reply via email to

[Prev in Thread] Current Thread [Next in Thread]