Skip to content

level-3.adoc lists three Level 2 operators as new in Level 3 #10

Closed

Description

@HassanAkbar

docs/levels/level-3.adoc ("New Operators") lists these as additions in LanguageLevel 3:

  • setblackgeneration, setundercolorremoval ("Color control")
  • sethalftone ("improvements")

According to the PostScript Language Reference Manual, 3rd ed. (Appendix A.2), all three are LanguageLevel 2 operators. setblackgeneration and setundercolorremoval also existed earlier, as part of the Level 1 CMYK color extension.

Suggested fix: move them to level-2.adoc, or say on level-3.adoc what actually changed in Level 3 instead of listing them as new operators.

Context: claricle/postscript reads operator levels from these pages (claricle/postscript#4). For these three it uses the PLRM level instead, in data/operator_overrides.yml, and each entry's reason links back here.

Activity

  1. HassanAkbar commented on Oct 23, 2026

    @HassanAkbar
    MemberAuthor

    Fixed in #13, now on main.

    • docs/levels/level-3.adoc: the "New Operators" list no longer includes setblackgeneration, setundercolorremoval or sethalftone. It now lists only operators that really are new in Level 3 (shfill, setsmoothness, and the image masking, DeviceN and trapping operator groups).
    • docs/levels/level-2.adoc: the "New Operators" list now includes sethalftone, setblackgeneration and setundercolorremoval under halftone and color-rendering control, as PLRM 3rd ed. Appendix A.2 has them.

    The levels pages now agree with the PLRM for these three operators. The matching entries in claricle/postscript's data/operator_overrides.yml can be removed the next time that data is regenerated from these pages.

    Closing.

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