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