[q-lang-users] Documentation of streams

[Rob H. <hub...@gm...>]

Dear Albert,

There have been some changes to streams recently (in Q7.1 and Q7.8).

=A711.8 says that the streams are defined by
    public type Stream =3D special const nil_stream, cons_stream X Xs;

However, the file <stream.q> no longer defines nil_stream,
cons_stream. Thus certain import statements don't work as expected,
e.g.
    from stream import nil_stream, cons_stream;

The section *does* mention that these are now built-in. Perhaps it
should be clarified that they are therefore not importable.

I always feel a bit bad about sending "bug" reports like this. So I
must add that Q is one of my few favourite languages, and that I think
the documentation is both comprehensive and very comprehensible.

Best wishes,
Rob.