Skip to content

Add reference pages for 16 operators, including a relational/boolean category #9

Closed

Description

@HassanAkbar

These 16 operators have no reference page under docs/commands/:

  • Relational and boolean: and, eq, false, ge, gt, le, lt, ne, not, or, true, xor. The Guide has no relational/boolean command category at all.
  • Device and output: copypage, nulldevice, showpage
  • Font and text: xyshow

All are LanguageLevel 1 except xyshow, which is LanguageLevel 2 (PLRM 3rd ed., Appendix A).

Suggested fix: add a reference page for each, plus a relational/boolean category for the first group.

Context: claricle/postscript builds its operator vocabulary from the Guide's command pages (claricle/postscript#4). Until these pages exist, the gem supplies their categories and levels in data/operator_overrides.yml, and each entry's reason links back here.

Activity

  1. HassanAkbar commented on Oct 23, 2026

    @HassanAkbar
    MemberAuthor

    All 16 operators now have reference pages on main, added in #14:

    • Relational and boolean: and, eq, false, ge, gt, le, lt, ne, not, or, true, xor. They are grouped under a new Relational and Boolean category (docs/commands/relational-boolean/), which is linked from the commands index.
    • Device and output: copypage, nulldevice, showpage. All three are listed in the Device and Output category index.
    • Font and text: xyshow, listed in the Font and Text category index.

    Each page states its LanguageLevel. xyshow is LanguageLevel 2 and the other 15 are LanguageLevel 1, as in PLRM 3rd ed., Appendix A.

    Now that these pages exist, claricle/postscript can take these operators from the Guide. Their entries in data/operator_overrides.yml can then be removed in that repo.

    Closing as done.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions