[bug#51509] [PATCH] doc: Mention Hg support for 'guix import cran' and some caveats.

[bug#51509] [PATCH] doc: Mention Hg support for 'guix import cran' and some caveats.

[Xinglu Chen]

* guix.texi (Invoking guix import): Mention support for Mercurial repositories
  for the CRAN importer, and some caveats with the Git and Mercurial backends.
---
Prompted by Ricardo’s comments on the “Accuracy of importers” thread:

<https://yhetil.org/guix-devel/87mtmq7pes.fsf@disroot.org/T/#mabff98d436895c18f177c4016792ec215f645bbf>

 doc/guix.texi | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 22215214e0..661e29e69c 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -11852,14 +11852,20 @@
 guix import cran --archive=bioconductor GenomicRanges
 @end example
 
-Finally, you can also import R packages that have not yet been published on
-CRAN or Bioconductor as long as they are in a git repository.  Use
-@option{--archive=git} followed by the URL of the git repository:
+Finally, you can also import R packages that have not yet been published
+on CRAN or Bioconductor as long as they are in a Git or Mercurial
+repository.  Use @option{--archive=git} or @option{--archive=hg}
+followed by the URL of the repository:
 
 @example
 guix import cran --archive=git https://github.com/immunogenomics/harmony
 @end example
 
+One limitation of this is that dependencies that are also hosted on Git
+or Mercurial repositories cannot be imported.  Also, note that the
+@command{hg} executable has to be in the users's @env{PATH} for the
+Mercurial backend to work.
+
 @item texlive
 @cindex TeX Live
 @cindex CTAN

base-commit: cd188b9c6f28bd907b625a5cd6c616d1d2529671
-- 
2.33.0

[bug#51509] [PATCH] doc: Mention Hg support for 'guix import cran' and some caveats.

[Ricardo Wurmus]

Hi,

> * guix.texi (Invoking guix import): Mention support for 
> Mercurial repositories
>   for the CRAN importer, and some caveats with the Git and 
>   Mercurial backends.
> ---
> Prompted by Ricardo’s comments on the “Accuracy of importers” 
> thread:
>
> <https://yhetil.org/guix-devel/87mtmq7pes.fsf@disroot.org/T/#mabff98d436895c18f177c4016792ec215f645bbf>

I’d prefer not to mention the limitation (as it’s an 
rstudio-specific modification to DESCRIPTION files) and instead 
work on supporting this extension to the DESCRIPTION file.  I 
already have some WIP to address this.

-- 
Ricardo

[bug#51509] [PATCH] doc: Mention Hg support for 'guix import cran' and some caveats.

[Xinglu Chen]

[-- Attachment #1: Type: text/plain, Size: 1186 bytes --]

Hi,

On Sat, Nov 27 2021, Ricardo Wurmus wrote:

> Hi,
>
>> * guix.texi (Invoking guix import): Mention support for 
>> Mercurial repositories
>>   for the CRAN importer, and some caveats with the Git and 
>>   Mercurial backends.
>> ---
>> Prompted by Ricardo’s comments on the “Accuracy of importers” 
>> thread:
>>
>> <https://yhetil.org/guix-devel/87mtmq7pes.fsf@disroot.org/T/#mabff98d436895c18f177c4016792ec215f645bbf>
>
> I’d prefer not to mention the limitation (as it’s an 
> rstudio-specific modification to DESCRIPTION files) and instead 
> work on supporting this extension to the DESCRIPTION file.  I 
> already have some WIP to address this.

Just to clarify, you are referring to the fact that the ‘--recursive’
option won’t work, not the fact that the ‘hg’ binary needs to be in
$PATH, right?  In that case I will send a new reroll removing the
following sentence:

--8<---------------cut here---------------start------------->8---
+One limitation of this is that dependencies that are also hosted on Git
+or Mercurial repositories cannot be imported.
--8<---------------cut here---------------end--------------->8---


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 861 bytes --]