Re: History info in C-h f

[John Shahid]

Stefan Monnier <address@hidden> writes:

> Not sure if we should install this, especially since it's far from
> reliable, but I've just whipped up the code below and figured some of
> you might like it.

That is very useful thanks.  I wanted to know the minimum version of
Emacs that introduced `string-join' recently and had to grep for it in
the NEWS file.  Although grepping isn't that hard, having that
information available on the help page is useful imho.

> With this hack (which can go into your ~/.emacs), `C-h f defmacro`
> dutifully informs you that `defmacro` was added to Emacs-1.2 (at least,
> if you're on `master` and have upgraded very recently), whereas `C-h
> f advice-add` informs you that it was only introduced in Emacs-24.4.

Does it make sense to add a feature to `defun'.  I'm thinking another
optional min version arg that would set a property on the symbol.  That
can be used by "C-h f" to display the minimum version.  I can see that
being useful to package/library maintainers and not just Emacs.


[...]

> +                  (error "Ref found in non-versioned section in %S"
> +                         (file-name-nondirectory f))

I had to get rid of this error, otherwise "C-h f" won't work on
primitves (e.g. `defun' that is used to document other features) or
symbols that are found in NEWS.1-17