Skip to content

docs: update documentation to reflect DESTROY/weaken support#483

Merged
fglock merged 2 commits intomasterfrom
docs/destroy-weaken-support
Apr 10, 2026
Merged

docs: update documentation to reflect DESTROY/weaken support#483
fglock merged 2 commits intomasterfrom
docs/destroy-weaken-support

Conversation

@fglock
Copy link
Copy Markdown
Owner

@fglock fglock commented Apr 10, 2026

Summary

Update all documentation to reflect that DESTROY and weaken/isweak/unweaken are now supported (merged in PR #464).

  • changelog.md: Move DESTROY/weaken from "Work in Progress" to released features
  • feature-matrix.md: Mark DESTROY as supported, remove from "Not Supported" and "Incompatible with JVM" lists
  • roadmap.md: Strike through DESTROY and Weak References as completed
  • relation-perlito.md: Update JVM limitations paragraph
  • AGENTS.md: Remove "on feature/destroy-weaken branch" qualifier
  • blog post README: Update Moo results from 809/840 to 841/841

Test plan

  • make passes (docs-only change, no code modified)

Generated with Devin

DESTROY and weaken/isweak/unweaken are now implemented (PR #464 merged).
Update all documentation that previously listed these as unsupported:

- changelog.md: move from WIP to released features
- feature-matrix.md: mark DESTROY as supported, remove from unsupported list
- roadmap.md: mark DESTROY and weak references as completed
- relation-perlito.md: update JVM limitations paragraph
- AGENTS.md: remove "on feature/destroy-weaken branch" qualifier
- blog post README: update Moo results to 841/841

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

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@fglock fglock force-pushed the docs/destroy-weaken-support branch from f80b864 to f68479a Compare April 10, 2026 18:54
- Verify all 6 architecture docs + README against source code
- Fix wrong file paths in control-flow.md (packages reorganized)
- Add missing RETURN control flow type and non-local map/grep return
- Remove all stale TABLESWITCH references (actual: conditional branches)
- Rewrite large-code-refactoring.md: was describing non-existent retry
  architecture; now documents actual two-tier strategy (proactive block
  refactoring + interpreter fallback)
- Fix lexical-pragmas.md: wrong stack types, non-existent StrictOptions
  class, missing warning stacks and CompilerFlagNode fields
- Fix dynamic-scope.md: wrong DeferBlock types, missing implementors,
  missing blessId/reset-to-undef in save
- Fix block-dispatcher-optimization.md: wrong per-site bytecode size,
  missing Dereference.java as implementation file
- Fix weaken-destroy.md: wrong pop/shift deferred decrement claim,
  wrong code ref birth-tracking path, wrong type check order
- Update inline-cache.md and method-call-optimization.md status:
  inline caching IS implemented in RuntimeCode.java
- Move unimplemented design docs to dev/design/
- Add dev/architecture/ to make check-links target
- Fix 2 broken doc links (warnings-scope.md -> lexical-warnings.md)
- Fix 3 stale Java code comments (WeakRefRegistry, RuntimeScalar,
  DestroyDispatch)
- Add RuntimeList, org.perlonjava.app to README overview
- All links clean (368 checked, 0 errors), make passes

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 2ee932f into master Apr 10, 2026
2 checks passed
@fglock fglock deleted the docs/destroy-weaken-support branch April 10, 2026 19:54
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