From aaa5ae90a90ba45c81bc7036ceedf5f15038c47e Mon Sep 17 00:00:00 2001 From: Philip Kaludercic Date: Sat, 22 Oct 2022 00:14:15 +0200 Subject: [PATCH] Rephrase initial paragraph in "Package from Source" section * doc/emacs/package.texi (Package from Source): Clarify motivation. --- doc/emacs/package.texi | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/doc/emacs/package.texi b/doc/emacs/package.texi index 584f85567f2..f5301b73067 100644 --- a/doc/emacs/package.texi +++ b/doc/emacs/package.texi @@ -534,15 +534,16 @@ system-wide package directory, the deletion command signals an error. @node Package from Source @section Package from Source -@cindex package source vcs git @c "git" is not technically correct - @c but it is a popular term - - By default @code{package-install} will download a Tarball from a -package archive and install the files therein contained. Most of the -time this is just what you want. One exception is when you decide to -hack on the source code of a package, and would like to share these -changes with other users. In that case you usually want to fetch and -work on the upstream source, so that you can prepare a usable patch. +@cindex package development source +@cindex upstream source, for packages +@cindex git source of package @c "git" is not technically correct + + By default @code{package-install} downloads a Tarball from a package +archive and installs its files. This might be inadequate if you wish +to hack on the package sources and share your changes with others. In +that case, you may prefer to directly fetch and work on the upstream +source. This often makes it easier to develop patches and report +bugs. @findex package-vc-install One way to do this is to use @code{package-vc-install}, to fetch the -- 2.39.5