unofficial mirror of help-gnu-emacs@gnu.org
 help / color / mirror / Atom feed
* package-mode, release notes?
@ 2013-05-20 13:54 Neal Becker
  2013-05-20 23:07 ` Xue Fuqiao
  0 siblings, 1 reply; 16+ messages in thread
From: Neal Becker @ 2013-05-20 13:54 UTC (permalink / raw)
  To: help-gnu-emacs

I wish I could see the release notes when updating a package in package-mode.




^ permalink raw reply	[flat|nested] 16+ messages in thread

* Re: package-mode, release notes?
  2013-05-20 13:54 package-mode, release notes? Neal Becker
@ 2013-05-20 23:07 ` Xue Fuqiao
  2013-05-20 23:42   ` Dmitry Gutov
  2013-05-21  2:54   ` Teemu Likonen
  0 siblings, 2 replies; 16+ messages in thread
From: Xue Fuqiao @ 2013-05-20 23:07 UTC (permalink / raw)
  To: Neal Becker; +Cc: help-gnu-emacs

On Mon, May 20, 2013 at 9:54 PM, Neal Becker <ndbecker2@gmail.com> wrote:
> I wish I could see the release notes when updating a package in package-mode.

Maybe you meant package.el.  You can send it to bug-gnu-emacs@gnu.org or
Tom (elpa AT tromey.com).

--
Best regards, Xue Fuqiao.
http://www.gnu.org/software/emacs/



^ permalink raw reply	[flat|nested] 16+ messages in thread

* Re: package-mode, release notes?
  2013-05-20 23:07 ` Xue Fuqiao
@ 2013-05-20 23:42   ` Dmitry Gutov
  2013-05-21  2:54   ` Teemu Likonen
  1 sibling, 0 replies; 16+ messages in thread
From: Dmitry Gutov @ 2013-05-20 23:42 UTC (permalink / raw)
  To: Xue Fuqiao; +Cc: Neal Becker, help-gnu-emacs

Xue Fuqiao <xfq.free@gmail.com> writes:

> On Mon, May 20, 2013 at 9:54 PM, Neal Becker <ndbecker2@gmail.com> wrote:
>> I wish I could see the release notes when updating a package in package-mode.
>
> Maybe you meant package.el.  You can send it to bug-gnu-emacs@gnu.org or
> Tom (elpa AT tromey.com).

To be more accurate, you can send the feature request to
bug-gnu-emacs@gnu.org, but you probably shouldn't email Tom on this
subject (he's the author of package.el, but he's not maintaining it).



^ permalink raw reply	[flat|nested] 16+ messages in thread

* Re: package-mode, release notes?
  2013-05-20 23:07 ` Xue Fuqiao
  2013-05-20 23:42   ` Dmitry Gutov
@ 2013-05-21  2:54   ` Teemu Likonen
  2013-05-21 11:26     ` Neal Becker
       [not found]     ` <mailman.119.1369135588.22516.help-gnu-emacs@gnu.org>
  1 sibling, 2 replies; 16+ messages in thread
From: Teemu Likonen @ 2013-05-21  2:54 UTC (permalink / raw)
  To: Xue Fuqiao; +Cc: Neal Becker, help-gnu-emacs

