00:20 ds7823 left
Geth doc/main: 48c4d28adf | schultzdavid++ (committed using GitHub Web editor) | doc/Language/control.rakudoc
In control.rakudoc, show how topicalization with `if` can be useful (#4672)

  * In control.rakudoc, show how topicalization with `if` can be useful, and add reference to `with`.
  (The example is inspired by Bruce Gray's lecture 'Raku for Beginners Part 2' from TPRC 2023.)
  * remove 'else' from example, and improve text a bit
02:02
doc/main: 3a50047086 | (Eric Forste)++ (committed using GitHub Web editor) | 2 files
regularize Mu's routine/sub/method headings (#4668)

  * regularized routine/sub/method headings in Mu.rakudoc
  * merged separate `take` & `defined` entries into routine take & routine defined
  * listing method before sub
  * move sub item from Any to Mu and merge with method item
02:03
doc/main: cfd86f847d | schultzdavid++ (committed using GitHub Web editor) | 4 files
New material on type captures; work on introduction and parameter separators; some fixes here and there (#4669)

  * Complete overhaul of section on double semicolon (;;) parameter separator in file Language/signatures.rakudoc
  * Expand section Type captures (adding text on coercion and constraints). Also various fixes.
  * correct definition of subset Even, and adjust output
  * clarify explanation re. Nil/is-default
  * further clarify difference between parameters and variables with default values when assigned Nil
... (17 more lines)
02:16
03:06 arkiuat left 03:09 arkiuat joined 03:13 arkiuat left 03:25 arkiuat joined 06:14 timo2 left 06:17 timo2 joined 06:55 arkiuat left 06:59 arkiuat joined 07:04 arkiuat left 07:23 arkiuat joined 07:28 arkiuat left 07:57 arkiuat joined 08:02 arkiuat left 08:30 arkiuat joined 08:35 arkiuat left 09:04 arkiuat joined 09:08 arkiuat left 09:31 arkiuat joined 09:36 arkiuat left 10:05 arkiuat joined 10:13 arkiuat left 10:32 arkiuat joined 10:37 arkiuat left 11:06 arkiuat joined 11:11 arkiuat left 11:33 arkiuat joined 11:40 arkiuat left 11:53 arkiuat joined 12:58 arkiuat left 13:11 arkiuat joined 13:15 arkiuat left 13:34 arkiuat joined 13:39 arkiuat left 13:57 arkiuat joined
arkiuat I don't think I have the ability to self-assign an issue, but if y'all want to assign github.com/Raku/doc/issues/4395 to me, I seem to have already started working on it. 15:04
Geth ¦ doc: coke assigned to arkiuat Issue @-sigiled options are not documented for `sub MAIN` github.com/Raku/doc/issues/4395 15:20
[Coke] assigned
arkiuat thanks! 15:22
lizmat Docs state: Returns a pseudo-random Num in the range 0..^1. 17:10
for "rand" 17:11
I think it's incorrect, as it does not appear to produce the value 0
so the doc should perhaps be; Returns a pseudo-random Num between 0 and 1 exclusive 17:13
this also removes the 0..^1 syntax from the explanation, because that may not be recognizable as such by newbies 17:14
[Coke] trying to find nqp::rand_n definition just to double check 17:15
lizmat "Returns a psuedo-random bigint up to the value of the given number"
[Coke] looks like the nqp docs have 3 versions there, I'm assuming that bigint text was not intended for the num version. (which it looks like rakudo uses in 'sub rand' 17:29
Geth doc/Range_method_new: 5edd606eb7 | (Timo Paulssen)++ | doc/Type/Range.rakudoc
Add documentation for method new in Range
17:31
[Coke] ah, found it: return ((jfs64_generate_uint64(tc->rand_state) >> 11) * (1.0 / 9007199254740992.0)); 17:32
Geth doc: timo++ created pull request #4676:
Add documentation for method new in Range
[Coke] ... I have no idea if that can return 0. :)
lizmat looks to me only if tc->rand_state produces 0 17:33
[Coke] I agree with the change to the docs, can someone whip up a commit or ticket or PR? 17:34
lizmat well... are we sure tc->rand_state cannot produce 0 ? 17:36
Geth doc/main: e648ccdf8d | timo++ (committed using GitHub Web editor) | doc/Type/Range.rakudoc
Add documentation for method new in Range (#4676)
lizmat hmm... I guess it *can* produce 0 in that case, judging from some research in C code 17:37
so I guess the doc is correct sorry for the noise 17:38
[Coke] I still like the edit to remove the ^ syntax. 17:39
or at least add a note there.
18:55 arkiuat left 19:09 arkiuat joined