LTA documentation page

https://docs.raku.org/programs/02-reading-docs says to use ``rakudoc``
to read the documentation of installed modules.

I don't have it installed::

  $ rakudoc
  -bash: rakudoc: command not found

Not a problem, that same page says to use zef::

  $ $ zef install rakudoc
  ===> Searching for: rakudoc
  No candidates found matching identity: rakudoc

Ok, this is not great. https://modules.raku.org/search/?q=rakudoc also
doesn't know anything about that distribution.

What happened?

-- 
	Dakkar - <Mobilis in mobile>
	GPG public key fingerprint = A071 E618 DD2C 5901 9574
	                             6FE2 40EA 9883 7519 3F88
	                    key id = 0x75193F88

-1
dakkar
1/5/2021 12:20:59 PM
perl.perl6.users 1545 articles. 0 followers. Follow

13 Replies
444 Views

Similar Articles

[PageSpeed] 43
Get it on Google Play
Get it on Apple App Store

I googled rakudoc and that led to:

https://github.com/Raku/rakudoc

which says it's forked from:

https://github.com/noisegul/perl6-p6doc

So I tried that in m.r.o and it's listed:

https://modules.raku.org/search/?q=p6doc

So, perhaps you can zef install p6doc?

Maybe the doc you read mentioning rakudoc
is ahead of the situation in rakudo versions, or
at least yours, as well as being ahead of the
ecosystem?

love, raiph
0
ralphdjmellor
1/5/2021 1:10:02 PM
--000000000000cab7d205b8270839
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

Gianni is basically right. rakudoc has not really been released yet into
the ecosystem, and p6doc will get you the documentation itself, which you
will have to build then. So LTA is true, and there's some work to be done.
There's probably an issue already created, but it will pop up if you create
another one, so please do raise the issue and focus it on the documentation
part if it does not.

We really encourage people to peruse the documentation online, though.
https://docs.raku.org. If what you want is to check out the documentation
of installed modules... Well, as said above, work needs to be done.

El mar, 5 ene 2021 a las 14:10, Ralph Mellor (<ralphdjmellor@gmail.com>)
escribi=C3=B3:

> I googled rakudoc and that led to:
>
> https://github.com/Raku/rakudoc
>
> which says it's forked from:
>
> https://github.com/noisegul/perl6-p6doc
>
> So I tried that in m.r.o and it's listed:
>
> https://modules.raku.org/search/?q=3Dp6doc
>
> So, perhaps you can zef install p6doc?
>
> Maybe the doc you read mentioning rakudoc
> is ahead of the situation in rakudo versions, or
> at least yours, as well as being ahead of the
> ecosystem?
>
> love, raiph
>


--=20
JJ

--000000000000cab7d205b8270839
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div>Gianni is basically right. rakudoc has not really bee=
n released yet into the ecosystem, and p6doc will get you the documentation=
 itself, which you will have to build then. So LTA is true, and there&#39;s=
 some work to be done. There&#39;s probably an issue already created, but i=
t will pop up if you create another one, so please do raise the issue and f=
ocus it on the documentation part if it does not.</div><div><br></div><div>=
We really encourage people to peruse the documentation online, though. <a h=
ref=3D"https://docs.raku.org">https://docs.raku.org</a>. If what you want i=
s to check out the documentation of installed modules... Well, as said abov=
e, work needs to be done.<br></div></div><br><div class=3D"gmail_quote"><di=
v dir=3D"ltr" class=3D"gmail_attr">El mar, 5 ene 2021 a las 14:10, Ralph Me=
llor (&lt;<a href=3D"mailto:ralphdjmellor@gmail.com">ralphdjmellor@gmail.co=
m</a>&gt;) escribi=C3=B3:<br></div><blockquote class=3D"gmail_quote" style=
=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding=
-left:1ex">I googled rakudoc and that led to:<br>
<br>
<a href=3D"https://github.com/Raku/rakudoc" rel=3D"noreferrer" target=3D"_b=
lank">https://github.com/Raku/rakudoc</a><br>
<br>
which says it&#39;s forked from:<br>
<br>
<a href=3D"https://github.com/noisegul/perl6-p6doc" rel=3D"noreferrer" targ=
et=3D"_blank">https://github.com/noisegul/perl6-p6doc</a><br>
<br>
So I tried that in m.r.o and it&#39;s listed:<br>
<br>
<a href=3D"https://modules.raku.org/search/?q=3Dp6doc" rel=3D"noreferrer" t=
arget=3D"_blank">https://modules.raku.org/search/?q=3Dp6doc</a><br>
<br>
So, perhaps you can zef install p6doc?<br>
<br>
Maybe the doc you read mentioning rakudoc<br>
is ahead of the situation in rakudo versions, or<br>
at least yours, as well as being ahead of the<br>
ecosystem?<br>
<br>
love, raiph<br>
</blockquote></div><br clear=3D"all"><br>-- <br><div dir=3D"ltr" class=3D"g=
mail_signature">JJ</div>

--000000000000cab7d205b8270839--
0
jjmerelo
1/5/2021 1:17:43 PM
On 2021-01-05 JJ Merelo <jjmerelo@gmail.com> wrote:
> Gianni is basically right. rakudoc has not really been released yet
> into the ecosystem, and p6doc will get you the documentation itself,
> which you will have to build then. So LTA is true, and there's some
> work to be done. There's probably an issue already created, but it
> will pop up if you create another one, so please do raise the issue
> and focus it on the documentation part if it does not.

https://github.com/Raku/doc/issues/3769

> We really encourage people to peruse the documentation online, though.
> https://docs.raku.org

Why? The online documentation will not, in the general case, match the
rakudo version I have installed.

-- 
	Dakkar - <Mobilis in mobile>
	GPG public key fingerprint = A071 E618 DD2C 5901 9574
	                             6FE2 40EA 9883 7519 3F88
	                    key id = 0x75193F88

0
dakkar
1/5/2021 1:30:44 PM
--000000000000b29b8805b8280887
Content-Type: text/plain; charset="UTF-8"

There really shouldn't be that much difference between what the
documentation says and how your version works.

The biggest thing would be new functions that you don't have yet.
(Which you could just copy the code from the sources into your program if
you need them.)

Even if rakudoc did install, it would just copy the most recent docs as of
the time you installed it.

It's not like the Perl docs which are in the same repository as the code.
The Raku docs aren't even controlled by the same organization on
GitHub, let alone being in the same repository.
(There are different requirements to being in the different projects.)

On Tue, Jan 5, 2021 at 7:31 AM Gianni Ceccarelli <dakkar@thenautilus.net>
wrote:

