From unknown Fri Jun 20 07:12:14 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#48667 <48667@debbugs.gnu.org> To: bug#48667 <48667@debbugs.gnu.org> Subject: Status: [PATCH] doc: Expound on how to specify the version of a package. Reply-To: bug#48667 <48667@debbugs.gnu.org> Date: Fri, 20 Jun 2025 14:12:14 +0000 retitle 48667 [PATCH] doc: Expound on how to specify the version of a packa= ge. reassign 48667 guix-patches submitter 48667 Xinglu Chen severity 48667 normal tag 48667 patch thanks From debbugs-submit-bounces@debbugs.gnu.org Wed May 26 05:00:39 2021 Received: (at submit) by debbugs.gnu.org; 26 May 2021 09:00:39 +0000 Received: from localhost ([127.0.0.1]:47612 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1llpP5-00038l-Fk for submit@debbugs.gnu.org; Wed, 26 May 2021 05:00:39 -0400 Received: from lists.gnu.org ([209.51.188.17]:46564) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1llpP3-00038d-Is for submit@debbugs.gnu.org; Wed, 26 May 2021 05:00:38 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:53068) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1llpP3-0005KB-8Y for guix-patches@gnu.org; Wed, 26 May 2021 05:00:37 -0400 Received: from h87-96-130-155.cust.a3fiber.se ([87.96.130.155]:39724 helo=mail.yoctocell.xyz) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1llpOw-0007wq-Pk for guix-patches@gnu.org; Wed, 26 May 2021 05:00:37 -0400 From: Xinglu Chen DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=yoctocell.xyz; s=mail; t=1622019626; bh=jZgbZg/9cr6H7r4QGEQsGtE9CCmBIs11z3X8h6qcV18=; h=From:To:Subject:Date; b=ZJoJq8Ymwdxf/euERn3L2alB8PKCoZ91Y1dfnPyMTs/cuT/+Jhkp6VMVg7T/bzt9c CQFMMgQUxHd5zUhAa7tDiooqvbm87eYmPjDGWFVzo/Nna+EuSaBTP5hRhdllH/TcOF 4TIUfSmuD5ghWvpgcTUrhplR60wROmzP5BZabfn4= To: guix-patches@gnu.org Subject: [PATCH] doc: Expound on how to specify the version of a package. Message-Id: <06217762b07f95d2ba2d40277d010647a926df68.1622019402.git.public@yoctocell.xyz> Date: Wed, 26 May 2021 11:00:25 +0200 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=87.96.130.155; envelope-from=public@yoctocell.xyz; helo=mail.yoctocell.xyz X-Spam_score_int: 33 X-Spam_score: 3.3 X-Spam_bar: +++ X-Spam_report: (3.3 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FROM_SUSPICIOUS_NTLD=0.498, FROM_SUSPICIOUS_NTLD_FP=1.896, PDS_OTHER_BAD_TLD=1.997, RDNS_DYNAMIC=0.982, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-Spam-Score: 3.1 (+++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: * doc/guix.texi (package Reference): Describe how packages that lack a release or are pinned to an unreleased version should specify the ‘version’ field. Add documentation for the ‘git-version†[...] Content analysis details: (3.1 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -2.3 RCVD_IN_DNSWL_MED RBL: Sender listed at https://www.dnswl.org/, medium trust [209.51.188.17 listed in list.dnswl.org] 1.0 SPF_SOFTFAIL SPF: sender does not match SPF record (softfail) 2.0 PDS_OTHER_BAD_TLD Untrustworthy TLDs [URI: yoctocell.xyz (xyz)] -0.0 SPF_HELO_PASS SPF: HELO matches SPF record 0.0 RCVD_IN_MSPIKE_H4 RBL: Very Good reputation (+4) [209.51.188.17 listed in wl.mailspike.net] 1.9 FROM_SUSPICIOUS_NTLD_FP From abused NTLD 0.0 RCVD_IN_MSPIKE_WL Mailspike good senders 0.5 FROM_SUSPICIOUS_NTLD From abused NTLD X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.2 (/) * doc/guix.texi (package Reference): Describe how packages that lack a rele= ase or are pinned to an unreleased version should specify the =E2=80=98version= =E2=80=99 field. Add documentation for the =E2=80=98git-version=E2=80=99 procedure. --- I am unsure if the format for packages that don=E2=80=99t have a release sh= ould be =E2=80=980.0.0-REVISION.COMMIT=E2=80=99 or just =E2=80=980-REVISION.COMM= IT=E2=80=99. doc/guix.texi | 23 ++++++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) diff --git a/doc/guix.texi b/doc/guix.texi index e8b0485f78..083f65c9c5 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -89,6 +89,7 @@ Copyright @copyright{} 2020 Jonathan Brielmaier@* Copyright @copyright{} 2020 Edgar Vincent@* Copyright @copyright{} 2021 Maxime Devos@* Copyright @copyright{} 2021 B. Wilson@* +Copyright @copyright{} 2021 Xinglu Chen@* =20 Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or @@ -6651,7 +6652,18 @@ This is the data type representing a package recipe. The name of the package, as a string. =20 @item @code{version} -The version of the package, as a string. +The version of the package, as a string. If there are no releases of +the package, or a unreleased version is desired, the version should +contain @code{VERSION-REVISION.COMMIT}. @code{VERSION} is +@c TODO: 0.0.0 or just 0 ? +@code{0.0.0} or whatever the latest version is, and @code{REVISION} is +the revision of the Guix package (@code{0} if it is a new package), +whenever the package is updated to a newer version the revision should +also be bumped. @code{COMMIT} is the @dfn{commit} or @dfn{changeset} +corresponding to the version, it should only contain 7 characters. If +the fetch method is @code{git-fetch} (@pxref{origin Reference}), there +is the @code{git-version} procedure that makes it easier to specify the +version. =20 @item @code{source} An object telling how the source code for the package should be @@ -6757,6 +6769,15 @@ automatically corrected. @end table @end deftp =20 +@deffn {Scheme Procedure} git-version @var{VERSION} @var{REVISION} @var{CO= MMIT} +Return the version string for packages using @code{git-fetch}. + +@example +(git-version "0.0.0" "0" "93818c936ee7e2f1ba1b315578bde363a7d43d05") +@result{} "0.0.0-0.93818c9" +@end example +@end deffn + @deffn {Scheme Syntax} this-package When used in the @emph{lexical scope} of a package field definition, this identifier resolves to the package being defined. base-commit: 3f2a4b098039bd374c76d524223de3c6c475f23e --=20 2.31.1 From debbugs-submit-bounces@debbugs.gnu.org Wed May 26 09:06:56 2021 Received: (at 48667) by debbugs.gnu.org; 26 May 2021 13:06:56 +0000 Received: from localhost ([127.0.0.1]:47903 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lltFQ-0003gq-71 for submit@debbugs.gnu.org; Wed, 26 May 2021 09:06:56 -0400 Received: from relay7-d.mail.gandi.net ([217.70.183.200]:47969) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lltFO-0003gb-9w for 48667@debbugs.gnu.org; Wed, 26 May 2021 09:06:55 -0400 Received: (Authenticated sender: admin@nicolasgoaziou.fr) by relay7-d.mail.gandi.net (Postfix) with ESMTPSA id 3409820017; Wed, 26 May 2021 13:06:46 +0000 (UTC) From: Nicolas Goaziou To: Xinglu Chen Subject: Re: [bug#48667] [PATCH] doc: Expound on how to specify the version of a package. References: <06217762b07f95d2ba2d40277d010647a926df68.1622019402.git.public@yoctocell.xyz> Date: Wed, 26 May 2021 15:06:45 +0200 In-Reply-To: <06217762b07f95d2ba2d40277d010647a926df68.1622019402.git.public@yoctocell.xyz> (Xinglu Chen's message of "Wed, 26 May 2021 11:00:25 +0200") Message-ID: <87tumphcey.fsf@nicolasgoaziou.fr> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 1.3 (+) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: Hello, Xinglu Chen writes: > * doc/guix.texi (package Reference): Describe how packages that lack a release > or are pinned to an unreleased version should specify the ‘version’ field. > Add documentation for the ‘git-ver [...] Content analysis details: (1.3 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -0.7 RCVD_IN_DNSWL_LOW RBL: Sender listed at https://www.dnswl.org/, low trust [217.70.183.200 listed in list.dnswl.org] -0.0 SPF_PASS SPF: sender matches SPF record 2.0 PDS_OTHER_BAD_TLD Untrustworthy TLDs [URI: yoctocell.xyz (xyz)] 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record X-Debbugs-Envelope-To: 48667 Cc: 48667@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.3 (/) Hello, Xinglu Chen writes: > * doc/guix.texi (package Reference): Describe how packages that lack a re= lease > or are pinned to an unreleased version should specify the =E2=80=98versio= n=E2=80=99 field. > Add documentation for the =E2=80=98git-version=E2=80=99 procedure. Thanks.=20 I don't know if all should be included in the manual (though I think the `git-version' function definitely should), but I'll comment it a bit anyway. > @item @code{version} > -The version of the package, as a string. > +The version of the package, as a string. If there are no releases of > +the package, or a unreleased version is desired, the version should > +contain @code{VERSION-REVISION.COMMIT}. @code{VERSION} is > +@c TODO: 0.0.0 or just 0 ? @samp{@var{VERSION}-@var{REVISION}.@var{COMMIT}} ... @var{VERSION}... I think you should drop the "version 0" case altogether. I don't think enforcing "0" or "0.0.0" does matter, and it adds noise to the explanations. > +@code{0.0.0} or whatever the latest version is, and @code{REVISION} is > +the revision of the Guix package (@code{0} if it is a new package), > +whenever the package is updated to a newer version the revision should > +also be bumped. @var{REVISION} I think you need to explain why bumping revision is needed. Also, this is all specific to hash-based repositories. For example, SVN uses monotonic revisions already, so none of the above applies to such packages. > @code{COMMIT} is the @dfn{commit} or @dfn{changeset} > +corresponding to the version, it should only contain 7 characters. If > +the fetch method is @code{git-fetch} (@pxref{origin Reference}), there > +is the @code{git-version} procedure that makes it easier to specify the > +version. @var{COMMIT} > +@example > +(git-version "0.0.0" "0" "93818c936ee7e2f1ba1b315578bde363a7d43d05") > +@result{} "0.0.0-0.93818c9" > +@end example > +@end deffn Here too, I think the special "0.0.0" case is misleading. Maybe @lisp is more appropriate than @example. Regards, --=20 Nicolas Goaziou From debbugs-submit-bounces@debbugs.gnu.org Wed May 26 10:08:08 2021 Received: (at 48667) by debbugs.gnu.org; 26 May 2021 14:08:08 +0000 Received: from localhost ([127.0.0.1]:49648 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lluCe-0005d0-CL for submit@debbugs.gnu.org; Wed, 26 May 2021 10:08:08 -0400 Received: from h87-96-130-155.cust.a3fiber.se ([87.96.130.155]:54282 helo=mail.yoctocell.xyz) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lluCc-0005by-9z for 48667@debbugs.gnu.org; Wed, 26 May 2021 10:08:07 -0400 From: Xinglu Chen DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=yoctocell.xyz; s=mail; t=1622038078; bh=3cnz0xJFpy0nZA5eC/xEEtSU4U6sDv2dZxaZqdB19jw=; h=From:To:Cc:Subject:In-Reply-To:References:Date; b=dQYJ6VjFqZsp8sC7HUe68J/sawLyOtGprLRB1U+gVGLUJi9QN52zlAN2wcFdwpq/Q waPmRoyo4DvkpUF/J9ZTRM5xhF+CPmnvKf7LOaKVGQNgEOjtPFoRcbhxAHeC19DbID NA7RTc0rTh9UmMCzGbkaUZNBeP4hQUWtyBaV4Hm8= To: Nicolas Goaziou Subject: Re: [bug#48667] [PATCH] doc: Expound on how to specify the version of a package. In-Reply-To: <87tumphcey.fsf@nicolasgoaziou.fr> References: <06217762b07f95d2ba2d40277d010647a926df68.1622019402.git.public@yoctocell.xyz> <87tumphcey.fsf@nicolasgoaziou.fr> Date: Wed, 26 May 2021 16:07:55 +0200 Message-ID: <874kepy4ec.fsf@yoctocell.xyz> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" X-Spam-Score: 2.9 (++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: On Wed, May 26 2021, Nicolas Goaziou wrote: > Hello, > > Xinglu Chen writes: > >> * doc/guix.texi (package Reference): Describe how packages that lack a release >> or are pinned to an unreleased version should specify the [...] Content analysis details: (2.9 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 SPF_PASS SPF: sender matches SPF record 2.0 PDS_OTHER_BAD_TLD Untrustworthy TLDs [URI: yoctocell.xyz (xyz)] 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 0.5 FROM_SUSPICIOUS_NTLD From abused NTLD 0.4 RDNS_DYNAMIC Delivered to internal network by host with dynamic-looking rDNS X-Debbugs-Envelope-To: 48667 Cc: 48667@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 2.9 (++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: On Wed, May 26 2021, Nicolas Goaziou wrote: > Hello, > > Xinglu Chen writes: > >> * doc/guix.texi (package Reference): Describe how packages that lack a release >> or are pinned to an unreleased version should specify the [...] Content analysis details: (2.9 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 SPF_PASS SPF: sender matches SPF record 2.0 PDS_OTHER_BAD_TLD Untrustworthy TLDs [URI: yoctocell.xyz (xyz)] 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 0.5 FROM_SUSPICIOUS_NTLD From abused NTLD 1.0 BULK_RE_SUSP_NTLD Precedence bulk and RE: from a suspicious TLD 0.4 RDNS_DYNAMIC Delivered to internal network by host with dynamic-looking rDNS -1.0 MAILING_LIST_MULTI Multiple indicators imply a widely-seen list manager --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable On Wed, May 26 2021, Nicolas Goaziou wrote: > Hello, > > Xinglu Chen writes: > >> * doc/guix.texi (package Reference): Describe how packages that lack a r= elease >> or are pinned to an unreleased version should specify the =E2=80=98versi= on=E2=80=99 field. >> Add documentation for the =E2=80=98git-version=E2=80=99 procedure. > > Thanks.=20 > > I don't know if all should be included in the manual (though I think > the `git-version' function definitely should), but I'll comment it a bit > anyway. > >> @item @code{version} >> -The version of the package, as a string. >> +The version of the package, as a string. If there are no releases of >> +the package, or a unreleased version is desired, the version should >> +contain @code{VERSION-REVISION.COMMIT}. @code{VERSION} is >> +@c TODO: 0.0.0 or just 0 ? > > @samp{@var{VERSION}-@var{REVISION}.@var{COMMIT}} ... @var{VERSION}... > > I think you should drop the "version 0" case altogether. I don't think > enforcing "0" or "0.0.0" does matter, and it adds noise to the > explanations. Makes sense, users can probably that out on their own. >> +@code{0.0.0} or whatever the latest version is, and @code{REVISION} is >> +the revision of the Guix package (@code{0} if it is a new package), >> +whenever the package is updated to a newer version the revision should >> +also be bumped. > > @var{REVISION} > > I think you need to explain why bumping revision is needed. > > Also, this is all specific to hash-based repositories. For example, SVN > uses monotonic revisions already, so none of the above applies to such > packages. I am not familiar with SVN, but I will look into it. >> @code{COMMIT} is the @dfn{commit} or @dfn{changeset} >> +corresponding to the version, it should only contain 7 characters. If >> +the fetch method is @code{git-fetch} (@pxref{origin Reference}), there >> +is the @code{git-version} procedure that makes it easier to specify the >> +version. > > @var{COMMIT} > >> +@example >> +(git-version "0.0.0" "0" "93818c936ee7e2f1ba1b315578bde363a7d43d05") >> +@result{} "0.0.0-0.93818c9" >> +@end example >> +@end deffn > > Here too, I think the special "0.0.0" case is misleading. > > Maybe @lisp is more appropriate than @example. Good point. Thanks for the review! --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQJJBAEBCAAzFiEEAVhh4yyK5+SEykIzrPUJmaL7XHkFAmCuVjsVHHB1YmxpY0B5 b2N0b2NlbGwueHl6AAoJEKz1CZmi+1x5eYEP/2UKukDv1Nm9eUGuwdtU5Svs2ZPn f+K7LFpzuijRzCbPPxKrf0vy6QBhLHJDjR6kuUkfgsApj4Bhy5coDxTIvM31EN4S aoo8rMeIyQx6mtNjxBD5stRt7ABVmcnavVGS0hb6Jbkvddwkj5tB6k1cadnYf3TR QKkl+CSCGS2my7b4l9+2tFSw+AAkkTLJz9pYOjt63fZIlOH/R6lJZCXRfCuPBXrE FxiCoCSFnUmb0YRBTb/SKDolBM+DreTP4cUyU/ksMCPjC01vX6rEH2EU5RBMjZ5I lOZWrraLD2NCRR3s26G2Mke0X66n7usfOHG5bHtOp5WQY7vFaduxmMk0Optn21Ar HgZRdXaHtqQmdDZu00lP4+tseip+F1HQ7AeE7Aj3uh7ivXg79CexZ4J2dpiZ0bcc J+W8+74H10zboqnb07rc79yb4p/k2NU9FoSsL4S76ag+Rwhad8+2mSU0GDlZ83uG niJ2JkAk7XT5onRtvxLbs0Ns8KbprhCKqMZNj7gEdCakkPkQrA6L3qhPtBLQL8zo IcT90c6I9c9aI5K896hRyUBwAnRHkbNln8p5xEdnyxmCxc/amGn80ioStsoBaikh Ds0W/G6qFIkMyDu5430xGWTYNUUkb+0K4DJx5gN4KocjQng6dK2nNTCDhayk1ect 3puTS1I9r3YF0n02 =v8xw -----END PGP SIGNATURE----- --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Wed May 26 10:58:08 2021 Received: (at 48667) by debbugs.gnu.org; 26 May 2021 14:58:09 +0000 Received: from localhost ([127.0.0.1]:49731 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lluz2-0000eV-LF for submit@debbugs.gnu.org; Wed, 26 May 2021 10:58:08 -0400 Received: from h87-96-130-155.cust.a3fiber.se ([87.96.130.155]:55384 helo=mail.yoctocell.xyz) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lluyz-0000dx-MO for 48667@debbugs.gnu.org; Wed, 26 May 2021 10:58:06 -0400 From: Xinglu Chen DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=yoctocell.xyz; s=mail; t=1622041077; bh=ryvYajiLCaJfjws2LFHWPL+zSzcYfeaQ4lH/j/+AIy8=; h=From:To:Cc:Subject:In-Reply-To:References:Date; b=Gf1K+sZKDTSmX5Ljzr4ApU3VmVbCQfjH6GAdl9rBODzeyfAUUp7nBcK9JXDkeqQAm o9uYu21lGOTkLYkeQRpZ4Vn7vX/dKu28FCVVU0ttHieOG+AB4sHfFiQ47qYDqG7TDu +qGHzKQ6upifWlnbNcaeMcgG8Nwa/W8o7BrRkqqU= To: 48667@debbugs.gnu.org Subject: [PATCH] doc: Expound on how to specify the version of a package. In-Reply-To: <06217762b07f95d2ba2d40277d010647a926df68.1622019402.git.public@yoctocell.xyz> References: <06217762b07f95d2ba2d40277d010647a926df68.1622019402.git.public@yoctocell.xyz> Message-Id: <7a6a9bffa80fdfaa1e14015614cb638ff8cc7441.1622040691.git.public@yoctocell.xyz> Date: Wed, 26 May 2021 16:57:57 +0200 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 2.9 (++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: * doc/guix.texi (package Reference): Describe how packages that lack a release or are pinned to an unreleased version should specify the ‘version’ field. Add documentation for the ‘git-version†[...] Content analysis details: (2.9 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 SPF_PASS SPF: sender matches SPF record 2.0 PDS_OTHER_BAD_TLD Untrustworthy TLDs [URI: yoctocell.xyz (xyz)] 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 0.5 FROM_SUSPICIOUS_NTLD From abused NTLD 0.4 RDNS_DYNAMIC Delivered to internal network by host with dynamic-looking rDNS X-Debbugs-Envelope-To: 48667 Cc: Nicolas Goaziou X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 1.9 (+) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: * doc/guix.texi (package Reference): Describe how packages that lack a release or are pinned to an unreleased version should specify the ‘version’ field. Add documentation for the ‘git-version†[...] Content analysis details: (1.9 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 SPF_PASS SPF: sender matches SPF record 2.0 PDS_OTHER_BAD_TLD Untrustworthy TLDs [URI: yoctocell.xyz (xyz)] 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 0.5 FROM_SUSPICIOUS_NTLD From abused NTLD 0.4 RDNS_DYNAMIC Delivered to internal network by host with dynamic-looking rDNS -1.0 MAILING_LIST_MULTI Multiple indicators imply a widely-seen list manager * doc/guix.texi (package Reference): Describe how packages that lack a rele= ase or are pinned to an unreleased version should specify the =E2=80=98version= =E2=80=99 field. Add documentation for the =E2=80=98git-version=E2=80=99 procedure. --- Changes since v1: * Remove the case for =E2=80=9Cversion 0=E2=80=9D. * Use @var{} instead of @code{} when appropriate, and @lisp instead of @example. * Be more specific about what to set COMMIT to. Git/Mercurial and SVN/Bzr should be handled differently. doc/guix.texi | 26 +++++++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) diff --git a/doc/guix.texi b/doc/guix.texi index e8b0485f78..9338136ebe 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -89,6 +89,7 @@ Copyright @copyright{} 2020 Jonathan Brielmaier@* Copyright @copyright{} 2020 Edgar Vincent@* Copyright @copyright{} 2021 Maxime Devos@* Copyright @copyright{} 2021 B. Wilson@* +Copyright @copyright{} 2021 Xinglu Chen@* =20 Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or @@ -6651,7 +6652,21 @@ This is the data type representing a package recipe. The name of the package, as a string. =20 @item @code{version} -The version of the package, as a string. +The version of the package, as a string. If there are no releases of +the package, or a unreleased version is desired, the version should +contain @samp{@var{VERSION}-@var{REVISION}.@var{COMMIT}}. @var{VERSION} +is the version of the package, and @var{REVISION} is the revision of the +Guix package (@code{0} if it is a new package). Whenever the package is +updated to a newer version the revision should also be bumped to reflect +the fact that package has been updated. If the fetch method for the +package is @code{git-fetch} or @code{hg-fetch} (@pxref{origin +Reference}), @var{COMMIT} should be the @dfn{commit} or @dfn{changeset} +corresponding to the version, it should only contain 7 characters. If +the fetch method is @code{git-fetch}, there is the @code{git-version} +procedure (see below) that makes it easier to specify the version. +Packages which use @code{svn-fetch} or @code{bzr-fetch} should set +@var{COMMIT} to the same value as the @code{revision} field in +@code{svn-reference} or @code{bzr-reference}. =20 @item @code{source} An object telling how the source code for the package should be @@ -6757,6 +6772,15 @@ automatically corrected. @end table @end deftp =20 +@deffn {Scheme Procedure} git-version @var{VERSION} @var{REVISION} @var{CO= MMIT} +Return the version string for packages using @code{git-fetch}. + +@lisp +(git-version "0.2.3" "0" "93818c936ee7e2f1ba1b315578bde363a7d43d05") +@result{} "0.2.3-0.93818c9" +@end lisp +@end deffn + @deffn {Scheme Syntax} this-package When used in the @emph{lexical scope} of a package field definition, this identifier resolves to the package being defined. base-commit: 3f2a4b098039bd374c76d524223de3c6c475f23e --=20 2.31.1 From debbugs-submit-bounces@debbugs.gnu.org Sat Jun 05 16:29:15 2021 Received: (at 48667) by debbugs.gnu.org; 5 Jun 2021 20:29:15 +0000 Received: from localhost ([127.0.0.1]:50125 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lpcux-0007ll-Ak for submit@debbugs.gnu.org; Sat, 05 Jun 2021 16:29:15 -0400 Received: from eggs.gnu.org ([209.51.188.92]:58688) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lpcuv-0007lY-Ho for 48667@debbugs.gnu.org; Sat, 05 Jun 2021 16:29:14 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:57830) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lpcup-0004dr-4V; Sat, 05 Jun 2021 16:29:07 -0400 Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=53418 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lpcuo-0000yb-Rz; Sat, 05 Jun 2021 16:29:07 -0400 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Xinglu Chen Subject: Re: bug#48667: [PATCH] doc: Expound on how to specify the version of a package. References: <06217762b07f95d2ba2d40277d010647a926df68.1622019402.git.public@yoctocell.xyz> <7a6a9bffa80fdfaa1e14015614cb638ff8cc7441.1622040691.git.public@yoctocell.xyz> Date: Sat, 05 Jun 2021 22:29:05 +0200 In-Reply-To: <7a6a9bffa80fdfaa1e14015614cb638ff8cc7441.1622040691.git.public@yoctocell.xyz> (Xinglu Chen's message of "Wed, 26 May 2021 16:57:57 +0200") Message-ID: <87zgw4m4xa.fsf_-_@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.3 (/) X-Debbugs-Envelope-To: 48667 Cc: 48667@debbugs.gnu.org, Nicolas Goaziou X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.3 (-) Hi Xinglu, Xinglu Chen skribis: > * doc/guix.texi (package Reference): Describe how packages that lack a re= lease > or are pinned to an unreleased version should specify the =E2=80=98versio= n=E2=80=99 field. > Add documentation for the =E2=80=98git-version=E2=80=99 procedure. [...] > @item @code{version} > -The version of the package, as a string. > +The version of the package, as a string. If there are no releases of > +the package, or a unreleased version is desired, the version should > +contain @samp{@var{VERSION}-@var{REVISION}.@var{COMMIT}}. @var{VERSION} > +is the version of the package, and @var{REVISION} is the revision of the > +Guix package (@code{0} if it is a new package). Whenever the package is > +updated to a newer version the revision should also be bumped to reflect > +the fact that package has been updated. If the fetch method for the > +package is @code{git-fetch} or @code{hg-fetch} (@pxref{origin > +Reference}), @var{COMMIT} should be the @dfn{commit} or @dfn{changeset} > +corresponding to the version, it should only contain 7 characters. If > +the fetch method is @code{git-fetch}, there is the @code{git-version} > +procedure (see below) that makes it easier to specify the version. > +Packages which use @code{svn-fetch} or @code{bzr-fetch} should set > +@var{COMMIT} to the same value as the @code{revision} field in > +@code{svn-reference} or @code{bzr-reference}. The text LGTM, but I think =E2=80=9Cpackage Reference=E2=80=9D is the wrong= place for it: it=E2=80=99s the reference, whereas the text above is a guideline. The =E2=80=9CVersion Numbers=E2=80=9D section under =E2=80=9CPackaging Guid= elines=E2=80=9D already touches this topic. Perhaps we need to expand it and/or link to it from =E2=80=9Cpackage Reference=E2=80=9D, like: @item @code{version} The version of the package, as a string. @xref{Version Numbers}, for guidelines. The =E2=80=98git-version=E2=80=99 procedure could be documented in =E2=80= =9CVersion Numbers=E2=80=9D too. WDYT? Thanks, Ludo=E2=80=99. From debbugs-submit-bounces@debbugs.gnu.org Sun Jun 06 05:10:07 2021 Received: (at 48667) by debbugs.gnu.org; 6 Jun 2021 09:10:07 +0000 Received: from localhost ([127.0.0.1]:50622 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lponH-0005JJ-5v for submit@debbugs.gnu.org; Sun, 06 Jun 2021 05:10:07 -0400 Received: from h87-96-130-155.cust.a3fiber.se ([87.96.130.155]:50404 helo=mail.yoctocell.xyz) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lponE-0005Ii-7h for 48667@debbugs.gnu.org; Sun, 06 Jun 2021 05:10:06 -0400 From: Xinglu Chen DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=yoctocell.xyz; s=mail; t=1622970598; bh=gYEhflAgoxGOgWY7+uPaXvuqCcUKZxOTYGb+GG4YDyw=; h=From:To:Cc:Subject:In-Reply-To:References:Date; b=QJf7HwU6oVWS4kLhgvubrmkPftaxF0C4df202Yxjes2zSHbcujHO8X7ik28Ac8SYR YFRhWdC/E/speo1RaKg7vjpwIVUJmL0fE+O819z0VZq4XG/9sslXiFT/6U5E3f6Yr+ GE9fNMaAPoZu2i+Jm+fkxwMiX4AsaVQ0KUKYEHtU= To: Ludovic =?utf-8?Q?Court=C3=A8s?= Subject: Re: [bug#48667] [PATCH] doc: Expound on how to specify the version of a package. In-Reply-To: <87zgw4m4xa.fsf_-_@gnu.org> References: <06217762b07f95d2ba2d40277d010647a926df68.1622019402.git.public@yoctocell.xyz> <7a6a9bffa80fdfaa1e14015614cb638ff8cc7441.1622040691.git.public@yoctocell.xyz> <87zgw4m4xa.fsf_-_@gnu.org> Date: Sun, 06 Jun 2021 11:09:54 +0200 Message-ID: <87k0n7740t.fsf@yoctocell.xyz> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" X-Spam-Score: 2.9 (++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: On Sat, Jun 05 2021, Ludovic Courtès wrote: > Hi Xinglu, > > Xinglu Chen skribis: > >> * doc/guix.texi (package Reference): Describe how packages that lack a release >> or are pinned to an unreleased version should specif [...] Content analysis details: (2.9 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 2.0 PDS_OTHER_BAD_TLD Untrustworthy TLDs [URI: yoctocell.xyz (xyz)] -0.0 SPF_PASS SPF: sender matches SPF record 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 0.4 RDNS_DYNAMIC Delivered to internal network by host with dynamic-looking rDNS 0.5 FROM_SUSPICIOUS_NTLD From abused NTLD X-Debbugs-Envelope-To: 48667 Cc: 48667@debbugs.gnu.org, Nicolas Goaziou X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 2.9 (++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: On Sat, Jun 05 2021, Ludovic Courtès wrote: > Hi Xinglu, > > Xinglu Chen skribis: > >> * doc/guix.texi (package Reference): Describe how packages that lack a release >> or are pinned to an unreleased version should specif [...] Content analysis details: (2.9 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 2.0 PDS_OTHER_BAD_TLD Untrustworthy TLDs [URI: yoctocell.xyz (xyz)] -0.0 SPF_PASS SPF: sender matches SPF record 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 0.4 RDNS_DYNAMIC Delivered to internal network by host with dynamic-looking rDNS 0.5 FROM_SUSPICIOUS_NTLD From abused NTLD 1.0 BULK_RE_SUSP_NTLD Precedence bulk and RE: from a suspicious TLD -1.0 MAILING_LIST_MULTI Multiple indicators imply a widely-seen list manager --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable On Sat, Jun 05 2021, Ludovic Court=C3=A8s wrote: > Hi Xinglu, > > Xinglu Chen skribis: > >> * doc/guix.texi (package Reference): Describe how packages that lack a r= elease >> or are pinned to an unreleased version should specify the =E2=80=98versi= on=E2=80=99 field. >> Add documentation for the =E2=80=98git-version=E2=80=99 procedure. > > [...] > >> @item @code{version} >> -The version of the package, as a string. >> +The version of the package, as a string. If there are no releases of >> +the package, or a unreleased version is desired, the version should >> +contain @samp{@var{VERSION}-@var{REVISION}.@var{COMMIT}}. @var{VERSION} >> +is the version of the package, and @var{REVISION} is the revision of the >> +Guix package (@code{0} if it is a new package). Whenever the package is >> +updated to a newer version the revision should also be bumped to reflect >> +the fact that package has been updated. If the fetch method for the >> +package is @code{git-fetch} or @code{hg-fetch} (@pxref{origin >> +Reference}), @var{COMMIT} should be the @dfn{commit} or @dfn{changeset} >> +corresponding to the version, it should only contain 7 characters. If >> +the fetch method is @code{git-fetch}, there is the @code{git-version} >> +procedure (see below) that makes it easier to specify the version. >> +Packages which use @code{svn-fetch} or @code{bzr-fetch} should set >> +@var{COMMIT} to the same value as the @code{revision} field in >> +@code{svn-reference} or @code{bzr-reference}. > > The text LGTM, but I think =E2=80=9Cpackage Reference=E2=80=9D is the wro= ng place for > it: it=E2=80=99s the reference, whereas the text above is a guideline. > > The =E2=80=9CVersion Numbers=E2=80=9D section under =E2=80=9CPackaging Gu= idelines=E2=80=9D already > touches this topic. Perhaps we need to expand it and/or link to it from > =E2=80=9Cpackage Reference=E2=80=9D, like: > > @item @code{version} > The version of the package, as a string. @xref{Version Numbers}, for > guidelines. > > The =E2=80=98git-version=E2=80=99 procedure could be documented in =E2=80= =9CVersion Numbers=E2=80=9D > too. > > WDYT? Ah, I totally missed the =E2=80=9CVersion Numbers=E2=80=9D section, it look= s like it already all the information I was looking for. Since =E2=80=98hg-version= =E2=80=99 was just added, I will mention it as well. :) --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQJJBAEBCAAzFiEEAVhh4yyK5+SEykIzrPUJmaL7XHkFAmC8kOIVHHB1YmxpY0B5 b2N0b2NlbGwueHl6AAoJEKz1CZmi+1x5a6gP/0xysgVvTA5TMM+lO+FWAv/Ost20 64XJgJRhtmay5ba/hDG1p2VvWYQk2BvwS6dnvQKPs2fG9gAEwxUOqPcCyS3pZkaf nOY3hZyXAvJDppjLBfKhClvcpIDItukHpdTZW5oCxd0y61huL7j2VpPkMBoNvwso 6U2pvW82LvK7/j73N5/KLnVxtHpmCUBXHV4qZHaE4FssjpMru08u6zSmQTdo/ZSU xo2PQJ8APyr/t4cAdfJbKN3GHyjN70ay/TixzWbglCUPTvAMuijHU0Rh937Iq0yv dkxLm+1lv4yaC3OiAnPrPfZXfOqw/fsY6zhDxpHHPPQwvgp4xLpbQ2gZsw22X8m8 ZuIZ1gvCdrQL7BmtS0vHFOVjy4X8FsPiz3CxDC5TU4kkRu+L8sYQRjf/vmVqnUMX A3pxw9F+AUVM077v5o7l+UD6UsfnMnyB5k6E+PARpz/DefVeJURmQVNCUIWVZuR+ MGx0BdipaPe9NVWfmnQhO9FiAjHZ/v9gq8hEHa5Z6RnfNnbP2C6AWxgJd3h8PndP Kqnsxk/scI2GHzBpYVqsvPH37shwuzlvNhR6SxcL/OgZT9WL5SkVd5z7MjQPs9ID 41cmZgaBtT1mv1RFsjS0OGp0+wvFHW5W+pR1qdDJ6+u8IPyYUeoFXUQ0QGlrrlk1 tqH78sLr+Jt1cOW2 =oX+S -----END PGP SIGNATURE----- --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Sun Jun 06 05:19:45 2021 Received: (at 48667) by debbugs.gnu.org; 6 Jun 2021 09:19:46 +0000 Received: from localhost ([127.0.0.1]:50652 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lpowb-0005Yf-Kt for submit@debbugs.gnu.org; Sun, 06 Jun 2021 05:19:45 -0400 Received: from h87-96-130-155.cust.a3fiber.se ([87.96.130.155]:50614 helo=mail.yoctocell.xyz) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lpowZ-0005YS-FG for 48667@debbugs.gnu.org; Sun, 06 Jun 2021 05:19:43 -0400 From: Xinglu Chen DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=yoctocell.xyz; s=mail; t=1622971177; bh=i91TOKKaLLOjgBVdXAtU4eAIfrA2ZplDCbgUfR2ngh8=; h=From:To:Cc:Subject:In-Reply-To:References:Date; b=n9r1/OaaLVc5NaAFftrVjtaf2ZjX+wkP0YE6724L53vlW2qeT3kBkZ1cce7gnrAYE 4ImyOQ5LC2P7RkSjdwZ3hsnPR8XTQOfhy48DiZ221fPf/BLX7e0F6fEZl8T14dKjmT 34E82/VH0IxHaO5UObuvQGAhesDruIrf+SgHBJlo= To: 48667@debbugs.gnu.org Subject: [PATCH] =?UTF-8?q?doc:=20Add=20reference=20for=20=E2=80=98git-ver?= In-Reply-To: <87zgw4m4xa.fsf_-_@gnu.org> References: <87zgw4m4xa.fsf_-_@gnu.org> Message-Id: <539a1a894dbbe25d5370b7bfb11006f736cbc875.1622971088.git.public@yoctocell.xyz> Date: Sun, 06 Jun 2021 11:19:37 +0200 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 2.9 (++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: * doc/contributing.texi (Version Numbers): Document ‘git-version’ and ‘hg-version’. * doc/guix.texi (package Reference): Reference ‘Version Numbers’ section for version naming guidelines. [...] Content analysis details: (2.9 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 2.0 PDS_OTHER_BAD_TLD Untrustworthy TLDs [URI: yoctocell.xyz (xyz)] -0.0 SPF_PASS SPF: sender matches SPF record 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 0.4 RDNS_DYNAMIC Delivered to internal network by host with dynamic-looking rDNS 0.5 FROM_SUSPICIOUS_NTLD From abused NTLD X-Debbugs-Envelope-To: 48667 Cc: Ludovic =?utf-8?Q?Court=C3=A8s?= X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 1.9 (+) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: * doc/contributing.texi (Version Numbers): Document ‘git-version’ and ‘hg-version’. * doc/guix.texi (package Reference): Reference ‘Version Numbers’ section for version naming guidelines. [...] Content analysis details: (1.9 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 2.0 PDS_OTHER_BAD_TLD Untrustworthy TLDs [URI: yoctocell.xyz (xyz)] -0.0 SPF_PASS SPF: sender matches SPF record 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 0.4 RDNS_DYNAMIC Delivered to internal network by host with dynamic-looking rDNS 0.5 FROM_SUSPICIOUS_NTLD From abused NTLD -1.0 MAILING_LIST_MULTI Multiple indicators imply a widely-seen list manager * doc/contributing.texi (Version Numbers): Document =E2=80=98git-version=E2= =80=99 and =E2=80=98hg-version=E2=80=99. * doc/guix.texi (package Reference): Reference =E2=80=98Version Numbers=E2= =80=99 section for version naming guidelines. --- doc/contributing.texi | 22 +++++++++++++++++++--- doc/guix.texi | 4 +++- 2 files changed, 22 insertions(+), 4 deletions(-) diff --git a/doc/contributing.texi b/doc/contributing.texi index 87719a4bbe..ee6cb97c8d 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -532,9 +532,11 @@ It is a good idea to strip commit identifiers in the @= code{version} field to, say, 7 digits. It avoids an aesthetic annoyance (assuming aesthetics have a role to play here) as well as problems related to OS limits such as the maximum shebang length (127 bytes for the Linux -kernel). It is best to use the full commit identifiers in -@code{origin}s, though, to avoid ambiguities. A typical package -definition may look like this: +kernel). There are helper functions for doing this for packages using +@code{git-fetch} or @code{hg-fetch} (see below). It is best to use the +full commit identifiers in @code{origin}s, though, to avoid ambiguities. +A typical package definition may look like this: + =20 @lisp (define my-package @@ -553,6 +555,20 @@ definition may look like this: ))) @end lisp =20 +@deffn {Scheme Procedure} git-version @var{VERSION} @var{REVISION} @var{CO= MMIT} +Return the version string for packages using @code{git-fetch}. + +@lisp +(git-version "0.2.3" "0" "93818c936ee7e2f1ba1b315578bde363a7d43d05") +@result{} "0.2.3-0.93818c9" +@end lisp +@end deffn + +@deffn {Scheme Procedure} hg-version @var{VERSION} @var{REVISION} @var{CHA= NGESET} +Return the version string for packages using @code{hg-fetch}. It works +in the same was @code{git-version} +@end deffn + @node Synopses and Descriptions @subsection Synopses and Descriptions =20 diff --git a/doc/guix.texi b/doc/guix.texi index eb64518a95..e71ec70859 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -89,6 +89,7 @@ Copyright @copyright{} 2020 Jonathan Brielmaier@* Copyright @copyright{} 2020 Edgar Vincent@* Copyright @copyright{} 2021 Maxime Devos@* Copyright @copyright{} 2021 B. Wilson@* +Copyright @copyright{} 2021 Xinglu Chen@* =20 Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or @@ -6657,7 +6658,8 @@ This is the data type representing a package recipe. The name of the package, as a string. =20 @item @code{version} -The version of the package, as a string. +The version of the package, as a string. @xref{Version Numbers}, for +guidelines. =20 @item @code{source} An object telling how the source code for the package should be base-commit: 9caf7112ee50af26fbc4c1bd3c337f1f86b710af --=20 2.31.1 From debbugs-submit-bounces@debbugs.gnu.org Sun Jun 06 05:48:41 2021 Received: (at 48667) by debbugs.gnu.org; 6 Jun 2021 09:48:41 +0000 Received: from localhost ([127.0.0.1]:50681 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lppOb-0008Tj-Ap for submit@debbugs.gnu.org; Sun, 06 Jun 2021 05:48:41 -0400 Received: from albert.telenet-ops.be ([195.130.137.90]:59200) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lppOX-0008TY-CN for 48667@debbugs.gnu.org; Sun, 06 Jun 2021 05:48:39 -0400 Received: from [172.20.10.4] ([188.188.136.113]) by albert.telenet-ops.be with bizsmtp id DloY2500U2SyTPg06loZrp; Sun, 06 Jun 2021 11:48:35 +0200 Message-ID: <990f6b1bf7bcd9e78f212b8615e0201c48a81b2f.camel@telenet.be> Subject: Re: [bug#48667] [PATCH] doc: Add reference for =?UTF-8?Q?=E2=80=98git-ver?= From: Maxime Devos To: Xinglu Chen , 48667@debbugs.gnu.org Date: Sun, 06 Jun 2021 11:48:25 +0200 In-Reply-To: <539a1a894dbbe25d5370b7bfb11006f736cbc875.1622971088.git.public@yoctocell.xyz> References: <87zgw4m4xa.fsf_-_@gnu.org> <539a1a894dbbe25d5370b7bfb11006f736cbc875.1622971088.git.public@yoctocell.xyz> Content-Type: multipart/signed; micalg="pgp-sha512"; protocol="application/pgp-signature"; boundary="=-IG3C0Lte1HYO2/Kfve4h" User-Agent: Evolution 3.34.2 MIME-Version: 1.0 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=telenet.be; s=r21; t=1622972915; bh=jvLdFyl55gUrnmK8pHVeftZ8jDu3tQa2ZBDxqh4Z00w=; h=Subject:From:To:Cc:Date:In-Reply-To:References; b=thxlGHce5s+lkWdUTrId8d0vmegbPc1Jg/Wn21Dq9f77a+AJtdZWDAF1mxn0qLaY0 6mFoCZ5MSSEbqX7yH/iFipba29jyE0fHaY+T7A5SokLD+XH/aWT5ki14BgFrKpjBlq tyD3FiKR9UpZpBd1xRjjSFSoxvHLORrCP/lhDGLv3CzDvQL/Ujym1RvpFSu6w14q22 UpJ+7XM1loq9RUxnUNxZjs1QwvvrZ0IWPeylcmpxUfSKkKqZ7bW8WtJ6SnSsNz9p56 Xi7bq5+dVdkk1+dTYIcR4HFVbqUcHFhi+bAxITSeO+WM02N6GxKg7Riw6qj0UUFPnG NJzu5XTNxC1pA== X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 48667 Cc: Ludovic =?ISO-8859-1?Q?Court=E8s?= X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) --=-IG3C0Lte1HYO2/Kfve4h Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Xinglu Chen schreef op zo 06-06-2021 om 11:19 [+0200]: > +@deffn {Scheme Procedure} git-version @var{VERSION} @var{REVISION} @var{= COMMIT} > +Return the version string for packages using @code{git-fetch}. > + > +@lisp > +(git-version "0.2.3" "0" "93818c936ee7e2f1ba1b315578bde363a7d43d05") > +@result{} "0.2.3-0.93818c9" > +@end lisp > +@end deffn > + > +@deffn {Scheme Procedure} hg-version @var{VERSION} @var{REVISION} @var{C= HANGESET} > +Return the version string for packages using @code{hg-fetch}. It works > +in the same was @code{git-version} > +@end deffn Linguistic nitpick: about =E2=80=98It works in the same was @code{git-versi= on}=E2=80=99: =E2=80=98in the same was=E2=80=99 seems ungrammatical to me. Should this have been something like It works in the same way as @code{git-version}. ? (Remember to include the period.) LGTM otherwise. Greetings, Maxime. --=-IG3C0Lte1HYO2/Kfve4h Content-Type: application/pgp-signature; name="signature.asc" Content-Description: This is a digitally signed message part Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- iI0EABYKADUWIQTB8z7iDFKP233XAR9J4+4iGRcl7gUCYLyZ6RccbWF4aW1lZGV2 b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7neLAP9Z7/9lcMLFTeSV6pBOIRXPQjXg QFJR/LLJyl6PjBxonwEAyAdYFrwPTNtBRIiKBgWXx/no6O54G8gQq9aKiW71VQ4= =AAII -----END PGP SIGNATURE----- --=-IG3C0Lte1HYO2/Kfve4h-- From debbugs-submit-bounces@debbugs.gnu.org Sun Jun 06 06:33:56 2021 Received: (at 48667) by debbugs.gnu.org; 6 Jun 2021 10:33:56 +0000 Received: from localhost ([127.0.0.1]:50730 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lpq6O-0001KZ-H1 for submit@debbugs.gnu.org; Sun, 06 Jun 2021 06:33:56 -0400 Received: from h87-96-130-155.cust.a3fiber.se ([87.96.130.155]:52294 helo=mail.yoctocell.xyz) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lpq6L-0001KM-ED for 48667@debbugs.gnu.org; Sun, 06 Jun 2021 06:33:55 -0400 From: Xinglu Chen DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=yoctocell.xyz; s=mail; t=1622975627; bh=jegeHpKBTT7sIXM3MAuN9Upy0uGcq+8/UZ02skbIO2I=; h=From:To:Cc:Subject:In-Reply-To:References:Date; b=UOGgSoPa8IYBBWxpQh7KvX09XdtD7Q+F/r50h629JzaKb58aRQKXMcYHCOhCYKoP9 WD7PTgwppJeEhpTM63SjqoU4aL+6IjvD6Lntp5skLvRAnr8G1MriicekIVZCnQvvN1 e9sZqQ3VTpDFmmJwSUZDrGT8Sm43AuD34Ew0tqHo= To: Maxime Devos , 48667@debbugs.gnu.org Subject: Re: [bug#48667] [PATCH] doc: Add reference for =?utf-8?Q?=E2=80=98git-ver?= In-Reply-To: <990f6b1bf7bcd9e78f212b8615e0201c48a81b2f.camel@telenet.be> References: <87zgw4m4xa.fsf_-_@gnu.org> <539a1a894dbbe25d5370b7bfb11006f736cbc875.1622971088.git.public@yoctocell.xyz> <990f6b1bf7bcd9e78f212b8615e0201c48a81b2f.camel@telenet.be> Date: Sun, 06 Jun 2021 12:33:45 +0200 Message-ID: <875yyr7052.fsf@yoctocell.xyz> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" X-Spam-Score: 2.9 (++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: On Sun, Jun 06 2021, Maxime Devos wrote: > Xinglu Chen schreef op zo 06-06-2021 om 11:19 [+0200]: >> +@deffn {Scheme Procedure} git-version @var{VERSION} @var{REVISION} @var{COMMIT} >> +Return the version string for packages using @code{git- [...] Content analysis details: (2.9 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 2.0 PDS_OTHER_BAD_TLD Untrustworthy TLDs [URI: yoctocell.xyz (xyz)] -0.0 SPF_PASS SPF: sender matches SPF record 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 0.4 RDNS_DYNAMIC Delivered to internal network by host with dynamic-looking rDNS 0.5 FROM_SUSPICIOUS_NTLD From abused NTLD X-Debbugs-Envelope-To: 48667 Cc: Ludovic =?utf-8?Q?Court=C3=A8s?= X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 2.9 (++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: On Sun, Jun 06 2021, Maxime Devos wrote: > Xinglu Chen schreef op zo 06-06-2021 om 11:19 [+0200]: >> +@deffn {Scheme Procedure} git-version @var{VERSION} @var{REVISION} @var{COMMIT} >> +Return the version string for packages using @code{git- [...] Content analysis details: (2.9 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 2.0 PDS_OTHER_BAD_TLD Untrustworthy TLDs [URI: yoctocell.xyz (xyz)] -0.0 SPF_PASS SPF: sender matches SPF record 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 0.4 RDNS_DYNAMIC Delivered to internal network by host with dynamic-looking rDNS 0.5 FROM_SUSPICIOUS_NTLD From abused NTLD 1.0 BULK_RE_SUSP_NTLD Precedence bulk and RE: from a suspicious TLD -1.0 MAILING_LIST_MULTI Multiple indicators imply a widely-seen list manager --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable On Sun, Jun 06 2021, Maxime Devos wrote: > Xinglu Chen schreef op zo 06-06-2021 om 11:19 [+0200]: >> +@deffn {Scheme Procedure} git-version @var{VERSION} @var{REVISION} @var= {COMMIT} >> +Return the version string for packages using @code{git-fetch}. >> + >> +@lisp >> +(git-version "0.2.3" "0" "93818c936ee7e2f1ba1b315578bde363a7d43d05") >> +@result{} "0.2.3-0.93818c9" >> +@end lisp >> +@end deffn >> + >> +@deffn {Scheme Procedure} hg-version @var{VERSION} @var{REVISION} @var{= CHANGESET} >> +Return the version string for packages using @code{hg-fetch}. It works >> +in the same was @code{git-version} >> +@end deffn > > Linguistic nitpick: about =E2=80=98It works in the same was @code{git-ver= sion}=E2=80=99: =E2=80=98in the same was=E2=80=99 > seems ungrammatical to me. Should this have been something like > > It works in the same way as @code{git-version}. > > ? (Remember to include the period.) Indeed, I must have made a silly typo. --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQJJBAEBCAAzFiEEAVhh4yyK5+SEykIzrPUJmaL7XHkFAmC8pIkVHHB1YmxpY0B5 b2N0b2NlbGwueHl6AAoJEKz1CZmi+1x5yIMQAKsGahMzkw20IgkLS6Ysr8rbYz6P +3bRLHEGUCao7cx2KDZCAaaNRldVqhqTEkBZ0+AGvPGwQsIRtKKBcCQAFt/0MoKZ NNN/1Vo5XDM/WgC7RhiG/uvTJDNXl1jbA6Esvi5OXEAXuW7kQ36VFwoLj5VpWSVj S0TvR+PNmEsgXxE9t2MO2zUt/TlEzsmfuavCnapeNkF+DH+Pylc+Ycd6tvFI5yC0 kaWrT69kpZHYzzTMJGfcYxS33E0TtacDxfhjpAIkhz3k9A3cWovEsUO4BZhQtcXe QGayB1Oa4/LJNH0OtIEk3KzjeyDJ/cCtGI6Svb43QJPm0eDzSWU3rUSkwb1cR6bK 49tcmSCvfMQnSvwNIGMekViUxf1PgYXEZ7o4wqExFRgFCCyNKMZ2rU9YdyfKMFqv lCba+PE1deRlkgDpnQVJdMJjNljs/95CGYCLZjfFW6JBEVBg+zwaTlSsJdZhK3ca N/aYbbB2i0lzk0eed6//CxiZhLSDgkADOL8RjPaps3VyoENgrenmQ/LitLx05yuU SWdLP20ktUF62KigOkeRduJ08Ikgi2K1SrBq8OhuDdtihApgp5YMvRwcTo2CcuML 7mh41xZOFbIAXynqiIWZ9cUe65kur2Yp84Yx/sMHNLk+lnpFhuzOE8yzggVeQdEp wo3a23UAKc33pcOh =GR/1 -----END PGP SIGNATURE----- --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Sun Jun 06 06:37:31 2021 Received: (at 48667) by debbugs.gnu.org; 6 Jun 2021 10:37:31 +0000 Received: from localhost ([127.0.0.1]:50746 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lpq9r-0001RQ-CW for submit@debbugs.gnu.org; Sun, 06 Jun 2021 06:37:31 -0400 Received: from h87-96-130-155.cust.a3fiber.se ([87.96.130.155]:52376 helo=mail.yoctocell.xyz) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lpq9p-0001R9-9f for 48667@debbugs.gnu.org; Sun, 06 Jun 2021 06:37:29 -0400 From: Xinglu Chen DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=yoctocell.xyz; s=mail; t=1622975843; bh=e0UaE9yZrubujgO+6CLa62SrnCX2m4J+U04IoY8K3SA=; h=From:To:Cc:Subject:In-Reply-To:References:Date; b=vRL+BVg2im9xO0sALSJD7u48Lmtd17bmLAcjRlsmnZs/Q1UVg08zxYoCjGvslRSgr MvcJrlEE8tVg93Lo4yWDggEc707BueDZkRCpiiorZ+YpkjaPBUHX9fyE4WfgX+fGTL PKjGwvRVnyuMrXzzhJ0S9OAEeLys100pS6Qz+4o4= To: 48667@debbugs.gnu.org Subject: [PATCH v2] doc: Add refernece for =?utf-8?Q?=E2=80=98git-version?= =?utf-8?Q?=E2=80=99?= and =?utf-8?Q?=E2=80=98hg-version=E2=80=99=2E?= In-Reply-To: <539a1a894dbbe25d5370b7bfb11006f736cbc875.1622971088.git.public@yoctocell.xyz> References: <539a1a894dbbe25d5370b7bfb11006f736cbc875.1622971088.git.public@yoctocell.xyz> Message-Id: <7354a84803acc09bb64feb8b94519b9e5093d050.1622975743.git.public@yoctocell.xyz> Date: Sun, 06 Jun 2021 12:37:23 +0200 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 2.9 (++) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: * doc/contributing.texi (Version Numbers): Document ‘git-version’ and ‘hg-version’. * doc/guix.texi (package Reference): Reference ‘Version Numbers’ section for version naming guidelines. [...] Content analysis details: (2.9 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 2.0 PDS_OTHER_BAD_TLD Untrustworthy TLDs [URI: yoctocell.xyz (xyz)] -0.0 SPF_PASS SPF: sender matches SPF record 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 0.4 RDNS_DYNAMIC Delivered to internal network by host with dynamic-looking rDNS 0.5 FROM_SUSPICIOUS_NTLD From abused NTLD X-Debbugs-Envelope-To: 48667 Cc: Ludovic =?utf-8?Q?Court=C3=A8s?= , Maxime Devos X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 1.9 (+) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: * doc/contributing.texi (Version Numbers): Document ‘git-version’ and ‘hg-version’. * doc/guix.texi (package Reference): Reference ‘Version Numbers’ section for version naming guidelines. [...] Content analysis details: (1.9 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 2.0 PDS_OTHER_BAD_TLD Untrustworthy TLDs [URI: yoctocell.xyz (xyz)] -0.0 SPF_PASS SPF: sender matches SPF record 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 0.4 RDNS_DYNAMIC Delivered to internal network by host with dynamic-looking rDNS 0.5 FROM_SUSPICIOUS_NTLD From abused NTLD -1.0 MAILING_LIST_MULTI Multiple indicators imply a widely-seen list manager * doc/contributing.texi (Version Numbers): Document =E2=80=98git-version=E2= =80=99 and =E2=80=98hg-version=E2=80=99. * doc/guix.texi (package Reference): Reference =E2=80=98Version Numbers=E2= =80=99 section for version naming guidelines. --- Changes since v2: * Fix typos doc/contributing.texi | 22 +++++++++++++++++++--- doc/guix.texi | 4 +++- 2 files changed, 22 insertions(+), 4 deletions(-) diff --git a/doc/contributing.texi b/doc/contributing.texi index 87719a4bbe..3e2a9c8d2f 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -532,9 +532,11 @@ It is a good idea to strip commit identifiers in the @= code{version} field to, say, 7 digits. It avoids an aesthetic annoyance (assuming aesthetics have a role to play here) as well as problems related to OS limits such as the maximum shebang length (127 bytes for the Linux -kernel). It is best to use the full commit identifiers in -@code{origin}s, though, to avoid ambiguities. A typical package -definition may look like this: +kernel). There are helper functions for doing this for packages using +@code{git-fetch} or @code{hg-fetch} (see below). It is best to use the +full commit identifiers in @code{origin}s, though, to avoid ambiguities. +A typical package definition may look like this: + =20 @lisp (define my-package @@ -553,6 +555,20 @@ definition may look like this: ))) @end lisp =20 +@deffn {Scheme Procedure} git-version @var{VERSION} @var{REVISION} @var{CO= MMIT} +Return the version string for packages using @code{git-fetch}. + +@lisp +(git-version "0.2.3" "0" "93818c936ee7e2f1ba1b315578bde363a7d43d05") +@result{} "0.2.3-0.93818c9" +@end lisp +@end deffn + +@deffn {Scheme Procedure} hg-version @var{VERSION} @var{REVISION} @var{CHA= NGESET} +Return the version string for packages using @code{hg-fetch}. It works +in the same way as @code{git-version}. +@end deffn + @node Synopses and Descriptions @subsection Synopses and Descriptions =20 diff --git a/doc/guix.texi b/doc/guix.texi index eb64518a95..e71ec70859 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -89,6 +89,7 @@ Copyright @copyright{} 2020 Jonathan Brielmaier@* Copyright @copyright{} 2020 Edgar Vincent@* Copyright @copyright{} 2021 Maxime Devos@* Copyright @copyright{} 2021 B. Wilson@* +Copyright @copyright{} 2021 Xinglu Chen@* =20 Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or @@ -6657,7 +6658,8 @@ This is the data type representing a package recipe. The name of the package, as a string. =20 @item @code{version} -The version of the package, as a string. +The version of the package, as a string. @xref{Version Numbers}, for +guidelines. =20 @item @code{source} An object telling how the source code for the package should be base-commit: 9caf7112ee50af26fbc4c1bd3c337f1f86b710af --=20 2.31.1 From debbugs-submit-bounces@debbugs.gnu.org Sun Jun 06 08:36:54 2021 Received: (at 48667-done) by debbugs.gnu.org; 6 Jun 2021 12:36:54 +0000 Received: from localhost ([127.0.0.1]:50939 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lps1N-0004uf-UY for submit@debbugs.gnu.org; Sun, 06 Jun 2021 08:36:54 -0400 Received: from eggs.gnu.org ([209.51.188.92]:39206) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lps1L-0004uS-Qs for 48667-done@debbugs.gnu.org; Sun, 06 Jun 2021 08:36:52 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:50000) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lps1F-0007S9-Q5; Sun, 06 Jun 2021 08:36:45 -0400 Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=56330 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lps1F-0002a9-81; Sun, 06 Jun 2021 08:36:45 -0400 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Xinglu Chen Subject: Re: [PATCH v2] doc: Add refernece for =?utf-8?Q?=E2=80=98git-vers?= =?utf-8?Q?ion=E2=80=99?= and =?utf-8?Q?=E2=80=98hg-version=E2=80=99=2E?= References: <539a1a894dbbe25d5370b7bfb11006f736cbc875.1622971088.git.public@yoctocell.xyz> <7354a84803acc09bb64feb8b94519b9e5093d050.1622975743.git.public@yoctocell.xyz> X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 18 Prairial an 229 de la =?utf-8?Q?R=C3=A9volution?= X-PGP-Key-ID: 0x090B11993D9AEBB5 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 3CE4 6455 8A84 FDC6 9DB4 0CFB 090B 1199 3D9A EBB5 X-OS: x86_64-pc-linux-gnu Date: Sun, 06 Jun 2021 14:36:43 +0200 In-Reply-To: <7354a84803acc09bb64feb8b94519b9e5093d050.1622975743.git.public@yoctocell.xyz> (Xinglu Chen's message of "Sun, 06 Jun 2021 12:37:23 +0200") Message-ID: <87czszkw4k.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.3 (/) X-Debbugs-Envelope-To: 48667-done Cc: 48667-done@debbugs.gnu.org, Maxime Devos X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.3 (-) Hi, Xinglu Chen skribis: > * doc/contributing.texi (Version Numbers): Document =E2=80=98git-version= =E2=80=99 and > =E2=80=98hg-version=E2=80=99. > * doc/guix.texi (package Reference): Reference =E2=80=98Version Numbers= =E2=80=99 section for > version naming guidelines. Applied; thanks to the two of you! Ludo=E2=80=99. From unknown Fri Jun 20 07:12:14 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Mon, 05 Jul 2021 11:24:08 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator