$*REPO and CompUnit::Repository::* classes not documented

[AlexDaniel]

Code:

say WHAT $*REPO

Result:

(Installation)

[jonathanstowe]

I think this wants to be done with all the other CUR stuff, note also that it not always a CompUnit::Repository::Installation :

[jonathan@coriolanus doc.master]$ perl6 -Ilib -e 'say $*REPO.^name'
CompUnit::Repository::FileSystem
[jonathan@coriolanus doc.master]$ perl6  -e 'say $*REPO.^name'
CompUnit::Repository::Installation

[JJ]

There's not much about compunit in the documentation. Maybe create a new page?

[JJ]

@jonathanstowe I think that the main difference is that in the first case it's looking at the lib directory, and finding it does not have any .git in it. perl6 -I.. -e 'say $*REPO.^name' returns exactly the same.

[JJ]

Apparently this class has now moved to a diferent place in Rakudo

[ugexe]

$*REPO is a linked list -- what it contains depends on where it is in the list. It has nothing to do with .git nor does it have anything to do with the directory a program is run it. At the risk of sounding harsh: nothing in the commit that closed this issue makes sense.

[JJ]

And what would make sense?

[ugexe]

Some things that would make sense:

1. revert the offending commit.
2. ask what “makes sense” before commiting work that isn’t understood.

And I hate to say it but this was part of grant related work so it looks even worse.

[niner]

JJ: please have a look at https://github.com/rakudo/rakudo/blob/master/docs/module_management.md and http://niner.name/talks/A%20look%20behind%20the%20curtains%20-%20module%20loading%20in%20Perl%206/ "Not documented" has not been entirely accurate.

[JJ]

El lun., 2 jul. 2018 a las 16:16, niner ([email protected]) escribió:

JJ: please have a look at https://github.com/rakudo/rakudo/blob/master/docs/module_management.md and http://niner.name/talks/A%20look%20behind%20the%20curtains%20-%20module%20loading%20in%20Perl%206/ "Not documented" has not been entirely accurate.

I discovered them a short time ago. I did a PR on it yesterday, as a matter of fact. "Not documented" refers to this repo. We'll have to translate what's in there to here, which I'm in the process of doing.

[ohmycloud]

There are two broken links in the https://docs.perl6.org/type/CompUnit::Repository::Installation page: CompUnit::Repository and CompUnits, shows 404 when clicked.

[lizmat]

With the addition of lemmas for CompUnit::Repository and CompUnit, I think the broken links are now fixed.

[rafaelschipiura]

$REPO and CompUnit::Repository:: have been documented, closing the bug report.

[JJ]

Most classes are still not documented; CompUnit::Repository is not either for the time being. Sorry, I'm reopening.

[JJ]

$*REPO is now documented here, but the index still points to the definition in the glossary. We need either to change indexing, or to make one point to the other.

[JJ]

This issue on how to set RAKULIB to different types of repositories will help (mentioned in https://github.com/ugexe/zef/issues/430 by @ugexe )