From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms1.migadu.com with LMTPS id 4KosEb2SQGaCUwAAqHPOHw:P1 (envelope-from ) for ; Sun, 12 May 2024 11:58:21 +0200 Received: from aspmx1.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0.migadu.com with LMTPS id 4KosEb2SQGaCUwAAqHPOHw (envelope-from ) for ; Sun, 12 May 2024 11:58:21 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=wolfsden.cz header.s=mail header.b=DJ1ar5nt; dkim=fail ("headers rsa verify failed") header.d=wolfsden.cz header.s=mail header.b="X4/mxdtc"; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=fail reason="SPF not aligned (relaxed)" header.from=wolfsden.cz (policy=none) ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1715507901; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=tpAvJFpBO5Fm2etMHrZOdgH9G6TaXapAy3IpkK0apeI=; b=YIPBRYBP2ohJrvudw28XbtdEb+3xTTM8tivINBEBPe+OzEs+rAhHZ0MsoXq1QdmH6uX3WG fHe+Fym1u1oeqGcmbfXffs7Qo+S7McAmAj3uZYPsbsCvUVesrGQxpHomtOVg/1RDYV78NA 6LcnN2LqCG2M1oQfQn6X/ApKQQejp2jNL+doRcEfvGShIsOsy2wVIEajtBObppOajzTDct 3fsHDtda9BMtiu1cCqLzqJZMTUZGLjUl3JhRLitUTD7zDCS0IQjGeT1z6k5CEKpa0kQ06r hJhaucWcPDT0Nz3XoxulNLA4n9RkqTkoixwSixaZgE1XQHmpwrRWTDSKEsbqlA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=wolfsden.cz header.s=mail header.b=DJ1ar5nt; dkim=fail ("headers rsa verify failed") header.d=wolfsden.cz header.s=mail header.b="X4/mxdtc"; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=fail reason="SPF not aligned (relaxed)" header.from=wolfsden.cz (policy=none) ARC-Seal: i=1; s=key1; d=yhetil.org; t=1715507901; a=rsa-sha256; cv=none; b=GoSmkCD+6wMmzgsn0bDml8bHZz9ir6jIEv8PsyGzNVg4MONcG8WQcjqyexq0doZdNsD34p GziUtLY3HHoMZa5v9/Gqh3Sk47F14dQNjmgedTJxog/+5CfZdBwPkUMBaQB6Wo1zFoNRqR QqxLD44b5lRXMlqFhzOxQyPcigzGCgBz19EZmM/jx/7QW/CL+hbHXtqDu8oZJdAhqr8k6U LC+eQekSODKK8YkImQZKJ1cfsNYxDyEElUdCPi4+ef4iZp5nDgQc17ieeCijmkvRot2jqp UWlCy3iAV1YVvW9ByGpEehpv8/Mw60DBMebi5E1O5oz6vRSRD2BpaJWKfwpy5Q== Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 09ECA6A6A8 for ; Sun, 12 May 2024 11:58:20 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1s65y3-0000MO-6e; Sun, 12 May 2024 05:58:07 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1s65y2-0000M0-0E for guix-patches@gnu.org; Sun, 12 May 2024 05:58:06 -0400 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1s65y1-0004aR-NH; Sun, 12 May 2024 05:58:05 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1s65xy-0000G7-Eg; Sun, 12 May 2024 05:58:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#68353] [PATCH v2 1/2] doc: Document cvs-fetch and cvs-reference. References: In-Reply-To: Resent-From: Tomas Volf <~@wolfsden.cz> Original-Sender: "Debbugs-submit" Resent-CC: pelzflorian@pelzflorian.de, ludo@gnu.org, matt@excalamus.com, guix-patches@gnu.org Resent-Date: Sun, 12 May 2024 09:58:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 68353 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 68353@debbugs.gnu.org Cc: Tomas Volf <~@wolfsden.cz>, Florian Pelz , Ludovic =?UTF-8?Q?Court=C3=A8s?= , Matthew Trzcinski X-Debbugs-Original-Xcc: Florian Pelz , Ludovic =?UTF-8?Q?Court=C3=A8s?= , Matthew Trzcinski Received: via spool by 68353-submit@debbugs.gnu.org id=B68353.1715507877957 (code B ref 68353); Sun, 12 May 2024 09:58:02 +0000 Received: (at 68353) by debbugs.gnu.org; 12 May 2024 09:57:57 +0000 Received: from localhost ([127.0.0.1]:53575 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1s65xs-0000FJ-M9 for submit@debbugs.gnu.org; Sun, 12 May 2024 05:57:57 -0400 Received: from wolfsden.cz ([37.205.8.62]:52626) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <~@wolfsden.cz>) id 1s65xp-0000Ej-Ad for 68353@debbugs.gnu.org; Sun, 12 May 2024 05:57:54 -0400 Received: by wolfsden.cz (Postfix, from userid 104) id B453528A577; Sun, 12 May 2024 09:57:51 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1715507871; bh=fD5JNz7mB2BMSTNBvJJkoaYSZDpNRzbgmA3k9LOyJ1c=; h=From:To:Cc:Subject:Date; b=DJ1ar5ntqsi+qebVwvxcDaRpAI0gHBcKAWP2LMqw6rTMNNT1Zk0TULniJ/eASL3FV IQ9bpfYqbaAGMOvm+pRallcqs9zRp+6JoKGxc3eYuCpx0TBmc6IZnjjJxZZvJDO9nJ oHBzSbT6wCAxI2WFncQ2KPnzRqVlr7MGbCnCZW1eRf4rrGfArG2qw2bCi1PFw3fuQK ewDJN6TWcl94MYEBgnJcfEiQjw1jvHBf9Iy3k22WMU4t37w18+k6wH5n/z7UTwaT8i kf+mKdzViPP2MwnCeMnPfIDpYbV7NoqT+bzkKy66DqYF32sZeFOH4bo6QCZpwuQsMj 3vyrOix93eaNm0idnKGoY09aJn4TMtGZvn5rQ7guiCuOhKEz0QgPvKOFrwQZZkCNZ0 htQuqw6CQ+hMMga6n31i9M7WenrAE1C1SOv46pQgbSCpBzbWB+5UtQydbHjRVk61My zAi5el/CSsWsBcjQsG1r6pg9UCgBl5Gv+JVfbkMDIeOfcTxKR/3t8pOpiJavyXkMJG LY+rP2JFOSyRzz1wMbF/7992x9bThC34vO/AhqzNc7rTpPNyiaT4JWv1Jj6rkz00HG U8lBSdzMq3XB8InFKZfq4iH8MNFAblLusxaw+mjeSXPlv2kFxmS4vgcPe1u1DDsWKH cF1WaHzX8nOJLe+jFos5O3KY= Received: from localhost (unknown [193.32.127.156]) by wolfsden.cz (Postfix) with ESMTPSA id CAF212887E2; Sun, 12 May 2024 09:57:50 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1715507870; bh=fD5JNz7mB2BMSTNBvJJkoaYSZDpNRzbgmA3k9LOyJ1c=; h=From:To:Cc:Subject:Date; b=X4/mxdtcZ6BMMd2VfH/j+eEBTrPqArc5KMLdpFA62zsHxqGMpOQa0rNuRB+On8948 EDxaPliRtEINd3vfWUmrd6811dhZr61aDUDMU2v2UtqYrPghoJDgpeTJ+/G+53nCR6 S6m5CtSOARms8VBI45mGtME6x69ZylHBPzo6rMedl3iizsaH6zwOJtHoHTroCwl6FB ySZBMstvyUh3TRrhZO/SEQ+UFKLXjNeUH4h4dORKeNj4QpPzSuA17HsqLziUwqw93y 9RdidcMxH+qLAwoiFILFihmfG/xy4mTENIXwrPy38NSWvqoNPDdLbAPDyOy1N2jUU8 mN/33NJXyslcqWhSny8z4FtzGXxzm88wVvu8/v9OFoWv9NFwuB43Fzne0MykXeVJP8 KMvqmYHKV1ywsJ9iSsaQn8GYNZJAoT6BSY7cXKdnthz9kL9SygzLk91E4Sizv1M8tk /fLaxRY5gdUuhGFC3PKv5pWrVmkIUp2ud15gOWAY19RRUj1nMjRn4Q0s+Lrv+RKvA9 DlO3syfTLnJrP+vloXlxV/Ff8TkR+YV2QpF0J97NudCYDz5PuybzFZsH3K2FB05pjX VHJMKee2HSBFzim96JmClglP3ekMmfhBL6h0DfZR3sveUre9FedwlYfaHxuTZi1EYp +5XEhIq30+B7OrIuEWB8lXYQ= From: Tomas Volf <~@wolfsden.cz> Date: Sun, 12 May 2024 11:57:40 +0200 Message-ID: <82ec854214fad37f82bc18d4424ac61f82da3f1a.1715507861.git.~@wolfsden.cz> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: guix-patches-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Spam-Score: 4.12 X-Spam-Score: 4.12 X-Migadu-Queue-Id: 09ECA6A6A8 X-Migadu-Scanner: mx13.migadu.com X-TUID: kdTN74UVVdLY For some reason, they were missing from the documentation. This commit adds them including an example of usage. * doc/guix.texi (origin Reference): Add cvs-fetch and cvs-reference. Change-Id: I6622a9f70e6d71ed31fbb3d2689df4a6946f8868 --- doc/guix.texi | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/doc/guix.texi b/doc/guix.texi index f20208f94f..bc73942eaf 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -8302,6 +8302,43 @@ origin Reference @end table @end deftp +For CVS repositories, the module @code{(guix cvs-download)} defines the +@code{cvs-fetch} origin method and @code{cvs-reference} data type for +support of the Concurrent Versions System (CVS). + +@deffn {Procedure} cvs-fetch ref hash-algo hash [name] +Return a fixed-output derivation that fetches @var{ref}, a +@code{} object. The output is expected to have recursive +hash @var{hash} of type @var{hash-algo} (a symbol). Use @var{name} as +the file name, or a generic name if @code{#f}. +@end deffn + +@deftp {Data Type} cvs-reference +This data type represents a CVS reference for @code{cvs-fetch} to +retrieve. + +@table @asis +@item @code{root-directory} +The CVS root directory. + +@item @code{module} +Module to fetch. + +@item @code{revision} +Revision to fetch. +@end table + +The example below denotes a version of gnu-standards to fetch: + +@lisp +(cvs-reference + (root-directory ":pserver:anonymous@@cvs.savannah.gnu.org:/sources/gnustandards") + (module "gnustandards") + (revision "2020-11-25")) +@end lisp + +@end deftp + @node Defining Package Variants @section Defining Package Variants -- 2.41.0