Skip to content

⎕SYSTEM documentation errors #979

Description

@DyalogRichard

Page on which the error exists
https://docs.dyalog.com/21.0/language-reference-guide/system-functions/system/

Version of the documentation in which you are reporting the error
2026-08-04 main:bb74673d87

Describe the error
Review comments:

  • R will remain serialisable using 1⎕JSON
    • This is syntactically invalid. Without a right argument it should be 1∘⎕JSON. In any case, do we want to make that promise? We don't know what we might want to add, and once we have ⎕APLAN, we might not consider it important to retain the ability to serialise using ⎕JSON.
  • 64-bit operating systems can run 32-bit interpreters
    • This is not, in general, true. Most relevantly for us, 64-bit macOS cannot run 32-bit code (appears twice)
  • Whether (1) or not (0) PCRE2 is in use is given by 10≤⎕SYSTEM.Features.PCRE.
    • This is not a useful hint - remove it. Every interpreter which supports ⎕SYSTEM contains PCRE2
  • This can be converted to a character vector with ⎕UCS ⎕SYSTEM.OS.Newline.
    • No shit, Sherlock. An unneccessary admonition overload.
  • A positive number means the local time zone is ahead of UTC. A negative number means behind UTC. For example, if ⎕OS.UTCOffset is 10, then when it is noon UTC (12:00), it is 10 PM local time (12+10, that is, 22:00).
    • Ditto. Whereas it might be worth saying something about DST (preferably not as an admonition). Also, change the description to "The number of hours by which the current local time zone is offset from UTC" (addition of "current").
  • 1 0 1≡10 22000⍸⎕SYSTEM.OS.Version
    • This is wrong; 10.0.22000 is Windows 11 21H2. I believe that: 10.0.XXXXX indicates Windows 10 or Windows 11, and that XXXXX ≥ 22000 indicates Windows 11. But it's at Microsoft's whim and we shouldn't claim stuff we cannot be sure of.

Metadata

Metadata

Assignees

No one assigned

    Labels

    dyalog-v21.0-mustRelease: Dyalog v21.0 – new functionality that must be included before GAlang-ref-guideDocument: Dyalog APL Language Reference Guide

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions