* Re: [GNU ELPA] Denote version 1.0.0
[not found] <85czbd44kc.fsf@elpa.gnu.org>
@ 2022-09-30 9:11 ` Protesilaos Stavrou
2022-09-30 15:42 ` Stefan Monnier via GNU Emacs source code postings and patches
0 siblings, 1 reply; 5+ messages in thread
From: Protesilaos Stavrou @ 2022-09-30 9:11 UTC (permalink / raw)
To: help-gnu-emacs, gnu-emacs-sources; +Cc: Denote Development
> From: ELPA update <do.not.reply@elpa.gnu.org>
> Date: Fri, 30 Sep 2022 05:03:31 -0400
> Version 1.0.0 of package Denote has just been released in GNU ELPA.
> You can now find it in M-x package-list RET.
>
> Denote describes itself as:
> Simple notes with an efficient file-naming scheme
>
> More at https://elpa.gnu.org/packages/denote.html
>
> Recent NEWS:
> [... 89 lines elided]
Hello everyone,
The quoted part is an automated message that GNU ELPA produces. I want
to check how it does it and whether we can have some control over it
(e.g. its length).
Full release notes here:
<https://protesilaos.com/codelog/2022-09-30-denote-1-0-0/>.
All the best,
Protesilaos (or simply "Prot")
--
Protesilaos Stavrou
https://protesilaos.com
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [GNU ELPA] Denote version 1.0.0
2022-09-30 9:11 ` [GNU ELPA] Denote version 1.0.0 Protesilaos Stavrou
@ 2022-09-30 15:42 ` Stefan Monnier via GNU Emacs source code postings and patches
2022-10-02 1:09 ` Richard Stallman
0 siblings, 1 reply; 5+ messages in thread
From: Stefan Monnier via GNU Emacs source code postings and patches @ 2022-09-30 15:42 UTC (permalink / raw)
To: gnu-emacs-sources; +Cc: help-gnu-emacs
Protesilaos Stavrou [2022-09-30 12:11:16] wrote:
>> From: ELPA update <do.not.reply@elpa.gnu.org>
>> Date: Fri, 30 Sep 2022 05:03:31 -0400
>
>> Version 1.0.0 of package Denote has just been released in GNU ELPA.
>> You can now find it in M-x package-list RET.
>>
>> Denote describes itself as:
>> Simple notes with an efficient file-naming scheme
>>
>> More at https://elpa.gnu.org/packages/denote.html
>>
>> Recent NEWS:
>
>> [... 89 lines elided]
>
> Hello everyone,
>
> The quoted part is an automated message that GNU ELPA produces. I want
> to check how it does it and whether we can have some control over it
See the `elpa-admin.el` code in the `elpa-admin` branch of `elpa.git`:
https://git.savannah.gnu.org/cgit/emacs/elpa.git/tree/elpa-admin.el?h=elpa-admin
the relevant piece of code is in the function `elpaa--release-email`.
> (e.g. its length).
This part is more specifically in `elpaa--get-NEWS` where we truncate to
about 4kB.
Stefan
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [GNU ELPA] Denote version 1.0.0
2022-09-30 15:42 ` Stefan Monnier via GNU Emacs source code postings and patches
@ 2022-10-02 1:09 ` Richard Stallman
2022-10-02 7:23 ` Protesilaos Stavrou
0 siblings, 1 reply; 5+ messages in thread
From: Richard Stallman @ 2022-10-02 1:09 UTC (permalink / raw)
To: emacs-devel
[[[ To any NSA and FBI agents reading my email: please consider ]]]
[[[ whether defending the US Constitution against all enemies, ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]
> >> Version 1.0.0 of package Denote has just been released in GNU ELPA.
> >> You can now find it in M-x package-list RET.
> >>
> >> Denote describes itself as:
> >> Simple notes with an efficient file-naming scheme
The name "Denote" is an example of a class of clever names that we can
call "half-helpful".
Why half-helpful? Because once you know that "Denote" refers to
"taking notes", you will probably remember that. When you see the name
"Denote", you will recall what the package is good for.
Why only half helpful? Because if you see only the name "Denote"
without the clue, you won't have the faintest idea what the package is
good for. This initial mystery is what makes the name amusingly
clever.
Can we come up with documentation conventions, for use when mentioning
these half-helpful names, that will systematicall give the clue about
each?
--
Dr Richard Stallman (https://stallman.org)
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [GNU ELPA] Denote version 1.0.0
2022-10-02 1:09 ` Richard Stallman
@ 2022-10-02 7:23 ` Protesilaos Stavrou
2022-10-09 23:02 ` Richard Stallman
0 siblings, 1 reply; 5+ messages in thread
From: Protesilaos Stavrou @ 2022-10-02 7:23 UTC (permalink / raw)
To: rms, emacs-devel
> From: Richard Stallman <rms@gnu.org>
> Date: Sat, 1 Oct 2022 21:09:04 -0400
>
> [[[ To any NSA and FBI agents reading my email: please consider ]]]
> [[[ whether defending the US Constitution against all enemies, ]]]
> [[[ foreign or domestic, requires you to follow Snowden's example. ]]]
>
> > >> Version 1.0.0 of package Denote has just been released in GNU ELPA.
> > >> You can now find it in M-x package-list RET.
> > >>
> > >> Denote describes itself as:
> > >> Simple notes with an efficient file-naming scheme
>
> The name "Denote" is an example of a class of clever names that we can
> call "half-helpful".
>
> Why half-helpful? Because once you know that "Denote" refers to
> "taking notes", you will probably remember that. When you see the name
> "Denote", you will recall what the package is good for.
>
> Why only half helpful? Because if you see only the name "Denote"
> without the clue, you won't have the faintest idea what the package is
> good for. This initial mystery is what makes the name amusingly
> clever.
>
> Can we come up with documentation conventions, for use when mentioning
> these half-helpful names, that will systematicall give the clue about
> each?
In principle, I am happy to conform with such conventions. Some notes:
* The 'M-x list-packages' includes a one-line description. Those
usually suffice to explain what the package tries to achieve.
* Any convention of this sort should not nudge us towards favouring
generic names like "emacs-notes", "notes-mode", "notes.el", etc.
There are lots of packages out there that have similar functionality.
If we all go for the generic name, we will keep clashing with each
other.
* Generic names can make it more difficult for core Emacs to introduce
new features. For example, we recently got 'emoji.el'. If some
package had already taken this name, it would complicate things for
the respective maintainers.
--
Protesilaos Stavrou
https://protesilaos.com
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [GNU ELPA] Denote version 1.0.0
2022-10-02 7:23 ` Protesilaos Stavrou
@ 2022-10-09 23:02 ` Richard Stallman
0 siblings, 0 replies; 5+ messages in thread
From: Richard Stallman @ 2022-10-09 23:02 UTC (permalink / raw)
To: Protesilaos Stavrou; +Cc: emacs-devel
[[[ To any NSA and FBI agents reading my email: please consider ]]]
[[[ whether defending the US Constitution against all enemies, ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]
> * Any convention of this sort should not nudge us towards favouring
> generic names like "emacs-notes", "notes-mode", "notes.el", etc.
> There are lots of packages out there that have similar functionality.
> If we all go for the generic name, we will keep clashing with each
> other.
I agree. A very helpful name might consist of a general word (such as
"notes") and a more specific word to distinguish this package
from others in the same general area of activity.
--
Dr Richard Stallman (https://stallman.org)
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2022-10-09 23:02 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
[not found] <85czbd44kc.fsf@elpa.gnu.org>
2022-09-30 9:11 ` [GNU ELPA] Denote version 1.0.0 Protesilaos Stavrou
2022-09-30 15:42 ` Stefan Monnier via GNU Emacs source code postings and patches
2022-10-02 1:09 ` Richard Stallman
2022-10-02 7:23 ` Protesilaos Stavrou
2022-10-09 23:02 ` Richard Stallman
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.