Skip to content

docs: clean up stale DESTROY/refcount limitation claims#571

Merged
fglock merged 2 commits intomasterfrom
cleanup/destroy-refcount-docs
Apr 27, 2026
Merged

docs: clean up stale DESTROY/refcount limitation claims#571
fglock merged 2 commits intomasterfrom
cleanup/destroy-refcount-docs

Conversation

@fglock
Copy link
Copy Markdown
Owner

@fglock fglock commented Apr 27, 2026

Summary

Cleanup PR following the recent DESTROY / cooperative refcount work.

  • Unit tests: confirmed src/test/resources/unit/refcount/ (12 files) plus destroy.t, weaken.t, and destroy_zombie_captured_by_db_args.t already cover basic / inheritance / collections / eval-die / return / splice-args / anon-containers / two-step bless / weaken / weaken+destroy / weaken+edge-cases / destroy edge-cases. No additional test files are needed for the cleanup.
  • Stale "not implemented" claims removed from the public-facing presentation drafts:
    • dev/presentations/blogs_perl_org_jcpan_2026/blog-post.md — dropped the weaken / DESTROY bullet from the limitations list.
    • dev/presentations/German_Perl_Raku_Workshop_2026/slide-deck-plan.md — removed DESTROY (non-deterministic GC) from the "JVM-incompatible" bullet on Slide 34.
  • Terse status notes added in the same style as the surrounding entries:
    • docs/about/changelog.md — added a one-liner for Internals::SvREFCNT next to the existing DESTROY / weaken/isweak/unweaken entries.
    • docs/reference/feature-matrix.md — extended the existing DESTROY row under "Features Incompatible with JVM" to mention Internals::SvREFCNT introspection.
    • docs/about/roadmap.md — added Template and DBIx::Class next to Moo in the jcpan "working modules" bullet under Highlights.
  • CPAN reports: included the latest dev/cpan-reports/* snapshot from cpan_random_tester.pl (4109 modules tested, 1057 passing).

The docs/about/changelog.md, docs/reference/feature-matrix.md, and docs/about/roadmap.md already had the high-level DESTROY / weaken "Implemented" entries from when those features landed; this PR only fills in the SvREFCNT detail and adds the two new working CPAN modules.

Test plan

  • make (build + unit tests) — green
  • Rebased on top of latest master (b0e4cbfba)

Generated with Devin

fglock and others added 2 commits April 27, 2026 10:35
Recent commits implemented cooperative reference counting and DESTROY
support. Refresh the public-facing documentation accordingly:

- changelog: note the new `Internals::SvREFCNT` introspection helper
  alongside the existing DESTROY/weaken entries.
- feature-matrix: extend the "Features Incompatible with JVM" entry to
  mention `Internals::SvREFCNT`.
- roadmap: list `Template` and `DBIx::Class` next to `Moo` as known
  working CPAN modules under `jcpan`.
- presentations (blog post + German workshop slides): drop the obsolete
  "weaken/DESTROY not implemented" bullets — they are now implemented
  and tested in `src/test/resources/unit/refcount/`.

Also include the latest auto-generated `dev/cpan-reports/*` snapshot.

Generated with [Devin](https://cli.devin.ai/docs)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Generated with [Devin](https://cli.devin.ai/docs)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@fglock fglock merged commit e3dcb88 into master Apr 27, 2026
2 checks passed
@fglock fglock deleted the cleanup/destroy-refcount-docs branch April 27, 2026 08:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant