Skip to content

docs: create dev/modules/ for CPAN module porting documentation#391

Merged
fglock merged 2 commits into
masterfrom
docs/module-porting-reorganization
Mar 27, 2026
Merged

docs: create dev/modules/ for CPAN module porting documentation#391
fglock merged 2 commits into
masterfrom
docs/module-porting-reorganization

Conversation

@fglock
Copy link
Copy Markdown
Owner

@fglock fglock commented Mar 27, 2026

Summary

  • Create new dev/modules/ directory for module porting documentation
  • Move 12 module-related docs from dev/design/ to dev/modules/
  • Add new moose_support.md documenting path to Moose support
  • Add dev/modules/README.md with module status overview

Moved Files

File Description
cpan_client.md jcpan CPAN client
makemaker_perlonjava.md MakeMaker implementation
xs_fallback.md XS fallback mechanism
xsloader.md XSLoader architecture
dynaloader.md DynaLoader architecture
dynamic_loading.md Dynamic module loading
moo_support.md Moo support (working)
moose_support.md Moose support (new)
log4perl-compatibility.md Log4perl
term_readkey.md Term::ReadKey
pure-perl-exporter.md Pure Perl Exporter
JCPAN_DATETIME_FIXES.md DateTime fixes

New: Moose Support Investigation

The new moose_support.md documents:

  • Root cause: B module returns __ANON__ for named subroutines
  • Alternative: Moo works (96% tests pass)
  • 5-phase plan to enable Moose support

Test Plan

  • make passes
  • make check-links passes

Generated with Devin

fglock and others added 2 commits March 27, 2026 18:19
- Create new dev/modules/ directory for module porting docs
- Move 12 module-related docs from dev/design/ to dev/modules/:
  - cpan_client.md, makemaker_perlonjava.md
  - xs_fallback.md, xsloader.md, dynaloader.md, dynamic_loading.md
  - moo_support.md, log4perl-compatibility.md, term_readkey.md
  - pure-perl-exporter.md, JCPAN_DATETIME_FIXES.md
- Add moose_support.md documenting path to Moose support
  - Root cause: B module returns __ANON__ for named subs
  - Moo works as alternative (96% tests pass)
  - Outlines 5-phase implementation plan
- Add dev/modules/README.md with module status overview
- Update dev/README.md and dev/design/README.md with cross-references

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 force-pushed the docs/module-porting-reorganization branch from f4ee10e to a133886 Compare March 27, 2026 17:20
@fglock fglock merged commit e35d354 into master Mar 27, 2026
2 checks passed
@fglock fglock deleted the docs/module-porting-reorganization branch March 27, 2026 17:20
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