all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* bug#50825: master 44dbc11: Note that the Packaging sub-nodes are mostly for maintainers
       [not found] ` <20210927041334.574B220A5E@vcs0.savannah.gnu.org>
@ 2021-09-27 12:47   ` Stefan Kangas
  2021-09-28  5:22     ` Lars Ingebrigtsen
  0 siblings, 1 reply; 2+ messages in thread
From: Stefan Kangas @ 2021-09-27 12:47 UTC (permalink / raw)
  To: Lars Ingebrigtsen, 50825

larsi@gnus.org (Lars Ingebrigtsen) writes:

> branch: master
> commit 44dbc11ff7bdccc8af2cdd311e6ebacfef2c43a7
> Author: Lars Ingebrigtsen <larsi@gnus.org>
> Commit: Lars Ingebrigtsen <larsi@gnus.org>
>
>     Note that the Packaging sub-nodes are mostly for maintainers
>
>     * doc/lispref/package.texi (Packaging): Note that the information
>     is mostly for ELPA maintainers (bug#50825).
> ---
>  doc/lispref/package.texi | 5 +++++
>  1 file changed, 5 insertions(+)
>
> diff --git a/doc/lispref/package.texi b/doc/lispref/package.texi
> index 9c033fe..aeb455b 100644
> --- a/doc/lispref/package.texi
> +++ b/doc/lispref/package.texi
> @@ -17,6 +17,11 @@ put it in a @dfn{package archive} for others to download.
>  @xref{Packages,,, emacs, The GNU Emacs Manual}, for a description of
>  user-level features of the packaging system.
>
> +  These sections are mostly directed towards package archive
> +maintainers---much of this information is not relevant for package
> +authors (i.e., people who write code that will be distributed via
> +these archives).
> +
>  @menu
>  * Packaging Basics::        The basic concepts of Emacs Lisp packages.
>  * Simple Packages::         How to package a single .el file.

If this entire section is only relevant for package archive maintainers,
I think it should be wrapped in "@ifnottex" so it's excluded from the
printed manual.

But it seems to me that, while of the information indeed almost only
relevant for package maintainers, at least some part of it is useful for
package developers.  Do you agree?  See for example this paragraph in
(info "(elisp) Packaging Basics").

       Installing a package, either via the command ‘package-install-file’,
    or via the Package Menu, creates a subdirectory of ‘package-user-dir’
    named ‘NAME-VERSION’, where NAME is the package’s name and VERSION its
    version (e.g., ‘~/.emacs.d/elpa/auctex-11.86/’).

And then it repeats some stuff about `package-activate-all' that is
presumably already said in the user manual.

See also (info "(elisp) Simple Packages").

Perhaps we should think about it a bit more and make it more clear who
this documentation is intended for?  Once we know that, it should be
easier to make any necessary changes.

For example, if this is indeed all mixed up, could we split this up into
two subchapters or something?  In the more user-oriented section, we
could skip many of the more low-level details and just focus on: here's
what you need to do to produce a valid package.  Or perhaps that should
be documented by the package archives themselves?  Or is that in the
user manual?  Etc.





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

* bug#50825: master 44dbc11: Note that the Packaging sub-nodes are mostly for maintainers
  2021-09-27 12:47   ` bug#50825: master 44dbc11: Note that the Packaging sub-nodes are mostly for maintainers Stefan Kangas
@ 2021-09-28  5:22     ` Lars Ingebrigtsen
  0 siblings, 0 replies; 2+ messages in thread
From: Lars Ingebrigtsen @ 2021-09-28  5:22 UTC (permalink / raw)
  To: Stefan Kangas; +Cc: 50825

Stefan Kangas <stefankangas@gmail.com> writes:

> For example, if this is indeed all mixed up, could we split this up into
> two subchapters or something?  In the more user-oriented section, we
> could skip many of the more low-level details and just focus on: here's
> what you need to do to produce a valid package.  Or perhaps that should
> be documented by the package archives themselves?  Or is that in the
> user manual?  Etc.

Yes, I think splitting up this part of the manual would be a good idea.

-- 
(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:[~2021-09-28  5:22 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
     [not found] <20210927041333.1836.5637@vcs0.savannah.gnu.org>
     [not found] ` <20210927041334.574B220A5E@vcs0.savannah.gnu.org>
2021-09-27 12:47   ` bug#50825: master 44dbc11: Note that the Packaging sub-nodes are mostly for maintainers Stefan Kangas
2021-09-28  5:22     ` Lars Ingebrigtsen

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.