[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
feature/package+vc aaa5ae90a9 3/3: Rephrase initial paragraph in "Packag
From: |
Philip Kaludercic |
Subject: |
feature/package+vc aaa5ae90a9 3/3: Rephrase initial paragraph in "Package from Source" section |
Date: |
Fri, 21 Oct 2022 18:14:27 -0400 (EDT) |
branch: feature/package+vc
commit aaa5ae90a90ba45c81bc7036ceedf5f15038c47e
Author: Philip Kaludercic <philipk@posteo.net>
Commit: Philip Kaludercic <philipk@posteo.net>
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 584f85567f..f5301b7306 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