Re: Headers and commentary in package.el

[Stefan Monnier]

> I took a look at the latest version of package.el in the trunk [1],
> and there are problematic omissions from the header. First of all, my
> name appears in neither the ";; Author:" header nor the "Thanks"
> section. I believe that, given the extent of the changes I have made
> to package.el, it would be appropriate for me to be listed in the ";;
> Author:" header. I can accept not being listed in the ";; Author:"
> header, but my name really ought to appear in the "Thanks" section at
> least.

I'll gladly add you there.  You're not there, because for such "core"
packages, we generally don't pay attention to those things in the file.
The ChangeLog file has all that information, in a lot more details.

> Additionally, the ";;; Commentary:" section is out-of-date.

I haven't looked at it.  Patch welcome.

> `package-install-from-buffer' is obsolete and should not be listed in
> the commentary.

Is it?  What replaces it?

> Please see the version from my latest patch here [2]

Not sure how to get a diff from that.  I do see there that you have
aliased package-install-from-buffer to package-install-single, but the
Emacs version of package.el doesn't have this function.
Instead package-install-from-buffer was extended to work in tar-mode
buffers as well.

> Finally, I think the version number should be bumped more than a micro
> (from 1.0 to 1.0.1). Since the internal API is completely
> incompatible, this would suggest a major version bump.

Patch welcome: I only care about package.el as distributed in Emacs, so
the Emacs version number is enough to identify the package.el version,
as far as I'm concerned.


        Stefan