Open
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the .NET regular expressions documentation to introduce and explain the new RegexOptions.AnyNewLine option (starting in .NET 11), including how it affects anchors and the . wildcard across common newline sequences.
Changes:
- Adds
RegexOptions.AnyNewLineto the options reference table and the “options that can’t be set inline” list. - Introduces a new “AnyNewLine mode” section with behavioral details and examples.
- Cross-links related docs (anchors and character classes) to describe how
$,\Z, and.behave underAnyNewLine.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| docs/standard/base-types/regular-expression-options.md | Documents RegexOptions.AnyNewLine, adds a new dedicated section, and updates option lists. |
| docs/standard/base-types/character-classes-in-regular-expressions.md | Notes how . changes under AnyNewLine and links back to the new mode section. |
| docs/standard/base-types/anchors-in-regular-expressions.md | Adds guidance for $ and \Z when using AnyNewLine instead of \r? workarounds. |
docs/standard/base-types/character-classes-in-regular-expressions.md
Outdated
Show resolved
Hide resolved
Add AnyNewLine mode section to Regular Expression Options article. Add tips/notes about AnyNewLine in: - Multiline mode section (as alternative to \r?\$ workaround) - Anchors doc (\$ and \Z sections) - Character classes doc (Any character: . section) - Quick reference (options table) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
danmoseley
force-pushed
the
anynewline-docs
branch
from
4997e15 to
4e793e8
Compare
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Adds documentation for the new RegexOptions.AnyNewLine behavior across the core regex conceptual articles, explaining how it changes newline handling for anchors and the . wildcard.
Changes:
- Documents
RegexOptions.AnyNewLinein the options reference table and option-setting guidance. - Adds a dedicated “AnyNewLine mode” section with examples and a behavior summary table.
- Updates anchor and character class docs to reference
AnyNewLineand link to the new section.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.
| File | Description |
|---|---|
| docs/standard/base-types/regular-expression-options.md | Adds AnyNewLine to the options list, introduces a new section describing its semantics, and adds examples/table. |
| docs/standard/base-types/character-classes-in-regular-expressions.md | Notes how AnyNewLine changes . behavior and precedence with Singleline. |
| docs/standard/base-types/anchors-in-regular-expressions.md | Notes how AnyNewLine changes $ and \Z behavior vs \r? workarounds. |
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Member
Author
|
red because links need merge of dotnet/dotnet-api-docs#12405 |
gewarren
approved these changes
Mar 18, 2026
Member
Author
|
@copilot fix feedback |
Apply gewarren's suggestion to align table columns for readability. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Clarifies that the . behavior described applies without Singleline, consistent with how other rows qualify their mode. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
gewarren
added
the
🚧 Hold for related PR
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
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.
Document the new
RegexOptions.AnyNewLineoption in conceptual docs, shipping in .NET 11 Preview 3.Changes
regular-expression-options.md[!TIP]in the Multiline mode section pointing toAnyNewLineas an alternative to the\r?$workaroundanchors-in-regular-expressions.mdAnyNewLineas an alternative to\r?$AnyNewLineas an alternative to\r?\Zcharacter-classes-in-regular-expressions.mdAnyNewLineeffect on.Context
AnyNewLinemakes^,$,\Z, and.recognize all Unicode newline sequences (\r\n,\r,\n,\u0085,\u2028,\u2029) instead of only\n. This addresses one of the most common regex pitfalls in .NET -- that$doesn't match before\r\nand.matches\r.Related:
Internal previews