[-- Attachment #1: Type: text/plain, Size: 480 bytes --]

Xue Fuqiao [2013-05-21 07:07:06 +08:00] wrote:

> On Mon, May 20, 2013 at 9:54 PM, Neal Becker <ndbecker2@gmail.com> wrote:
>> I wish I could see the release notes when updating a package in
>> package-mode.
>
> Maybe you meant package.el. You can send it to bug-gnu-emacs@gnu.org
> or Tom (elpa AT tromey.com).

But I don't think there are _the_ release notes anyway. I mean there are
no standard way for package authors for publishing release notes. My
packages don't have any.

[-- Attachment #2: Type: application/pgp-signature, Size: 835 bytes --]

^ permalink raw reply	[flat|nested] 16+ messages in thread

* Re: package-mode, release notes?
  2013-05-21  2:54   ` Teemu Likonen
@ 2013-05-21 11:26     ` Neal Becker
  2013-05-21 12:28       ` Rasmus
       [not found]     ` <mailman.119.1369135588.22516.help-gnu-emacs@gnu.org>
  1 sibling, 1 reply; 16+ messages in thread
From: Neal Becker @ 2013-05-21 11:26 UTC (permalink / raw)
  To: help-gnu-emacs

Teemu Likonen wrote:

> Xue Fuqiao [2013-05-21 07:07:06 +08:00] wrote:
> 
>> On Mon, May 20, 2013 at 9:54 PM, Neal Becker <ndbecker2@gmail.com> wrote:
>>> I wish I could see the release notes when updating a package in
>>> package-mode.
>>
>> Maybe you meant package.el. You can send it to bug-gnu-emacs@gnu.org
>> or Tom (elpa AT tromey.com).
> 
> But I don't think there are _the_ release notes anyway. I mean there are
> no standard way for package authors for publishing release notes. My
> packages don't have any.

Maybe it would be nice to introduce a standard way for package.el to point to 
release notes?




^ permalink raw reply	[flat|nested] 16+ messages in thread

* Re: package-mode, release notes?
  2013-05-21 11:26     ` Neal Becker
@ 2013-05-21 12:28       ` Rasmus
  0 siblings, 0 replies; 16+ messages in thread
From: Rasmus @ 2013-05-21 12:28 UTC (permalink / raw)
  To: help-gnu-emacs


>>>> I wish I could see the release notes when updating a package in
>>>> package-mode.
>>>
>>> Maybe you meant package.el. You can send it to bug-gnu-emacs@gnu.org
>>> or Tom (elpa AT tromey.com).
>> 
>> But I don't think there are _the_ release notes anyway. I mean there are
>> no standard way for package authors for publishing release notes. My
>> packages don't have any.
>
> Maybe it would be nice to introduce a standard way for package.el to point to 
> release notes?

I often miss a URL to the origin (often a Github page) to read more
about the package.  Sometimes I have to go to MELPA or Marmelade to
find the url, but sometimes I can also just look in the commentary in
the beginning of the installed (main) file.

–Rasmus

-- 
May the Force be with you




^ permalink raw reply	[flat|nested] 16+ messages in thread

* Re: package-mode, release notes?
       [not found]     ` <mailman.119.1369135588.22516.help-gnu-emacs@gnu.org>
@ 2013-06-03 16:20       ` Ted Zlatanov
  2013-06-03 17:30         ` Stefan Monnier
       [not found]         ` <mailman.950.1370284310.22516.help-gnu-emacs@gnu.org>
  0 siblings, 2 replies; 16+ messages in thread
From: Ted Zlatanov @ 2013-06-03 16:20 UTC (permalink / raw)
  To: help-gnu-emacs

On Tue, 21 May 2013 07:26:09 -0400 Neal Becker <ndbecker2@gmail.com> wrote: 

NB> Maybe it would be nice to introduce a standard way for package.el to point to 
NB> release notes?

How do you define "release notes"?  The VCS commit log may be more
useful than a text file, depending on the number and significance of the
changes and on the version difference (major vs. minor upgrade, etc.)

Ted


^ permalink raw reply	[flat|nested] 16+ messages in thread

* Re: package-mode, release notes?
  2013-06-03 16:20       ` Ted Zlatanov
@ 2013-06-03 17:30         ` Stefan Monnier
       [not found]         ` <mailman.950.1370284310.22516.help-gnu-emacs@gnu.org>
  1 sibling, 0 replies; 16+ messages in thread
From: Stefan Monnier @ 2013-06-03 17:30 UTC (permalink / raw)
  To: help-gnu-emacs

> How do you define "release notes"?

A user-oriented description of change (as opposed to the commit
messages which are typically developper-oriented).
For example, compare Emacs's etc/NEWS and its ChangeLog.


        Stefan




^ permalink raw reply	[flat|nested] 16+ messages in thread

* Re: package-mode, release notes?
       [not found]         ` <mailman.950.1370284310.22516.help-gnu-emacs@gnu.org>
@ 2013-06-04 14:17           ` Ted Zlatanov
  2013-06-05  2:36             ` Stefan Monnier
       [not found]             ` <mailman.1010.1370399840.22516.help-gnu-emacs@gnu.org>
  0 siblings, 2 replies; 16+ messages in thread
From: Ted Zlatanov @ 2013-06-04 14:17 UTC (permalink / raw)
  To: help-gnu-emacs

On Mon, 03 Jun 2013 13:30:49 -0400 Stefan Monnier <monnier@iro.umontreal.ca> wrote: 

>> How do you define "release notes"?

SM> A user-oriented description of change (as opposed to the commit
SM> messages which are typically developper-oriented).
SM> For example, compare Emacs's etc/NEWS and its ChangeLog.

So can we just say the file NEWS is the standard place for GNU ELPA
package release notes?

Ted


^ permalink raw reply	[flat|nested] 16+ messages in thread

* Re: package-mode, release notes?
  2013-06-04 14:17           ` Ted Zlatanov
@ 2013-06-05  2:36             ` Stefan Monnier
       [not found]             ` <mailman.1010.1370399840.22516.help-gnu-emacs@gnu.org>
  1 sibling, 0 replies; 16+ messages in thread
From: Stefan Monnier @ 2013-06-05  2:36 UTC (permalink / raw)
  To: help-gnu-emacs

>>> How do you define "release notes"?
SM> A user-oriented description of change (as opposed to the commit
SM> messages which are typically developper-oriented).
SM> For example, compare Emacs's etc/NEWS and its ChangeLog.
> So can we just say the file NEWS is the standard place for GNU ELPA
> package release notes?

We could, yes, for multi-file packages.  And for single-file packages,
we could use a ";;; News:" section.


        Stefan




^ permalink raw reply	[flat|nested] 16+ messages in thread

* Re: package-mode, release notes?
       [not found]             ` <mailman.1010.1370399840.22516.help-gnu-emacs@gnu.org>
@ 2013-06-05 15:28               ` Ted Zlatanov
  2013-06-06  0:24                 ` Stefan Monnier
       [not found]                 ` <mailman.1061.1370478287.22516.help-gnu-emacs@gnu.org>
  0 siblings, 2 replies; 16+ messages in thread
From: Ted Zlatanov @ 2013-06-05 15:28 UTC (permalink / raw)
  To: help-gnu-emacs

On Tue, 04 Jun 2013 22:36:58 -0400 Stefan Monnier <monnier@iro.umontreal.ca> wrote: 

>>>> How do you define "release notes"?
SM> A user-oriented description of change (as opposed to the commit
SM> messages which are typically developper-oriented).
SM> For example, compare Emacs's etc/NEWS and its ChangeLog.
>> So can we just say the file NEWS is the standard place for GNU ELPA
>> package release notes?

SM> We could, yes, for multi-file packages.  And for single-file packages,
SM> we could use a ";;; News:" section.

OK, that makes implementing the feature much easier:

- display a NEWS file anywhere in the package (or top-level only), or
- display the ";;; News:" section, or
- offer the ChangeLog?  Fail gracefully?  Something else.

So coming back to the original request:

>> On Mon, May 20, 2013 at 9:54 PM, Neal Becker <ndbecker2@gmail.com> wrote:
>>> I wish I could see the release notes when updating a package in
>>> package-mode.

Where in the update process should this happen?  Before (when marking),
during (in a log buffer), or after?

It seems best to give this information when marking which will also give
access to it from the package list in general.  During the update it's
too late to back out and log buffers are volatile.

Ted


^ permalink raw reply	[flat|nested] 16+ messages in thread

* Re: package-mode, release notes?
  2013-06-05 15:28               ` Ted Zlatanov
@ 2013-06-06  0:24                 ` Stefan Monnier
       [not found]                 ` <mailman.1061.1370478287.22516.help-gnu-emacs@gnu.org>
  1 sibling, 0 replies; 16+ messages in thread
From: Stefan Monnier @ 2013-06-06  0:24 UTC (permalink / raw)
  To: help-gnu-emacs

> Where in the update process should this happen?  Before (when marking),
> during (in a log buffer), or after?

Since this info is currently not in archive-contents, the easiest is to
do it after downloading the package.


        Stefan




^ permalink raw reply	[flat|nested] 16+ messages in thread

* Re: package-mode, release notes?
       [not found]                 ` <mailman.1061.1370478287.22516.help-gnu-emacs@gnu.org>
@ 2013-06-06 13:09                   ` Ted Zlatanov
  2013-06-06 21:16                     ` Stefan Monnier
       [not found]                     ` <mailman.1115.1370553381.22516.help-gnu-emacs@gnu.org>
  0 siblings, 2 replies; 16+ messages in thread
From: Ted Zlatanov @ 2013-06-06 13:09 UTC (permalink / raw)
  To: help-gnu-emacs

On Wed, 05 Jun 2013 20:24:21 -0400 Stefan Monnier <monnier@iro.umontreal.ca> wrote: 

>> Where in the update process should this happen?  Before (when marking),
>> during (in a log buffer), or after?

SM> Since this info is currently not in archive-contents, the easiest is to
SM> do it after downloading the package.

Why not make the command download the package if it's not downloaded,
then display the release notes if the download worked?

It seems important to be able to do this before the installation step.

Ted


^ permalink raw reply	[flat|nested] 16+ messages in thread

* Re: package-mode, release notes?
  2013-06-06 13:09                   ` Ted Zlatanov
@ 2013-06-06 21:16                     ` Stefan Monnier
       [not found]                     ` <mailman.1115.1370553381.22516.help-gnu-emacs@gnu.org>
  1 sibling, 0 replies; 16+ messages in thread
From: Stefan Monnier @ 2013-06-06 21:16 UTC (permalink / raw)
  To: help-gnu-emacs

>>> Where in the update process should this happen?  Before (when marking),
>>> during (in a log buffer), or after?
SM> Since this info is currently not in archive-contents, the easiest is to
SM> do it after downloading the package.
> Why not make the command download the package if it's not downloaded,
> then display the release notes if the download worked?

Clearly, if it needs to be downloaded, then we ... hmm... need to
download it ;-)

> It seems important to be able to do this before the installation step.

download != installation (which is not equal to activation either, nor
to compilation).


        Stefan




^ permalink raw reply	[flat|nested] 16+ messages in thread

* Re: package-mode, release notes?
       [not found]                     ` <mailman.1115.1370553381.22516.help-gnu-emacs@gnu.org>
@ 2013-06-07 13:09                       ` Ted Zlatanov
  2013-06-08  0:53                         ` Stefan Monnier
  0 siblings, 1 reply; 16+ messages in thread
From: Ted Zlatanov @ 2013-06-07 13:09 UTC (permalink / raw)
  To: help-gnu-emacs

On Thu, 06 Jun 2013 17:16:05 -0400 Stefan Monnier <monnier@iro.umontreal.ca> wrote: 

>>>> Where in the update process should this happen?  Before (when marking),
>>>> during (in a log buffer), or after?
SM> Since this info is currently not in archive-contents, the easiest is to
SM> do it after downloading the package.
>> Why not make the command download the package if it's not downloaded,
>> then display the release notes if the download worked?

SM> Clearly, if it needs to be downloaded, then we ... hmm... need to
SM> download it ;-)

SM> download != installation (which is not equal to activation either, nor
SM> to compilation).

Right, I knew that :)  So this command will:

1) download the package if necessary
2) display the release notes according to the rules listed earlier in a
   help-buffer

...and it will have no interdependence with the installation process,
meaning that it will work with a package in any state.

Sounds good?
Ted


^ permalink raw reply	[flat|nested] 16+ messages in thread

* Re: package-mode, release notes?
  2013-06-07 13:09                       ` Ted Zlatanov
@ 2013-06-08  0:53                         ` Stefan Monnier
  0 siblings, 0 replies; 16+ messages in thread
From: Stefan Monnier @ 2013-06-08  0:53 UTC (permalink / raw)
  To: help-gnu-emacs

> 1) download the package if necessary
> 2) display the release notes according to the rules listed earlier in a
>    help-buffer

> ...and it will have no interdependence with the installation process,
> meaning that it will work with a package in any state.

> Sounds good?

Yes, sounds fine.  Bonus points for keeping track of package already
downloaded so we try and avoid downloading them again (e.g. if the
notes are consulted several times, or if we want to install the package
after consulting the notes, or if we want to consult the notes after
installing the package).


        Stefan




^ permalink raw reply	[flat|nested] 16+ messages in thread

end of thread, other threads:[~2013-06-08  0:53 UTC | newest]

Thread overview: 16+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2013-05-20 13:54 package-mode, release notes? Neal Becker
2013-05-20 23:07 ` Xue Fuqiao
2013-05-20 23:42   ` Dmitry Gutov
2013-05-21  2:54   ` Teemu Likonen
2013-05-21 11:26     ` Neal Becker
2013-05-21 12:28       ` Rasmus
     [not found]     ` <mailman.119.1369135588.22516.help-gnu-emacs@gnu.org>
2013-06-03 16:20       ` Ted Zlatanov
2013-06-03 17:30         ` Stefan Monnier
     [not found]         ` <mailman.950.1370284310.22516.help-gnu-emacs@gnu.org>
2013-06-04 14:17           ` Ted Zlatanov
2013-06-05  2:36             ` Stefan Monnier
     [not found]             ` <mailman.1010.1370399840.22516.help-gnu-emacs@gnu.org>
2013-06-05 15:28               ` Ted Zlatanov
2013-06-06  0:24                 ` Stefan Monnier
     [not found]                 ` <mailman.1061.1370478287.22516.help-gnu-emacs@gnu.org>
2013-06-06 13:09                   ` Ted Zlatanov
2013-06-06 21:16                     ` Stefan Monnier
     [not found]                     ` <mailman.1115.1370553381.22516.help-gnu-emacs@gnu.org>
2013-06-07 13:09                       ` Ted Zlatanov
2013-06-08  0:53                         ` Stefan Monnier

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).