Documentation Channel for #raku | This channel is logged | Roadmap: github.com/raku/doc/wiki Set by [Coke] on 23 May 2022. |
|||
00:42
wayland joined
|
|||
wayland | Hi all! I'm working on a reorg of this section at the moment: docs.raku.org/language/modules#Manually | 00:43 | |
00:48
[Coke]_ joined
00:50
[Coke] left
01:09
SmokeMachine joined
|
|||
SmokeMachine | wayland: thanks | 01:10 | |
wayland | SmokeMachine: No worries :) | 01:12 | |
Not sure where this needs to be reported, but when I run the following command, there should be an error and there isn't: raku --rakudoc=aerhg doc/Language/modules.rakudoc | 02:18 | ||
07:03
wayland left,
wayland76 joined
09:54
wayland76 left
09:56
wayland76 joined
12:21
[Coke]_ is now known as [Coke]
|
|||
[Coke] | that's a rakudo bug. | 12:22 | |
can you submit that with a comparison of raku --doc=aerhg foo? | 12:23 | ||
wayland76 | When I try to run "make test" on the documentation, I get "Could not find Test-Files". I can't find a module to install for that. Any tips as to what I need to do? | 12:34 | |
I've just tested on latest (well, nightly from last week), and if I use --doc, it gives me the correct error, but if I use --rakudoc, it doesn't error. My question is why we have both --doc and --rakudoc (ie. should I be instead saying "Get rid of rakudoc")? | 12:42 | ||
[Coke] | one is for rakudoc v2 | 12:52 | |
I have to defer to lizmat and finanalyst on that question | 12:53 | ||
I think eventually we'll just have one. | |||
(note that each one is picking from a different class hierarchy, btw.) | |||
wayland76: try "RAKULIB=. make xtest" | 12:54 | ||
apologies, I was cleaning up the repo at some point and perhaps didn't leave it quite right. :( | 12:55 | ||
a patch which adds that RAKULIB env var setting to the makefile for test and xtest appreciated. | |||
ah, also please read writing-docs/TESTING.md | 14:00 | ||
14:56
wayland joined
14:57
wayland76 left
15:01
finanalyst joined
16:12
finanalyst left
|
|||
[Coke] | so, I take that back on the makefile change - you can either install the deps (as per the .md) or you can set RAKULIB=. yourself | 16:26 | |
18:41
finanalyst joined
19:41
finanalyst left
|
|||
[Coke] | If anyone has opinions on my and tbrowder's disagreement in github.com/Raku/doc/issues/4569#is...831297781, please chime in on the ticket. | 22:19 | |
wayland | [Coke]: On the different rakudoc versions, that makes sense. | 22:52 | |
[Coke]: On "Read the Fine Manual", thanks, that got me going :) | |||
Geth | doc/main: 044b4a01ea | (Will Coleda)++ | 2 files Clarify some text around dies-ok & run Part of #4569 |
22:53 | |
[Coke] | wayland: I honestly forgot I wrote that down | 22:56 | |
I was going in there to *add* it when I saw I already had. :) | |||
23:12
wayland76 joined
|
|||
wayland76 | OK, as recommended by the docs, I ran "util/test-modified.sh" and it has two problems. | 23:12 | |
1. t/00-meta.rakutest ................ # required attribute 'perl-version' is not defined | 23:13 | ||
23:14
wayland left
|
|||
wayland76 | 2. I think it's been stuck on "xt/01-raku-version.rakutest" for a good 5-10 minutes; is that normal? | 23:14 | |
Btw, is it a known thing that our results in Google suddenly became a lot less useful-looking about a month ago? | 23:35 | ||
It might be a robots.txt entry that's doing it. | 23:36 |