> On 2021-01-05 JJ Merelo <jjmerelo@gmail.com> wrote:
> > Gianni is basically right. rakudoc has not really been released yet
> > into the ecosystem, and p6doc will get you the documentation itself,
> > which you will have to build then. So LTA is true, and there's some
> > work to be done. There's probably an issue already created, but it
> > will pop up if you create another one, so please do raise the issue
> > and focus it on the documentation part if it does not.
>
> https://github.com/Raku/doc/issues/3769
>
> > We really encourage people to peruse the documentation online, though.
> > https://docs.raku.org
>
> Why? The online documentation will not, in the general case, match the
> rakudo version I have installed.
>
> --
>         Dakkar - <Mobilis in mobile>
>         GPG public key fingerprint = A071 E618 DD2C 5901 9574
>                                      6FE2 40EA 9883 7519 3F88
>                             key id = 0x75193F88
>
>

--000000000000b29b8805b8280887
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr">There really shouldn&#39;t be that much difference between=
 what the documentation says and how your version works.<div><br></div><div=
>The biggest thing would be new functions that you don&#39;t have yet.</div=
><div>(Which you could just copy the=C2=A0code from the sources into your p=
rogram if you need them.)</div><div><br></div><div>Even if rakudoc did inst=
all, it would just copy the most recent docs as of the time you installed i=
t.</div><div><br></div><div>It&#39;s not like the Perl docs which are in th=
e same repository as the code.</div><div>The Raku docs aren&#39;t even cont=
rolled by the same organization on GitHub,=C2=A0let alone being in the same=
 repository.</div><div>(There are different requirements to being in the di=
fferent projects.)</div></div><br><div class=3D"gmail_quote"><div dir=3D"lt=
r" class=3D"gmail_attr">On Tue, Jan 5, 2021 at 7:31 AM Gianni Ceccarelli &l=
t;<a href=3D"mailto:dakkar@thenautilus.net">dakkar@thenautilus.net</a>&gt; =
wrote:<br></div><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0=
px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On 2021-0=
1-05 JJ Merelo &lt;<a href=3D"mailto:jjmerelo@gmail.com" target=3D"_blank">=
jjmerelo@gmail.com</a>&gt; wrote:<br>
&gt; Gianni is basically right. rakudoc has not really been released yet<br=
>
&gt; into the ecosystem, and p6doc will get you the documentation itself,<b=
r>
&gt; which you will have to build then. So LTA is true, and there&#39;s som=
e<br>
&gt; work to be done. There&#39;s probably an issue already created, but it=
<br>
&gt; will pop up if you create another one, so please do raise the issue<br=
>
&gt; and focus it on the documentation part if it does not.<br>
<br>
<a href=3D"https://github.com/Raku/doc/issues/3769" rel=3D"noreferrer" targ=
et=3D"_blank">https://github.com/Raku/doc/issues/3769</a><br>
<br>
&gt; We really encourage people to peruse the documentation online, though.=
<br>
&gt; <a href=3D"https://docs.raku.org" rel=3D"noreferrer" target=3D"_blank"=
>https://docs.raku.org</a><br>
<br>
Why? The online documentation will not, in the general case, match the<br>
rakudo version I have installed.<br>
<br>
-- <br>
=C2=A0 =C2=A0 =C2=A0 =C2=A0 Dakkar - &lt;Mobilis in mobile&gt;<br>
=C2=A0 =C2=A0 =C2=A0 =C2=A0 GPG public key fingerprint =3D A071 E618 DD2C 5=
901 9574<br>
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A06FE2 40EA 9883 7=
519 3F88<br>
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 key id =3D 0x75193F88<br>
<br>
</blockquote></div>

--000000000000b29b8805b8280887--
0
b2gills
1/5/2021 2:29:16 PM
On 2021-01-05 Brad Gilbert <b2gills@gmail.com> wrote:
> There really shouldn't be that much difference between what the
> documentation says and how your version works.

I've worked on machines stuck with perl 5.8 when the online
documentation was for 5.26

I'd like to live in a world where:

* raku is popular and widespread enough that you find old versions it
  on old machines
* I won't have to struggle to remember the differences between 6.d and
  6.l

For now, yes, the online docs are "good enough" (when I have network
connectivity, at least!)

> Even if rakudoc did install, it would just copy the most recent docs
> as of the time you installed it.

rakudoc != p6doc

rakudoc looks at the POD6 in installed distributions / modules

-- 
	Dakkar - <Mobilis in mobile>
	GPG public key fingerprint = A071 E618 DD2C 5901 9574
	                             6FE2 40EA 9883 7519 3F88
	                    key id = 0x75193F88

0
dakkar
1/5/2021 2:48:52 PM
And here it comes again, the common mess about Raku and Rakudo. :)

The point is that Rakudo doesn't come bundled with documentation about =
Raku because the former just implements the latter. It's not like it is =
with perl where `perl` binary and `Perl` are the same and `perl -v` is =
your current version of Perl. =46rom this point of view, one would have =
to know the difference between 6.d and 6.l version of Raku because these =
differences might be overwhelming. Even now it'd be good to know about =
the differences in role behavior between 6.c/6.d and 6.e.

Contrary, one is better not care about the differences between Rakudo =
2019.10 and 2020.12 for as long as they both implement same Raku =
versions. Apparently, I'm not talking about bug compatibility here. So, =
for as long as one's code always starts with `use v6.d` they really may =
not be worried about any upcoming Raku language version up until their =
compiler starts deprecation cycle for 6.d.

The task of the online documentation is to allow one to find out what =
version of Raku introduced a requested feature. We'll most certainly =
need a section related to versioning and have it pinned at some easy to =
spot location. And it will be there when our resources allow which must =
be read as: when somebody find time to do it. Any help is welcome! :)

Best regards,
Vadim Belman

> On Jan 5, 2021, at 9:48 AM, Gianni Ceccarelli <dakkar@thenautilus.net> =
wrote:
>=20
> On 2021-01-05 Brad Gilbert <b2gills@gmail.com> wrote:
>> There really shouldn't be that much difference between what the
>> documentation says and how your version works.
>=20
> I've worked on machines stuck with perl 5.8 when the online
> documentation was for 5.26
>=20
> I'd like to live in a world where:
>=20
> * raku is popular and widespread enough that you find old versions it
>  on old machines
> * I won't have to struggle to remember the differences between 6.d and
>  6.l
>=20
> For now, yes, the online docs are "good enough" (when I have network
> connectivity, at least!)
>=20
>> Even if rakudoc did install, it would just copy the most recent docs
>> as of the time you installed it.
>=20
> rakudoc !=3D p6doc
>=20
> rakudoc looks at the POD6 in installed distributions / modules
>=20
> --=20
> 	Dakkar - <Mobilis in mobile>
> 	GPG public key fingerprint =3D A071 E618 DD2C 5901 9574
> 	                             6FE2 40EA 9883 7519 3F88
> 	                    key id =3D 0x75193F88
>=20

