flock.c, man/flock.1.ronn: document -E, add -v to --verbose usage

[josephholsten]

Summary by CodeRabbit

• Documentation
  • Updated flock usage documentation to show the -v alias for --verbose.
  • Clarified that --conflict-exit-code accepts values from 0 to 255.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 607cc072-68c5-4328-9a36-cde4ffa20456

📥 Commits

Reviewing files that changed from the base of the PR and between 419b608 and 81246c8.

📒 Files selected for processing (2)

• man/flock.1.ronn
• src/flock.c

Included review availability: Your plan provides up to 2 included reviews per hour; 1 remains after this review.

---

📝 Walkthrough

Walkthrough

The manual and command usage output now document -v as the short alias for --verbose. The usage output also documents the 0-255 range for --conflict-exit-code.

Changes

flock option documentation

Layer / File(s)	Summary
Align option usage text man/flock.1.ronn, src/flock.c	The manual and usage output now include -v for verbose mode. The usage output includes the (0-255) range for --conflict-exit-code.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Merge Risk: ⚪ Minimal · up to 81246

This localized change updates command-line help and documentation without introducing actionable merge-blocking risk; it is merge-ready after normal checks and review.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 1 functions across 1 files. (1 skipped: 1 …	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly identifies the affected files and accurately summarizes both documented changes: adding -E details and documenting -v for --verbose.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

Full details: Docstring Coverage

Explanation

Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 1 functions across 1 files. (1 skipped: 1 unsupported.)

• Fix all pre-merge checks with AI

✨ Finishing Touches 💡 2

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🛠️ Fix failing CI checks 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/usage-help-text

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[qodo-code-review]

PR Summary by Qodo

Document flock conflict exit code and verbose short option

🐞 Bug fix 📝 Documentation 🕐 Less than 5 minutes

AI Description

• Documents -E conflict exit-code behavior and valid range in command help.
• Adds the supported -v verbose alias to help and manual output.

High-Level Assessment

The direct documentation correction is appropriate because both options already exist; changing the canonical help and manual sources is lower risk than altering option parsing or introducing new abstractions.

Files changed (2) +3 / -3

Bug fix (1) +2 / -2

flock.cClarify conflict and verbose usage text +2/-2

Clarify conflict and verbose usage text

• Expands the '-E' help entry with its conflict semantics and valid 0–255 range. Adds '-v' to the verbose option shown by the built-in usage output.

src/flock.c

Documentation (1) +1 / -1

flock.1.ronnDocument the verbose short option +1/-1

Document the verbose short option

• Adds '-v' alongside '--verbose' in the flock manual so the documented syntax matches the supported CLI alias.

man/flock.1.ronn

[qodo-code-review]

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📎 Requirement gaps (0)

Great, no issues found!

Qodo reviewed your code and found no material issues that require review

Tip of the day

💡 Did you know, you can enable the Remediation agent and Qodo fixes findings in a dedicated fix PR

More tips ↗ | Customize Qodo ↗ | Qodo docs ↗