* bug#19490: Unclear info about libraries/packaging in manual
@ 2015-01-02 6:59 Kelly Dean
2019-08-02 20:37 ` Lars Ingebrigtsen
0 siblings, 1 reply; 2+ messages in thread
From: Kelly Dean @ 2015-01-02 6:59 UTC (permalink / raw)
To: 19490
«(elisp) Library Headers» says:
⌜`Keywords'
This line lists keywords for the `finder-by-keyword' help command.
Please use that command to see a list of the meaningful keywords.
...
The name of this field is unfortunate, since people often assume
it is the place to write arbitrary keywords that describe their
package, rather than just the relevant Finder keywords.⌝
«(elisp) Simple Packages» says:
⌜A simple package consists of a single Emacs Lisp source file. The file
must conform to the Emacs Lisp library header conventions (*note
Library Headers)⌝
but it shows a contradicting example package with:
⌜;; Keywords: multimedia, frobnicate⌝
Also, «(elisp) Library Headers» says to use a ⌜Homepage⌝ header, but «(elisp) Simple Packages» says to use a ⌜URL⌝ header.
^ permalink raw reply [flat|nested] 2+ messages in thread* bug#19490: Unclear info about libraries/packaging in manual
2015-01-02 6:59 bug#19490: Unclear info about libraries/packaging in manual Kelly Dean
@ 2019-08-02 20:37 ` Lars Ingebrigtsen
0 siblings, 0 replies; 2+ messages in thread
From: Lars Ingebrigtsen @ 2019-08-02 20:37 UTC (permalink / raw)
To: Kelly Dean; +Cc: 19490
Kelly Dean <kelly@prtime.org> writes:
> «(elisp) Library Headers» says:
> ⌜`Keywords'
> This line lists keywords for the `finder-by-keyword' help command.
> Please use that command to see a list of the meaningful keywords.
> ...
> The name of this field is unfortunate, since people often assume
> it is the place to write arbitrary keywords that describe their
> package, rather than just the relevant Finder keywords.⌝
>
> «(elisp) Simple Packages» says:
> ⌜A simple package consists of a single Emacs Lisp source file. The file
> must conform to the Emacs Lisp library header conventions (*note
> Library Headers)⌝
>
> but it shows a contradicting example package with:
> ⌜;; Keywords: multimedia, frobnicate⌝
>
> Also, «(elisp) Library Headers» says to use a ⌜Homepage⌝ header, but
> «(elisp) Simple Packages» says to use a ⌜URL⌝ header.
I've now fixed these inconsistencies in Emacs 27.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2019-08-02 20:37 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2015-01-02 6:59 bug#19490: Unclear info about libraries/packaging in manual Kelly Dean
2019-08-02 20:37 ` Lars Ingebrigtsen
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
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).