all messages for Guix-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* [bug#68353] [PATCH 0/2] Minor improvements to the documentation.
@ 2024-01-09 22:29 Tomas Volf
  2024-01-09 22:45 ` [bug#68353] [PATCH 1/2] doc: Document cvs-fetch and cvs-reference Tomas Volf
                   ` (2 more replies)
  0 siblings, 3 replies; 6+ messages in thread
From: Tomas Volf @ 2024-01-09 22:29 UTC (permalink / raw)
  To: 68353; +Cc: Tomas Volf

cvs-fetch and cvs-reference were not documented at all, while hg-reference was
wrong.  This mini-series fixes both.

Tomas Volf (2):
  doc: Document cvs-fetch and cvs-reference.
  doc: Fix bug in hg-reference documentation.

 doc/guix.texi | 41 +++++++++++++++++++++++++++++++++++++++--
 1 file changed, 39 insertions(+), 2 deletions(-)


base-commit: b212e6934643e085f168a5364cb593f61aa616ba
--
2.41.0




^ permalink raw reply	[flat|nested] 6+ messages in thread

* [bug#68353] [PATCH 1/2] doc: Document cvs-fetch and cvs-reference.
  2024-01-09 22:29 [bug#68353] [PATCH 0/2] Minor improvements to the documentation Tomas Volf
@ 2024-01-09 22:45 ` Tomas Volf
  2024-01-09 22:45 ` [bug#68353] [PATCH 2/2] doc: Fix bug in hg-reference documentation Tomas Volf
  2024-05-12  9:57 ` [bug#68353] [PATCH v2 1/2] doc: Document cvs-fetch and cvs-reference Tomas Volf
  2 siblings, 0 replies; 6+ messages in thread
From: Tomas Volf @ 2024-01-09 22:45 UTC (permalink / raw)
  To: 68353; +Cc: Tomas Volf

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 a648a106b3..fde8aa12b9 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -8525,6 +8525,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{<cvs-reference>} 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





^ permalink raw reply related	[flat|nested] 6+ messages in thread

* [bug#68353] [PATCH 2/2] doc: Fix bug in hg-reference documentation.
  2024-01-09 22:29 [bug#68353] [PATCH 0/2] Minor improvements to the documentation Tomas Volf
  2024-01-09 22:45 ` [bug#68353] [PATCH 1/2] doc: Document cvs-fetch and cvs-reference Tomas Volf
@ 2024-01-09 22:45 ` Tomas Volf
  2024-05-12  9:57 ` [bug#68353] [PATCH v2 1/2] doc: Document cvs-fetch and cvs-reference Tomas Volf
  2 siblings, 0 replies; 6+ messages in thread
From: Tomas Volf @ 2024-01-09 22:45 UTC (permalink / raw)
  To: 68353; +Cc: Tomas Volf

The field is called changeset, not revision.  And the string does not have to
be a number.

* doc/guix.texi (origin Reference): Fix documentation for hg-reference.

Change-Id: Ic622dfc7b44caf42d070cdab8e42808dd96e6d63
---
 doc/guix.texi | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index fde8aa12b9..466e01eab5 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -8461,8 +8461,8 @@ origin Reference
 @item @code{url}
 The URL of the Mercurial repository to clone.
 
-@item @code{revision}
-This string denotes revision to fetch specified as a number.
+@item @code{changeset}
+This string denotes changeset to fetch.
 @end table
 @end deftp
 
-- 
2.41.0





^ permalink raw reply related	[flat|nested] 6+ messages in thread

* [bug#68353] [PATCH v2 1/2] doc: Document cvs-fetch and cvs-reference.
  2024-01-09 22:29 [bug#68353] [PATCH 0/2] Minor improvements to the documentation Tomas Volf
  2024-01-09 22:45 ` [bug#68353] [PATCH 1/2] doc: Document cvs-fetch and cvs-reference Tomas Volf
  2024-01-09 22:45 ` [bug#68353] [PATCH 2/2] doc: Fix bug in hg-reference documentation Tomas Volf
@ 2024-05-12  9:57 ` Tomas Volf
  2024-05-12  9:57   ` [bug#68353] [PATCH v2 2/2] doc: Fix bug in hg-reference documentation Tomas Volf
  2024-05-13 12:45   ` bug#68353: [PATCH v2 1/2] doc: Document cvs-fetch and cvs-reference Ludovic Courtès
  2 siblings, 2 replies; 6+ messages in thread
From: Tomas Volf @ 2024-05-12  9:57 UTC (permalink / raw)
  To: 68353; +Cc: Tomas Volf, Florian Pelz, Ludovic Courtès, Matthew Trzcinski

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{<cvs-reference>} 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





^ permalink raw reply related	[flat|nested] 6+ messages in thread

* [bug#68353] [PATCH v2 2/2] doc: Fix bug in hg-reference documentation.
  2024-05-12  9:57 ` [bug#68353] [PATCH v2 1/2] doc: Document cvs-fetch and cvs-reference Tomas Volf
@ 2024-05-12  9:57   ` Tomas Volf
  2024-05-13 12:45   ` bug#68353: [PATCH v2 1/2] doc: Document cvs-fetch and cvs-reference Ludovic Courtès
  1 sibling, 0 replies; 6+ messages in thread
From: Tomas Volf @ 2024-05-12  9:57 UTC (permalink / raw)
  To: 68353; +Cc: Tomas Volf, Florian Pelz, Ludovic Courtès, Matthew Trzcinski

The field is called changeset, not revision.  And the string does not have to
be a number.

* doc/guix.texi (origin Reference): Fix documentation for hg-reference.

Change-Id: Ic622dfc7b44caf42d070cdab8e42808dd96e6d63
---
 doc/guix.texi | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index bc73942eaf..230ba511c5 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -8238,8 +8238,8 @@ origin Reference
 @item @code{url}
 The URL of the Mercurial repository to clone.
 
-@item @code{revision}
-This string denotes revision to fetch specified as a number.
+@item @code{changeset}
+This string denotes changeset to fetch.
 @end table
 @end deftp
 
-- 
2.41.0





^ permalink raw reply related	[flat|nested] 6+ messages in thread

* bug#68353: [PATCH v2 1/2] doc: Document cvs-fetch and cvs-reference.
  2024-05-12  9:57 ` [bug#68353] [PATCH v2 1/2] doc: Document cvs-fetch and cvs-reference Tomas Volf
  2024-05-12  9:57   ` [bug#68353] [PATCH v2 2/2] doc: Fix bug in hg-reference documentation Tomas Volf
@ 2024-05-13 12:45   ` Ludovic Courtès
  1 sibling, 0 replies; 6+ messages in thread
From: Ludovic Courtès @ 2024-05-13 12:45 UTC (permalink / raw)
  To: Tomas Volf; +Cc: 68353-done, Florian Pelz, Matthew Trzcinski

Tomas Volf <~@wolfsden.cz> skribis:

> 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

[...]

> The field is called changeset, not revision.  And the string does not have to
> be a number.
>
> * doc/guix.texi (origin Reference): Fix documentation for hg-reference.
>
> Change-Id: Ic622dfc7b44caf42d070cdab8e42808dd96e6d63

Applied, thanks!




^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2024-05-13 13:21 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2024-01-09 22:29 [bug#68353] [PATCH 0/2] Minor improvements to the documentation Tomas Volf
2024-01-09 22:45 ` [bug#68353] [PATCH 1/2] doc: Document cvs-fetch and cvs-reference Tomas Volf
2024-01-09 22:45 ` [bug#68353] [PATCH 2/2] doc: Fix bug in hg-reference documentation Tomas Volf
2024-05-12  9:57 ` [bug#68353] [PATCH v2 1/2] doc: Document cvs-fetch and cvs-reference Tomas Volf
2024-05-12  9:57   ` [bug#68353] [PATCH v2 2/2] doc: Fix bug in hg-reference documentation Tomas Volf
2024-05-13 12:45   ` bug#68353: [PATCH v2 1/2] doc: Document cvs-fetch and cvs-reference Ludovic Courtès

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/guix.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.