0
vrurg
1/5/2021 3:08:52 PM
--000000000000c3283305b829c8ab
Content-Type: text/plain; charset="UTF-8"

On Tue, Jan 5, 2021 at 5:10 AM Ralph Mellor <ralphdjmellor@gmail.com> wrote:
>
> I googled rakudoc and that led to:
>
> https://github.com/Raku/rakudoc
>
> which says it's forked from:
>
> https://github.com/noisegul/perl6-p6doc
>
> So I tried that in m.r.o and it's listed:
>
> https://modules.raku.org/search/?q=p6doc
>
> So, perhaps you can zef install p6doc?
>
> Maybe the doc you read mentioning rakudoc
> is ahead of the situation in rakudo versions, or
> at least yours, as well as being ahead of the
> ecosystem?
>
> love, raiph

Raiph's suggestion works for me (on rakudo-2020.10). I mean, p6doc installs:

Last login: Tue Jan  5 08:23:11 on ttys023
user@mbook:~$ ~/rakudo/rakudo-2020.10/zef/bin/zef install p6doc
===> Searching for: p6doc
===> Updating cpan mirror:
https://raw.githubusercontent.com/ugexe/Perl6-ecosystems/master/cpan1.json
===> Updating p6c mirror:
https://raw.githubusercontent.com/ugexe/Perl6-ecosystems/master/p6c1.json
===> Updated p6c mirror:
https://raw.githubusercontent.com/ugexe/Perl6-ecosystems/master/p6c1.json
===> Updated cpan mirror:
https://raw.githubusercontent.com/ugexe/Perl6-ecosystems/master/cpan1.json
===> Searching for missing dependencies: Pod::To::BigPage:ver<0.5.1+>
===> Searching for missing dependencies: HTTP::UserAgent, Test::When
===> Building: p6doc:ver<1.002001>
===> Building [OK] for p6doc:ver<1.002001>
===> Testing: HTTP::UserAgent:ver<1.1.51>:auth<github:sergot>
[HTTP::UserAgent] # NETWORK_TESTING was not set
[HTTP::UserAgent] # NETWORK_TESTING was not set
[HTTP::UserAgent] # NETWORK_TESTING was not set
[HTTP::UserAgent] # NETWORK_TESTING was not set
[HTTP::UserAgent] # NETWORK_TESTING was not set
[HTTP::UserAgent] # NETWORK_TESTING was not set
===> Testing [OK] for HTTP::UserAgent:ver<1.1.51>:auth<github:sergot>
===> Testing: Test::When:ver<1.001008>
===> Testing [OK] for Test::When:ver<1.001008>
===> Testing: Pod::To::BigPage:ver<0.5.2>:auth<Perl 6>
===> Testing [OK] for Pod::To::BigPage:ver<0.5.2>:auth<Perl 6>
===> Testing: p6doc:ver<1.002001>
===> Testing [OK] for p6doc:ver<1.002001>
===> Installing: HTTP::UserAgent:ver<1.1.51>:auth<github:sergot>
===> Installing: Test::When:ver<1.001008>
===> Installing: Pod::To::BigPage:ver<0.5.2>:auth<Perl 6>
===> Installing: p6doc:ver<1.002001>

2 bin/ scripts [pod2onepage p6doc] installed to:
/Users/me/rakudo/rakudo-2020.10/install/share/perl6/site/bin
user@mbook:~$

HTH, Bill.

--000000000000c3283305b829c8ab
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><br><br>On Tue, Jan 5, 2021 at 5:10 AM Ralph Mellor &lt;<a=
 href=3D"mailto:ralphdjmellor@gmail.com">ralphdjmellor@gmail.com</a>&gt; wr=
ote:<br>&gt;<br>&gt; I googled rakudoc and that led to:<br>&gt;<br>&gt; <a =
href=3D"https://github.com/Raku/rakudoc">https://github.com/Raku/rakudoc</a=
><br>&gt;<br>&gt; which says it&#39;s forked from:<br>&gt;<br>&gt; <a href=
=3D"https://github.com/noisegul/perl6-p6doc">https://github.com/noisegul/pe=
rl6-p6doc</a><br>&gt;<br>&gt; So I tried that in m.r.o and it&#39;s listed:=
<br>&gt;<br>&gt; <a href=3D"https://modules.raku.org/search/?q=3Dp6doc">htt=
ps://modules.raku.org/search/?q=3Dp6doc</a><br>&gt;<br>&gt; So, perhaps you=
 can zef install p6doc?<br>&gt;<br>&gt; Maybe the doc you read mentioning r=
