Skip to content

Conversation

AndrewAnnex
Copy link
Contributor

@AndrewAnnex AndrewAnnex commented Jun 22, 2025

Updates install_path to install_dir.
Updates code block to be more explicit with shared_library usage.

Fixes #769

Copy link
Member

@dnicolodi dnicolodi left a comment

Choose a reason for hiding this comment

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

Can you also please fix the commit message to comply with the format we use for this project? Namely, it should have a summary line of less than 78 characters, starting with an identifier in all caps, DOC in this case, followed by colons and the summary of the changes. The details go in the body. Something like

DOC: shared-libraries: fix and clarify install location example

Fixes #769

@AndrewAnnex
Copy link
Contributor Author

AndrewAnnex commented Jun 23, 2025

@dnicolodi happy to fix all the above, although for the commit message wouldn't that be easier to fix when squashing the commits on merge? I guess I can fix all the above, squash the commits, and force push to the branch too but that is a bit more involved

@eli-schwartz
Copy link
Member

Note also that completely independent of which GitHub repo you are contributing to, you must add "fixes #XXX" in the extended description, not in the one-line summary/title. Also, use "fixes" not "fix for".

Failure to obey these rules means that GitHub won't associate the fix with the issue, and the issue will not get closed when the PR is merged.

@AndrewAnnex AndrewAnnex changed the title Fix for #769, corrects typo in shared_libraries docs DOC: shared-libraries: fix and clarify install location example Jun 23, 2025
Copy link
Member

@dnicolodi dnicolodi left a comment

Choose a reason for hiding this comment

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

There is trailign whitespace somewhere. CI is not happy.

@dnicolodi
Copy link
Member

I guess I can fix all the above, squash the commits, and force push to the branch too but that is a bit more involved

You should do just that. The goal is to teach how to contribute to this project while freeing the maintainers from menial task.

Copy link
Member

@dnicolodi dnicolodi left a comment

Choose a reason for hiding this comment

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

CI is still not happy.

@dnicolodi dnicolodi added the documentation Improvements or additions to documentation label Jun 24, 2025
@dnicolodi
Copy link
Member

The CI failure is due to a bug in pygments pygments/pygments#2918

@AndrewAnnex
Copy link
Contributor Author

@dnicolodi sorry I had a few other things to work on but can get back to this on Friday. Maybe switching the codeblock back to python would be the quicker fix

@dnicolodi
Copy link
Member

I would use text for the code block language and leave a comment that points to the pygments issue.

@AndrewAnnex AndrewAnnex force-pushed the fix_shared_lib_doc_typo_install_dir branch from 5aa44a9 to 48fcf17 Compare June 26, 2025 18:20
@AndrewAnnex
Copy link
Contributor Author

okay cleaned up the commits, updated the code-block to text, added some comments about the pygments issue, and ran precommit locally to hopefully avoid further ci complaints

@dnicolodi
Copy link
Member

Thanks.

@dnicolodi dnicolodi merged commit 121339e into mesonbuild:main Jun 26, 2025
15 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

typo in internal shared libraries docs? ERROR: Got unknown keyword arguments "install_path"

3 participants