Skip to content

Conversation

@avivkeller
Copy link
Member

Fixes #346 by adding a transformer for Unix Manual syntax. That way, when chmod(1) (or similar) is put the documentation, it'll link to the https://man7.org/linux/man-pages/ reference.

Copilot AI review requested due to automatic review settings July 10, 2025 15:10
@avivkeller avivkeller requested a review from a team as a code owner July 10, 2025 15:10
@codecov
Copy link

codecov bot commented Jul 10, 2025

Codecov Report

Attention: Patch coverage is 68.42105% with 18 lines in your changes missing coverage. Please review.

Project coverage is 72.12%. Comparing base (f80bcce) to head (c36357c).
Report is 1 commits behind head on main.

✅ All tests successful. No failed tests found.

Files with missing lines Patch % Lines
src/generators/metadata/utils/parse.mjs 0.00% 8 Missing ⚠️
src/utils/parser/index.mjs 62.50% 6 Missing ⚠️
src/utils/queries/index.mjs 86.66% 4 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##             main     #349      +/-   ##
==========================================
- Coverage   72.17%   72.12%   -0.05%     
==========================================
  Files         117      117              
  Lines        9936     9984      +48     
  Branches      597      597              
==========================================
+ Hits         7171     7201      +30     
- Misses       2762     2780      +18     
  Partials        3        3              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR adds support for transforming Unix manual page references (e.g., chmod(1)) into links to the Man7 documentation.

  • Imported and wired up a new transformUnixManualToLink transformer in both the parser and query layers
  • Added a DOC_MAN_BASE_URL constant and corresponding regex/query for Unix manuals
  • Updated the metadata generator to visit and transform manual-page references

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File Description
src/utils/queries/index.mjs Added unixManualPage regex, updateUnixManualReference, and isTextWithUnixManual
src/utils/parser/constants.mjs Defined DOC_MAN_BASE_URL for Man7 manual links
src/utils/parser/index.mjs Exported transformUnixManualToLink transformer
src/generators/metadata/utils/parse.mjs Added AST visitor for Unix manual references
Comments suppressed due to low confidence (1)

src/generators/metadata/utils/parse.mjs:132

  • [nitpick] No test coverage appears to be added for the new Unix manual transformer. Consider writing unit tests to validate transformUnixManualToLink output and the visit behavior.
    visit(

Copy link
Member

@ovflowd ovflowd left a comment

Choose a reason for hiding this comment

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

LGTM!! tysm for fixing this <3

@avivkeller avivkeller mentioned this pull request Jul 11, 2025
6 tasks
Copy link
Member

@flakey5 flakey5 left a comment

Choose a reason for hiding this comment

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

thank you!

@ovflowd ovflowd merged commit 6fa7d1b into main Jul 12, 2025
9 checks passed
@ovflowd ovflowd deleted the avivkeller/manpage-converstion branch July 12, 2025 15:04
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.

Links to Linux Manpages aren't parsed

4 participants