akudoc<br>&gt; is ahead of the situation in rakudo versions, or<br>&gt; at =
least yours, as well as being ahead of the<br>&gt; ecosystem?<br>&gt;<br>&g=
t; love, raiph<br><br>Raiph&#39;s suggestion works for me (on rakudo-2020.1=
0). I mean, p6doc installs:<br><br>Last login: Tue Jan =C2=A05 08:23:11 on =
ttys023<br>user@mbook:~$ ~/rakudo/rakudo-2020.10/zef/bin/zef install p6doc<=
br>=3D=3D=3D&gt; Searching for: p6doc<br>=3D=3D=3D&gt; Updating cpan mirror=
: <a href=3D"https://raw.githubusercontent.com/ugexe/Perl6-ecosystems/maste=
r/cpan1.json">https://raw.githubusercontent.com/ugexe/Perl6-ecosystems/mast=
er/cpan1.json</a><br>=3D=3D=3D&gt; Updating p6c mirror: <a href=3D"https://=
raw.githubusercontent.com/ugexe/Perl6-ecosystems/master/p6c1.json">https://=
raw.githubusercontent.com/ugexe/Perl6-ecosystems/master/p6c1.json</a><br>=
=3D=3D=3D&gt; Updated p6c mirror: <a href=3D"https://raw.githubusercontent.=
com/ugexe/Perl6-ecosystems/master/p6c1.json">https://raw.githubusercontent.=
com/ugexe/Perl6-ecosystems/master/p6c1.json</a><br>=3D=3D=3D&gt; Updated cp=
an mirror: <a href=3D"https://raw.githubusercontent.com/ugexe/Perl6-ecosyst=
ems/master/cpan1.json">https://raw.githubusercontent.com/ugexe/Perl6-ecosys=
tems/master/cpan1.json</a><br>=3D=3D=3D&gt; Searching for missing dependenc=
ies: Pod::To::BigPage:ver&lt;0.5.1+&gt;<br>=3D=3D=3D&gt; Searching for miss=
ing dependencies: HTTP::UserAgent, Test::When<br>=3D=3D=3D&gt; Building: p6=
doc:ver&lt;1.002001&gt;<br>=3D=3D=3D&gt; Building [OK] for p6doc:ver&lt;1.0=
02001&gt;<br>=3D=3D=3D&gt; Testing: HTTP::UserAgent:ver&lt;1.1.51&gt;:auth&=
lt;github:sergot&gt;<br>[HTTP::UserAgent] # NETWORK_TESTING was not set<br>=
[HTTP::UserAgent] # NETWORK_TESTING was not set<br>[HTTP::UserAgent] # NETW=
ORK_TESTING was not set<br>[HTTP::UserAgent] # NETWORK_TESTING was not set<=
br>[HTTP::UserAgent] # NETWORK_TESTING was not set<br>[HTTP::UserAgent] # N=
ETWORK_TESTING was not set<br>=3D=3D=3D&gt; Testing [OK] for HTTP::UserAgen=
t:ver&lt;1.1.51&gt;:auth&lt;github:sergot&gt;<br>=3D=3D=3D&gt; Testing: Tes=
t::When:ver&lt;1.001008&gt;<br>=3D=3D=3D&gt; Testing [OK] for Test::When:ve=
r&lt;1.001008&gt;<br>=3D=3D=3D&gt; Testing: Pod::To::BigPage:ver&lt;0.5.2&g=
t;:auth&lt;Perl 6&gt;<br>=3D=3D=3D&gt; Testing [OK] for Pod::To::BigPage:ve=
r&lt;0.5.2&gt;:auth&lt;Perl 6&gt;<br>=3D=3D=3D&gt; Testing: p6doc:ver&lt;1.=
002001&gt;<br>=3D=3D=3D&gt; Testing [OK] for p6doc:ver&lt;1.002001&gt;<br>=
=3D=3D=3D&gt; Installing: HTTP::UserAgent:ver&lt;1.1.51&gt;:auth&lt;github:=
sergot&gt;<br>=3D=3D=3D&gt; Installing: Test::When:ver&lt;1.001008&gt;<br>=
=3D=3D=3D&gt; Installing: Pod::To::BigPage:ver&lt;0.5.2&gt;:auth&lt;Perl 6&=
gt;<br>=3D=3D=3D&gt; Installing: p6doc:ver&lt;1.002001&gt;<br><br>2 bin/ sc=
ripts [pod2onepage p6doc] installed to:<br>/Users/me/rakudo/rakudo-2020.10/=
install/share/perl6/site/bin<br><div>user@mbook:~$</div><div><br></div><div=
>HTH, Bill.<br></div></div>

--000000000000c3283305b829c8ab--
0
perl6
1/5/2021 4:34:09 PM
On 2021-01-05 William Michels via perl6-users <perl6-users@perl.org>
wrote:
> Raiph's suggestion works for me (on rakudo-2020.10). I mean, p6doc
> installs

Oh, that points to new, different, problems.

