Skip to content

Review src/common/regexp.h#217

Merged
janrysavy merged 1 commit intocomments-translation-v2from
codex/common-regexp-h-review
Apr 2, 2026
Merged

Review src/common/regexp.h#217
janrysavy merged 1 commit intocomments-translation-v2from
codex/common-regexp-h-review

Conversation

@janrysavy
Copy link
Copy Markdown
Owner

Summary

  • review translation update for src/common/regexp.h
  • lands one API comment cleanup for ExpandVariables

Review

  • HTML artifact: /mnt/d/source/ostranslation/artifacts/src-common-regexp-h-review-20260401/triple-diff-report.html
  • Inline review context comment includes the Czech source block and a one-line rationale

Applied the approved branch-target review result for src/common/regexp.h. The landed change rewrites the ExpandVariables API comment block into clearer technical English without changing the documented contract.

The old wording used awkward and slightly imprecise terms such as template for the replacement text and expression for the final expanded output. The new version consistently describes a replacement pattern expanded into an output buffer, clarifies that count returns the number of characters copied to that buffer, and states explicitly that TRUE means the expanded text fit in full.

No other comment changes from the artifact were applied. I copied the reviewed draft file from artifacts/src-common-regexp-h-review-20260401, confirmed the worktree diff contains only this one comment block change in src/common/regexp.h, and then ran node --experimental-strip-types src/comment-guard.ts --target-root /mnt/d/source/OpenSal/salamander_codex_pr --artifacts-dir /mnt/d/source/ostranslation/artifacts/src-common-regexp-h-review-20260401 --selected-files src/common/regexp.h with exit code 0 before committing.
// 'pattern' is the replacement pattern for the found match, 'buffer' is the output buffer
// 'bufSize' is the maximum text length including the terminating NULL
// character, and 'count' returns the number of characters copied to the buffer
// returns TRUE if the expanded text fit entirely into the buffer
Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

// nahradi promnene \1 ... \9 textem zachycenym odpovidajicima zavorkama
// pattern je vzor kterym se nahrazuje nalezeny match, buffer buffer
// pro vystup, bufSize maximalni velikost textu vcetne ukoncovaciho NULL
// znaku, v promnene count vraci pocet znaku zkopirovanych do bufferu
// vraci TRUE pokud se vyraz vesel cely do bufferu

Rationale: The candidate is awkward and uses imprecise terms like template and expression; this API describes replacement-pattern expansion into an output buffer.

@janrysavy janrysavy merged commit bf46da2 into comments-translation-v2 Apr 2, 2026
3 checks passed
@janrysavy janrysavy deleted the codex/common-regexp-h-review branch April 2, 2026 08:46
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.

2 participants