Document the fact that array/push is variadic.

[pepe]

I just found this on repl by accident:

Janet 1.30.0-43a6a70e linux/x64/gcc - '(doc)' for help
repl:1:> (array/push @[] :a :b)
@[:a :b]
repl:2:> array/push


    cfunction
    src/core/array.c on line 179, column 1

    (array/push arr x)
    
    Insert an element in the end of an array. Modifies the input array and returns it.

And I like it, so let's just document that x is actually a variadic argument.

[sogaiu]

Oh nice. Had no idea.

[primo-ppcg]

Used, for example, in interpose 😉

janet/src/boot/boot.janet

Lines 1726 to 1730 in a13aeaf

	(do
	(def ret @[(in ind k)])
	(while (not= nil (set k (next ind k)))
	(array/push ret sep (in ind k)))
	ret))

[pepe]

@primo-ppcg flies higher as always :-D.

[sogaiu]

@pepe So will you make a PR?

I guess at least these lines are involved:

              "(array/push arr x)",
              "Insert an element in the end of an array. Modifies the input array and returns it.") {

Possibly of use is to look at what the docstring is for buffer/push:

    (buffer/push buffer & xs)

    Push both individual bytes and byte sequences to a buffer. For each 
    x in xs, push the byte if x is an integer, otherwise push the 
    bytesequence to the buffer. Thus, this function behaves like both 
    `buffer/push-string` and `buffer/push-byte`. Returns the modified 
    buffer. Will throw an error if the buffer overflows.

[pepe]

I should, but today I am not by the computer.