From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: Fetching or installing package dev source from VCS: manual style Date: Tue, 18 Oct 2022 08:04:08 -0400 Message-ID: References: <164484721900.31751.1453162457552427931@vcs2.savannah.gnu.org> <20220214140020.04438C00891@vcs2.savannah.gnu.org> <87bkqmqpvb.fsf@posteo.net> <871qris3xb.fsf@gnus.org> <877d1aqoc1.fsf@posteo.net> <87edvhqdrb.fsf@gnus.org> <871qrh2hh6.fsf@posteo.net> <87mta5oyec.fsf@gnus.org> <87sfjx10x1.fsf@posteo.net> <875ygsp0ng.fsf@gnus.org> <87h70c9bu4.fsf@posteo.net> <874jw73cjy.fsf@posteo.net> <877d0z5216.fsf@posteo.net> Reply-To: rms@gnu.org Content-Type: text/plain; charset=Utf-8 Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="37372"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Philip Kaludercic Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Oct 18 14:20:19 2022 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1oklZz-0009Yr-BM for ged-emacs-devel@m.gmane-mx.org; Tue, 18 Oct 2022 14:20:19 +0200 Original-Received: from localhost ([::1]:56428 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oklZw-0004ft-Sb for ged-emacs-devel@m.gmane-mx.org; Tue, 18 Oct 2022 08:20:17 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:43772) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oklKP-0003JU-Ha for emacs-devel@gnu.org; Tue, 18 Oct 2022 08:04:22 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:47988) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oklKN-00050E-H0; Tue, 18 Oct 2022 08:04:11 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=Date:References:Subject:In-Reply-To:To:From: mime-version; bh=IlrgDG0A188iemOy+GiwHtq2+gLW4vUEUQKjx895fc4=; b=HZvHQUQS40s6 +iQ9hzZUCe8OZM8XHMWEdZb+CHTq7+TxRQmnyemk4ydxrsn34XLo6zKRbEqCU1IkB5I8/UrJ8QZFz JsE4Q8LX4O27JSUD+ySMtjFFAeRFIPDUTxKenZxUiYV44ch00sHxbquPMWXAWJc76LaX+SuhQGzxj ty1Fz3ompVPAYai/woB4VXWoeLh4zFg9/68NfCalv+Vgn/HTyWSdft/Q8fYksIVqlkfZ1GaZtUnJH 3DYYQWBNRwruBHrHktnUXeRncwtD6a617aE+gkHfOm1hVVbdMQwct2hGzhWa59QzcBilG4gVAtbJv M1LF73mDXlHGXmTjQ4IX7w==; Original-Received: from rms by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1oklKK-0001ek-7e; Tue, 18 Oct 2022 08:04:10 -0400 In-Reply-To: <877d0z5216.fsf@posteo.net> (message from Philip Kaludercic on Sun, 16 Oct 2022 13:30:29 +0000) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:298034 Archived-At: [[[ 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. ]]] > --8<---------------cut here---------------start------------->8--- > @node Package from Source > @section Package from Source > @cindex package development source > @cindex package upstream source > @cindex package git source @c "git" is not technically correct That improves the @cindex commands. But please look at the whole manual's index and see where these two show up. If two of them appear close together, there is no need for both. If they are separated by several other commands, then it is useful to have both. I used to check the whole index for redundant index entries like this before each Emacs release. > @findex package-vc-install > One way to do this is to use @code{package-vc-install}, to fetch the > source code for a package directly from source. I contend that `package-dev-source' or `package-upstream-source' is a better name than `package-vc-install'. They are better because they describe the crucial difference for which you would use that command: to get the development source rather than the current release source. It is true that the development source will usually come from a VCS, but that's an secondary detail, not the crucial point. The current version's source may be stored in a VCS also. Isn't that normally the case for NonGNU ELPA? -- 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)