summaryrefslogtreecommitdiff
path: root/crates/typst-syntax/src/parser.rs
diff options
context:
space:
mode:
authorIan Wrzesinski <133046678+wrzian@users.noreply.github.com>2025-06-09 09:48:55 -0400
committerGitHub <noreply@github.com>2025-06-09 13:48:55 +0000
commit832fab58b31a16d049418bdbfe98b0352758579f (patch)
treeeb0650ccbd7af57c0f1045da0caea67ee17bcfa1 /crates/typst-syntax/src/parser.rs
parent6725061841e327227a49f90134136264a5b8c584 (diff)
Clean up some parser comments (#6398)
Diffstat (limited to 'crates/typst-syntax/src/parser.rs')
-rw-r--r--crates/typst-syntax/src/parser.rs13
1 files changed, 7 insertions, 6 deletions
diff --git a/crates/typst-syntax/src/parser.rs b/crates/typst-syntax/src/parser.rs
index ecd0d78a..a6881580 100644
--- a/crates/typst-syntax/src/parser.rs
+++ b/crates/typst-syntax/src/parser.rs
@@ -1571,10 +1571,10 @@ struct Token {
prev_end: usize,
}
-/// Information about a newline if present (currently only relevant in Markup).
+/// Information about newlines in a group of trivia.
#[derive(Debug, Clone, Copy)]
struct Newline {
- /// The column of the start of our token in its line.
+ /// The column of the start of the next token in its line.
column: Option<usize>,
/// Whether any of our newlines were paragraph breaks.
parbreak: bool,
@@ -1587,7 +1587,7 @@ enum AtNewline {
Continue,
/// Stop at any newline.
Stop,
- /// Continue only if there is no continuation with `else` or `.` (Code only).
+ /// Continue only if there is a continuation with `else` or `.` (Code only).
ContextualContinue,
/// Stop only at a parbreak, not normal newlines (Markup only).
StopParBreak,
@@ -1610,9 +1610,10 @@ impl AtNewline {
},
AtNewline::StopParBreak => parbreak,
AtNewline::RequireColumn(min_col) => {
- // Don't stop if this newline doesn't start a column (this may
- // be checked on the boundary of lexer modes, since we only
- // report a column in Markup).
+ // When the column is `None`, the newline doesn't start a
+ // column, and we continue parsing. This may happen on the
+ // boundary of lexer modes, since we only report a column in
+ // Markup.
column.is_some_and(|column| column <= min_col)
}
}