docs: modernize Parser.pm POD with supported constructs reference#42
Draft
toddr-bot wants to merge 1 commit intocpan-authors:mainfrom
Draft
docs: modernize Parser.pm POD with supported constructs reference#42toddr-bot wants to merge 1 commit intocpan-authors:mainfrom
toddr-bot wants to merge 1 commit intocpan-authors:mainfrom
Conversation
… sections Replace the EXTENSIONS section (hypothetical modules from 2004 that were never built) and HISTORY section (ancient changelog duplicated in Changes) with a comprehensive SUPPORTED CONSTRUCTS reference listing all parsed regex syntax. Document the named_captures() method. Clean up CAVEATS to document the two-pass parsing model and opaque constructs. Net effect: ~150 lines of dead weight removed, replaced with a useful quick-reference for users evaluating or using the module. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Replaces dead POD sections with a useful quick-reference of all supported regex constructs.
Why
The EXTENSIONS section listed hypothetical modules from 2004 that were never built. The HISTORY section duplicated the Changes file with 22-year-old changelog entries. Neither helped users understand what the module actually supports today.
How
named_captures()method (was implemented but missing from POD)Net: -201 lines of dead weight, +76 lines of useful reference. No code changes.
Testing
podcheckerpasses cleanQuality Report
Changes: 1 file changed, 76 insertions(+), 201 deletions(-)
Code scan: clean
Tests: passed (OK)
Branch hygiene: clean
Generated by Kōan post-mission quality pipeline