https://modules.raku.org/search/?q=p6doc links to
https://github.com/Raku/doc which does not contain a ``p6doc`` script,
which means that what I get with ``zef install p6doc`` is not the same
thing (this is a general problem with pointing at repositories instead
of distribution artifacts, it's not specific to p6doc)

Then, ``zef install p6doc`` fails here, because::

  Failed to create directory '/usr/share/perl6/site/doc' with mode
  '0o777': Failed to mkdir: Permission denied

AIUI, distributions should install to the CompUnit::Repository in my
home directory, not into the system-wide one.

-- 
	Dakkar - <Mobilis in mobile>
	GPG public key fingerprint = A071 E618 DD2C 5901 9574
	                             6FE2 40EA 9883 7519 3F88
	                    key id = 0x75193F88

0
dakkar
1/5/2021 5:02:09 PM
--000000000000774ea105b82ab762
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

Yep, there are a couple of (known) issues here:
https://github.com/Raku/problem-solving/issues/252 which request to remove
it from the ecosystem (and I'll probably do it when I finish this email),
and this one https://github.com/Raku/doc/issues/2896 Build.pm does not
really work now, to it should probably be removed. And if it is, there's
actually nothing to "install" so it should be removed.
Maybe we should work first on releasing rakudoc. Let me see if we can do
that soon-ish or it requires a lot of work. And in any case we will
probably encourage people to use the online version of the documentation
(or to build it themselves via Documentable)

Thanks anyways for the checks, cheers

El mar, 5 ene 2021 a las 18:02, Gianni Ceccarelli (<dakkar@thenautilus.net>=
)
escribi=C3=B3:

> On 2021-01-05 William Michels via perl6-users <perl6-users@perl.org>
> wrote:
> > Raiph's suggestion works for me (on rakudo-2020.10). I mean, p6doc
> > installs
>
> Oh, that points to new, different, problems.
>
> https://modules.raku.org/search/?q=3Dp6doc links to
> https://github.com/Raku/doc which does not contain a ``p6doc`` script,
> which means that what I get with ``zef install p6doc`` is not the same
> thing (this is a general problem with pointing at repositories instead
> of distribution artifacts, it's not specific to p6doc)
>
> Then, ``zef install p6doc`` fails here, because::
>
>   Failed to create directory '/usr/share/perl6/site/doc' with mode
>   '0o777': Failed to mkdir: Permission denied
>
> AIUI, distributions should install to the CompUnit::Repository in my
> home directory, not into the system-wide one.
>
> --
>         Dakkar - <Mobilis in mobile>
>         GPG public key fingerprint =3D A071 E618 DD2C 5901 9574
>                                      6FE2 40EA 9883 7519 3F88
>                             key id =3D 0x75193F88
>
>

--=20
JJ

--000000000000774ea105b82ab762
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div>Yep, there are a couple of (known) issues here: <a hr=
ef=3D"https://github.com/Raku/problem-solving/issues/252">https://github.co=
m/Raku/problem-solving/issues/252</a> which request to remove it from the e=
cosystem (and I&#39;ll probably do it when I finish this email), and this o=
ne <a href=3D"https://github.com/Raku/doc/issues/2896">https://github.com/R=
aku/doc/issues/2896</a> Build.pm does not really work now, to it should pro=
bably be removed. And if it is, there&#39;s actually nothing to &quot;insta=
ll&quot; so it should be removed.</div><div>Maybe we should work first on r=
eleasing rakudoc. Let me see if we can do that soon-ish or it requires a lo=
t of work. And in any case we will probably encourage people to use the onl=
ine version of the documentation (or to build it themselves via Documentabl=
e)</div><div><br></div><div>Thanks anyways for the checks, cheers<br></div>=
</div><br><div class=3D"gmail_quote"><div dir=3D"ltr" class=3D"gmail_attr">=
El mar, 5 ene 2021 a las 18:02, Gianni Ceccarelli (&lt;<a href=3D"mailto:da=
kkar@thenautilus.net">dakkar@thenautilus.net</a>&gt;) escribi=C3=B3:<br></d=
iv><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;bord=
er-left:1px solid rgb(204,204,204);padding-left:1ex">On 2021-01-05 William =
Michels via perl6-users &lt;<a href=3D"mailto:perl6-users@perl.org" target=
=3D"_blank">perl6-users@perl.org</a>&gt;<br>
wrote:<br>
&gt; Raiph&#39;s suggestion works for me (on rakudo-2020.10). I mean, p6doc=
<br>
&gt; installs<br>
<br>
Oh, that points to new, different, problems.<br>
<br>
<a href=3D"https://modules.raku.org/search/?q=3Dp6doc" rel=3D"noreferrer" t=
arget=3D"_blank">https://modules.raku.org/search/?q=3Dp6doc</a> links to<br=
>
<a href=3D"https://github.com/Raku/doc" rel=3D"noreferrer" target=3D"_blank=
">https://github.com/Raku/doc</a> which does not contain a ``p6doc`` script=
,<br>
which means that what I get with ``zef install p6doc`` is not the same<br>
thing (this is a general problem with pointing at repositories instead<br>
of distribution artifacts, it&#39;s not specific to p6doc)<br>
<br>
Then, ``zef install p6doc`` fails here, because::<br>
<br>
=C2=A0 Failed to create directory &#39;/usr/share/perl6/site/doc&#39; with =
mode<br>
=C2=A0 &#39;0o777&#39;: Failed to mkdir: Permission denied<br>
<br>
AIUI, distributions should install to the CompUnit::Repository in my<br>
home directory, not into the system-wide one.<br>
<br>
-- <br>
=C2=A0 =C2=A0 =C2=A0 =C2=A0 Dakkar - &lt;Mobilis in mobile&gt;<br>
=C2=A0 =C2=A0 =C2=A0 =C2=A0 GPG public key fingerprint =3D A071 E618 DD2C 5=
901 9574<br>
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A06FE2 40EA 9883 7=
519 3F88<br>
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 key id =3D 0x75193F88<br>
<br>
</blockquote></div><br clear=3D"all"><br>-- <br><div dir=3D"ltr" class=3D"g=
mail_signature">JJ</div>

--000000000000774ea105b82ab762--
0
jjmerelo
1/5/2021 5:41:18 PM
--0000000000008217df05b82acbc8
Content-Type: text/plain; charset="UTF-8"

Can you try 'mkdir' manually beforehand to create the desired
'/usr/share/perl6/site/doc' directory, then run 'zef install p6doc' ?

Just wondering... . I note your other comments with great interest.

Best, Bill.

On Tue, Jan 5, 2021 at 9:02 AM Gianni Ceccarelli <dakkar@thenautilus.net>
wrote:

> On 2021-01-05 William Michels via perl6-users <perl6-users@perl.org>
> wrote:
> > Raiph's suggestion works for me (on rakudo-2020.10). I mean, p6doc
> > installs
>
> Oh, that points to new, different, problems.
>
> https://modules.raku.org/search/?q=p6doc links to
> https://github.com/Raku/doc which does not contain a ``p6doc`` script,
> which means that what I get with ``zef install p6doc`` is not the same
> thing (this is a general problem with pointing at repositories instead
> of distribution artifacts, it's not specific to p6doc)
>
> Then, ``zef install p6doc`` fails here, because::
>
>   Failed to create directory '/usr/share/perl6/site/doc' with mode
>   '0o777': Failed to mkdir: Permission denied
>
> AIUI, distributions should install to the CompUnit::Repository in my
> home directory, not into the system-wide one.
>
> --
>         Dakkar - <Mobilis in mobile>
>         GPG public key fingerprint = A071 E618 DD2C 5901 9574
>                                      6FE2 40EA 9883 7519 3F88
>                             key id = 0x75193F88
>
>

--0000000000008217df05b82acbc8
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div>Can you try &#39;mkdir&#39; manually beforehand to cr=
eate the desired &#39;/usr/share/perl6/site/doc&#39; directory, then run &#=
39;zef install p6doc&#39; ?</div><div><br></div><div>Just wondering... . I =
note your other comments with great interest.<br></div><div><br></div><div>=
Best, Bill.<br></div></div><br><div class=3D"gmail_quote"><div dir=3D"ltr" =
class=3D"gmail_attr">On Tue, Jan 5, 2021 at 9:02 AM Gianni Ceccarelli &lt;<=
a href=3D"mailto:dakkar@thenautilus.net">dakkar@thenautilus.net</a>&gt; wro=
te:<br></div><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px =
0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On 2021-01-0=
5 William Michels via perl6-users &lt;<a href=3D"mailto:perl6-users@perl.or=
g" target=3D"_blank">perl6-users@perl.org</a>&gt;<br>
wrote:<br>
&gt; Raiph&#39;s suggestion works for me (on rakudo-2020.10). I mean, p6doc=
<br>
&gt; installs<br>
<br>
Oh, that points to new, different, problems.<br>
<br>
<a href=3D"https://modules.raku.org/search/?q=3Dp6doc" rel=3D"noreferrer" t=
arget=3D"_blank">https://modules.raku.org/search/?q=3Dp6doc</a> links to<br=
>
<a href=3D"https://github.com/Raku/doc" rel=3D"noreferrer" target=3D"_blank=
">https://github.com/Raku/doc</a> which does not contain a ``p6doc`` script=
,<br>
which means that what I get with ``zef install p6doc`` is not the same<br>
thing (this is a general problem with pointing at repositories instead<br>
of distribution artifacts, it&#39;s not specific to p6doc)<br>
<br>
Then, ``zef install p6doc`` fails here, because::<br>
<br>
=C2=A0 Failed to create directory &#39;/usr/share/perl6/site/doc&#39; with =
mode<br>
=C2=A0 &#39;0o777&#39;: Failed to mkdir: Permission denied<br>
<br>
AIUI, distributions should install to the CompUnit::Repository in my<br>
home directory, not into the system-wide one.<br>
<br>
-- <br>
=C2=A0 =C2=A0 =C2=A0 =C2=A0 Dakkar - &lt;Mobilis in mobile&gt;<br>
=C2=A0 =C2=A0 =C2=A0 =C2=A0 GPG public key fingerprint =3D A071 E618 DD2C 5=
901 9574<br>
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A06FE2 40EA 9883 7=
519 3F88<br>
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=
=A0 =C2=A0 =C2=A0 =C2=A0 key id =3D 0x75193F88<br>
<br>
</blockquote></div>

--0000000000008217df05b82acbc8--
0
perl6
1/5/2021 5:46:30 PM
--------------096B7384250E9AD7B96AC102
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 8bit

We have a Google Summer of Code project to work on rakudoc, and the 
latest version of rakudoc points to "noisgul" 's repo.

But ... rakudo aka p6doc was intended to work in the same way as perldoc.

At the time the p6doc project was started, there was actually very 
little documentation, so most of the energy of people interested in 
documentation was on getting Perl 6 / Raku documented. As projects 
evolved, the best way to access the documentation turned out to be via 
the website.

Work on rakudoc languished because for most people, looking on line was 
easier and quicker than looking for installed modules.

There REMAINS a need for a tool to look at the documentation associated 
with installed modules. That documentation exists if it is contained in 
the distribution that zef installs. As Vadim said Raku can robustly keep 
multiple versions of the same Module differing by version number and 
author fork. So in principle, if the Module is there, so is the 
documentation. But rakudoc does not access that information.

So rakudoc does not do what you might think it should.

On 05/01/2021 17:41, JJ Merelo wrote:
> Yep, there are a couple of (known) issues here: 
> https://github.com/Raku/problem-solving/issues/252 
> <https://github.com/Raku/problem-solving/issues/252> which request to 
> remove it from the ecosystem (and I'll probably do it when I finish 
> this email), and this one https://github.com/Raku/doc/issues/2896 
> <https://github.com/Raku/doc/issues/2896> Build.pm does not really 
> work now, to it should probably be removed. And if it is, there's 
> actually nothing to "install" so it should be removed.
> Maybe we should work first on releasing rakudoc. Let me see if we can 
> do that soon-ish or it requires a lot of work. And in any case we will 
> probably encourage people to use the online version of the 
> documentation (or to build it themselves via Documentable)
>
> Thanks anyways for the checks, cheers
>
> El mar, 5 ene 2021 a las 18:02, Gianni Ceccarelli 
> (<dakkar@thenautilus.net <mailto:dakkar@thenautilus.net>>) escribió:
>
>     On 2021-01-05 William Michels via perl6-users
>     <perl6-users@perl.org <mailto:perl6-users@perl.org>>
>     wrote:
>     > Raiph's suggestion works for me (on rakudo-2020.10). I mean, p6doc
>     > installs
>
>     Oh, that points to new, different, problems.
>
>     https://modules.raku.org/search/?q=p6doc
>     <https://modules.raku.org/search/?q=p6doc> links to
>     https://github.com/Raku/doc <https://github.com/Raku/doc> which
>     does not contain a ``p6doc`` script,
>     which means that what I get with ``zef install p6doc`` is not the same
>     thing (this is a general problem with pointing at repositories instead
>     of distribution artifacts, it's not specific to p6doc)
>
>     Then, ``zef install p6doc`` fails here, because::
>
>       Failed to create directory '/usr/share/perl6/site/doc' with mode
>       '0o777': Failed to mkdir: Permission denied
>
>     AIUI, distributions should install to the CompUnit::Repository in my
>     home directory, not into the system-wide one.
>
>     -- 
>             Dakkar - <Mobilis in mobile>
>             GPG public key fingerprint = A071 E618 DD2C 5901 9574
>                                          6FE2 40EA 9883 7519 3F88
>                                 key id = 0x75193F88
>
>
>
> -- 
> JJ

--------------096B7384250E9AD7B96AC102
Content-Type: text/html; charset=utf-8
Content-Transfer-Encoding: 8bit

<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  </head>
  <body>
    <p>We have a Google Summer of Code project to work on rakudoc, and
      the latest version of rakudoc points to "noisgul" 's repo.</p>
    <p>But ... rakudo aka p6doc was intended to work in the same way as
      perldoc. <br>
    </p>
    <p>At the time the p6doc project was started, there was actually
      very little documentation, so most of the energy of people
      interested in documentation was on getting Perl 6 / Raku 
      documented. As projects evolved, the best way to access the
      documentation turned out to be via the website.</p>
    <p>Work on rakudoc languished because for most people, looking on
      line was easier and quicker than looking for installed modules.<br>
    </p>
    <p>There REMAINS a need for a tool to look at the documentation
      associated with installed modules. That documentation exists if it
      is contained in the distribution that zef installs. As Vadim said
      Raku can robustly keep multiple versions of the same Module
      differing by version number and author fork. So in principle, if
      the Module is there, so is the documentation. But rakudoc does not
      access that information.</p>
    <p>So rakudoc does not do what you might think it should. <br>
    </p>
    <div class="moz-cite-prefix">On 05/01/2021 17:41, JJ Merelo wrote:<br>
    </div>
    <blockquote type="cite"
cite="mid:CAJoLtgesRKynuBGNKmJptkjco_Ojf8GNjVMnsdnK+6yX939yFg@mail.gmail.com">
      <meta http-equiv="content-type" content="text/html; charset=UTF-8">
      <div dir="ltr">
        <div>Yep, there are a couple of (known) issues here: <a
            href="https://github.com/Raku/problem-solving/issues/252"
            moz-do-not-send="true">https://github.com/Raku/problem-solving/issues/252</a>
          which request to remove it from the ecosystem (and I'll
          probably do it when I finish this email), and this one <a
            href="https://github.com/Raku/doc/issues/2896"
            moz-do-not-send="true">https://github.com/Raku/doc/issues/2896</a>
          Build.pm does not really work now, to it should probably be
          removed. And if it is, there's actually nothing to "install"
          so it should be removed.</div>
        <div>Maybe we should work first on releasing rakudoc. Let me see
          if we can do that soon-ish or it requires a lot of work. And
          in any case we will probably encourage people to use the
          online version of the documentation (or to build it themselves
          via Documentable)</div>
        <div><br>
        </div>
        <div>Thanks anyways for the checks, cheers<br>
        </div>
      </div>
      <br>
      <div class="gmail_quote">
        <div dir="ltr" class="gmail_attr">El mar, 5 ene 2021 a las
          18:02, Gianni Ceccarelli (&lt;<a
            href="mailto:dakkar@thenautilus.net" moz-do-not-send="true">dakkar@thenautilus.net</a>&gt;)
          escribió:<br>
        </div>
        <blockquote class="gmail_quote" style="margin:0px 0px 0px
          0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On
          2021-01-05 William Michels via perl6-users &lt;<a
            href="mailto:perl6-users@perl.org" target="_blank"
            moz-do-not-send="true">perl6-users@perl.org</a>&gt;<br>
          wrote:<br>
          &gt; Raiph's suggestion works for me (on rakudo-2020.10). I
          mean, p6doc<br>
          &gt; installs<br>
          <br>
          Oh, that points to new, different, problems.<br>
          <br>
          <a href="https://modules.raku.org/search/?q=p6doc"
            rel="noreferrer" target="_blank" moz-do-not-send="true">https://modules.raku.org/search/?q=p6doc</a>
          links to<br>
          <a href="https://github.com/Raku/doc" rel="noreferrer"
            target="_blank" moz-do-not-send="true">https://github.com/Raku/doc</a>
          which does not contain a ``p6doc`` script,<br>
          which means that what I get with ``zef install p6doc`` is not
          the same<br>
          thing (this is a general problem with pointing at repositories
          instead<br>
          of distribution artifacts, it's not specific to p6doc)<br>
          <br>
          Then, ``zef install p6doc`` fails here, because::<br>
          <br>
            Failed to create directory '/usr/share/perl6/site/doc' with
          mode<br>
            '0o777': Failed to mkdir: Permission denied<br>
          <br>
          AIUI, distributions should install to the CompUnit::Repository
          in my<br>
          home directory, not into the system-wide one.<br>
          <br>
          -- <br>
                  Dakkar - &lt;Mobilis in mobile&gt;<br>
                  GPG public key fingerprint = A071 E618 DD2C 5901 9574<br>
                                               6FE2 40EA 9883 7519 3F88<br>
                                      key id = 0x75193F88<br>
          <br>
        </blockquote>
      </div>
      <br clear="all">
      <br>
      -- <br>
      <div dir="ltr" class="gmail_signature">JJ</div>
    </blockquote>
  </body>
</html>

--------------096B7384250E9AD7B96AC102--
0
rnhainsworth
1/6/2021 4:24:49 PM
--000000000000e2604b05b840df20
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

In the Perl world, I use perldoc all the time to view the exact
documentation for the installed module I=E2=80=99m working with. And on a r=
egular
basis, it=E2=80=99s useful for me to inspect the source code of the install=
ed
modules.

I have been going through quite a few contortions to look at the source
code for installed modules in raku, and would very much like rakudoc to
have an option similarly to perldoc -l showing the cached path and hashed
local file names of installed modules.

On Wed, Jan 6, 2021 at 11:25 AM Richard Hainsworth <rnhainsworth@gmail.com>
wrote:

> We have a Google Summer of Code project to work on rakudoc, and the lates=
t
> version of rakudoc points to "noisgul" 's repo.
>
> But ... rakudo aka p6doc was intended to work in the same way as perldoc.
>
> At the time the p6doc project was started, there was actually very little
> documentation, so most of the energy of people interested in documentatio=
n
> was on getting Perl 6 / Raku  documented. As projects evolved, the best w=
ay
> to access the documentation turned out to be via the website.
>
> Work on rakudoc languished because for most people, looking on line was
> easier and quicker than looking for installed modules.
>
> There REMAINS a need for a tool to look at the documentation associated
> with installed modules. That documentation exists if it is contained in t=
he
> distribution that zef installs. As Vadim said Raku can robustly keep
> multiple versions of the same Module differing by version number and auth=
or
> fork. So in principle, if the Module is there, so is the documentation. B=
ut
> rakudoc does not access that information.
>
> So rakudoc does not do what you might think it should.
> On 05/01/2021 17:41, JJ Merelo wrote:
>
> Yep, there are a couple of (known) issues here:
> https://github.com/Raku/problem-solving/issues/252 which request to
> remove it from the ecosystem (and I'll probably do it when I finish this
> email), and this one https://github.com/Raku/doc/issues/2896 Build.pm
> does not really work now, to it should probably be removed. And if it is,
> there's actually nothing to "install" so it should be removed.
> Maybe we should work first on releasing rakudoc. Let me see if we can do
> that soon-ish or it requires a lot of work. And in any case we will
> probably encourage people to use the online version of the documentation
> (or to build it themselves via Documentable)
>
> Thanks anyways for the checks, cheers
>
> El mar, 5 ene 2021 a las 18:02, Gianni Ceccarelli (<dakkar@thenautilus.ne=
t>)
> escribi=C3=B3:
>
>> On 2021-01-05 William Michels via perl6-users <perl6-users@perl.org>
>> wrote:
>> > Raiph's suggestion works for me (on rakudo-2020.10). I mean, p6doc
>> > installs
>>
>> Oh, that points to new, different, problems.
>>
>> https://modules.raku.org/search/?q=3Dp6doc links to
>> https://github.com/Raku/doc which does not contain a ``p6doc`` script,
>> which means that what I get with ``zef install p6doc`` is not the same
>> thing (this is a general problem with pointing at repositories instead
>> of distribution artifacts, it's not specific to p6doc)
>>
>> Then, ``zef install p6doc`` fails here, because::
>>
>>   Failed to create directory '/usr/share/perl6/site/doc' with mode
>>   '0o777': Failed to mkdir: Permission denied
>>
>> AIUI, distributions should install to the CompUnit::Repository in my
>> home directory, not into the system-wide one.
>>
>> --
>>         Dakkar - <Mobilis in mobile>
>>         GPG public key fingerprint =3D A071 E618 DD2C 5901 9574
>>                                      6FE2 40EA 9883 7519 3F88
>>                             key id =3D 0x75193F88
>>
>>
>
> --
> JJ
>
> --
-y

--000000000000e2604b05b840df20
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"auto">In the Perl world, I use perldoc all the time to view the=
 exact documentation for the installed module I=E2=80=99m working with. And=
 on a regular basis, it=E2=80=99s useful for me to inspect the source code =
of the installed modules.</div><div dir=3D"auto"><br></div><div dir=3D"auto=
">I have been going through quite a few contortions to look at the source c=
ode for installed modules in raku, and would very much like rakudoc to have=
 an option similarly to perldoc -l showing the cached path and hashed local=
 file names of installed modules.</div><div><br><div class=3D"gmail_quote">=
<div dir=3D"ltr" class=3D"gmail_attr">On Wed, Jan 6, 2021 at 11:25 AM Richa=
rd Hainsworth &lt;<a href=3D"mailto:rnhainsworth@gmail.com">rnhainsworth@gm=
ail.com</a>&gt; wrote:<br></div><blockquote class=3D"gmail_quote" style=3D"=
margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
 =20
   =20
 =20
  <div>
    <p>We have a Google Summer of Code project to work on rakudoc, and
      the latest version of rakudoc points to &quot;noisgul&quot; &#39;s re=
po.</p>
    <p>But ... rakudo aka p6doc was intended to work in the same way as
      perldoc. <br>
    </p>
    <p>At the time the p6doc project was started, there was actually
      very little documentation, so most of the energy of people
      interested in documentation was on getting Perl 6 / Raku=C2=A0
      documented. As projects evolved, the best way to access the
      documentation turned out to be via the website.</p>
    <p>Work on rakudoc languished because for most people, looking on
      line was easier and quicker than looking for installed modules.<br>
    </p>
    <p>There REMAINS a need for a tool to look at the documentation
      associated with installed modules. That documentation exists if it
      is contained in the distribution that zef installs. As Vadim said
      Raku can robustly keep multiple versions of the same Module
      differing by version number and author fork. So in principle, if
      the Module is there, so is the documentation. But rakudoc does not
      access that information.</p>
    <p>So rakudoc does not do what you might think it should. <br>
    </p></div><div>
    <div>On 05/01/2021 17:41, JJ Merelo wrote:<br>
    </div>
    <blockquote type=3D"cite">
     =20
      <div dir=3D"ltr">
        <div>Yep, there are a couple of (known) issues here: <a href=3D"htt=
ps://github.com/Raku/problem-solving/issues/252" target=3D"_blank">https://=
github.com/Raku/problem-solving/issues/252</a>
          which request to remove it from the ecosystem (and I&#39;ll
          probably do it when I finish this email), and this one <a href=3D=
"https://github.com/Raku/doc/issues/2896" target=3D"_blank">https://github.=
com/Raku/doc/issues/2896</a>
          Build.pm does not really work now, to it should probably be
          removed. And if it is, there&#39;s actually nothing to &quot;inst=
all&quot;
          so it should be removed.</div>
        <div>Maybe we should work first on releasing rakudoc. Let me see
          if we can do that soon-ish or it requires a lot of work. And
          in any case we will probably encourage people to use the
          online version of the documentation (or to build it themselves
          via Documentable)</div>
        <div><br>
        </div>
        <div>Thanks anyways for the checks, cheers<br>
        </div>
      </div>
      <br>
      <div class=3D"gmail_quote">
        <div dir=3D"ltr" class=3D"gmail_attr">El mar, 5 ene 2021 a las
          18:02, Gianni Ceccarelli (&lt;<a href=3D"mailto:dakkar@thenautilu=
s.net" target=3D"_blank">dakkar@thenautilus.net</a>&gt;)
          escribi=C3=B3:<br>
        </div>
        <blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex=
;border-left:1px solid rgb(204,204,204);padding-left:1ex">On
          2021-01-05 William Michels via perl6-users &lt;<a href=3D"mailto:=
perl6-users@perl.org" target=3D"_blank">perl6-users@perl.org</a>&gt;<br>
          wrote:<br>
          &gt; Raiph&#39;s suggestion works for me (on rakudo-2020.10). I
          mean, p6doc<br>
          &gt; installs<br>
          <br>
          Oh, that points to new, different, problems.<br>
          <br>
          <a href=3D"https://modules.raku.org/search/?q=3Dp6doc" rel=3D"nor=
eferrer" target=3D"_blank">https://modules.raku.org/search/?q=3Dp6doc</a>
          links to<br>
          <a href=3D"https://github.com/Raku/doc" rel=3D"noreferrer" target=
=3D"_blank">https://github.com/Raku/doc</a>
          which does not contain a ``p6doc`` script,<br>
          which means that what I get with ``zef install p6doc`` is not
          the same<br>
          thing (this is a general problem with pointing at repositories
          instead<br>
          of distribution artifacts, it&#39;s not specific to p6doc)<br>
          <br>
          Then, ``zef install p6doc`` fails here, because::<br>
          <br>
          =C2=A0 Failed to create directory &#39;/usr/share/perl6/site/doc&=
#39; with
          mode<br>
          =C2=A0 &#39;0o777&#39;: Failed to mkdir: Permission denied<br>
          <br>
          AIUI, distributions should install to the CompUnit::Repository
          in my<br>
          home directory, not into the system-wide one.<br>
          <br>
          -- <br>
          =C2=A0 =C2=A0 =C2=A0 =C2=A0 Dakkar - &lt;Mobilis in mobile&gt;<br=
>
          =C2=A0 =C2=A0 =C2=A0 =C2=A0 GPG public key fingerprint =3D A071 E=
618 DD2C 5901 9574<br>
          =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A06FE2 4=
0EA 9883 7519 3F88<br>
          =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 key id =3D 0x75193F88<br>
          <br>
        </blockquote>
      </div>
      <br clear=3D"all">
      <br>
      -- <br>
      <div dir=3D"ltr">JJ</div>
    </blockquote>
  </div>

</blockquote></div></div>-- <br><div dir=3D"ltr" class=3D"gmail_signature" =
data-smartmail=3D"gmail_signature">-y<br></div>

--000000000000e2604b05b840df20--
0
not
1/6/2021 8:07:25 PM
On 2021-01-06 yary <not.com@gmail.com> wrote:
> I have been going through quite a few contortions to look at the
> source code for installed modules in raku, and would very much like
> rakudoc to have an option similarly to perldoc -l showing the cached
> path and hashed local file names of installed modules.


zef does that::

   $ zef locate Zef
   ===> From Distribution: zef:ver<0.8.4>:auth<github:ugexe>:api<0>
   Zef => /home/dakkar/.raku/sources/65C34BD7E4A3F74D2F2637DFFF9507F33639635A

-- 
	Dakkar - <Mobilis in mobile>
	GPG public key fingerprint = A071 E618 DD2C 5901 9574
	                             6FE2 40EA 9883 7519 3F88
	                    key id = 0x75193F88

0
dakkar
1/6/2021 8:38:49 PM
Reply: