Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

hotdoc module: add dedicated depends kwarg, deprecate file deps in dependencies #10982

Merged
merged 2 commits into from Nov 7, 2022

Conversation

eli-schwartz
Copy link
Member

We consistently use the "dependencies" kwarg to refer to C-like CFLAGS/LDFLAGS interfaces. And for hotdoc, we actually accept libraries for this as well, as we may want to document their (generated?) sources, so we want their CFLAGS too.

But we also accepted custom targets and just added a build order dependency on these, which was odd and typically we call that "depends". Let's deprecate this in favor of the depends kwarg.

@codecov
Copy link

codecov bot commented Nov 2, 2022

Codecov Report

Merging #10982 (28bfa75) into master (ae6c8d4) will increase coverage by 3.22%.
The diff coverage is 64.00%.

@@            Coverage Diff             @@
##           master   #10982      +/-   ##
==========================================
+ Coverage   65.10%   68.33%   +3.22%     
==========================================
  Files         207      412     +205     
  Lines       44893    87813   +42920     
  Branches     9275    20716   +11441     
==========================================
+ Hits        29229    60007   +30778     
- Misses      13369    23308    +9939     
- Partials     2295     4498    +2203     
Impacted Files Coverage Δ
mesonbuild/modules/hotdoc.py 65.48% <30.00%> (ø)
mesonbuild/scripts/depfixer.py 72.97% <50.00%> (ø)
mesonbuild/compilers/asm.py 52.34% <100.00%> (ø)
mesonbuild/coredata.py 83.20% <100.00%> (ø)
mesonbuild/interpreter/primitives/string.py 98.54% <100.00%> (ø)
modules/hotdoc.py 65.48% <0.00%> (-0.35%) ⬇️
mdevenv.py 30.92% <0.00%> (ø)
msubprojects.py 30.22% <0.00%> (ø)
scripts/env2mfile.py 15.29% <0.00%> (ø)
interpreterbase/interpreterbase.py 77.75% <0.00%> (ø)
... and 270 more

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

@eli-schwartz
Copy link
Member Author

@jpakkane this fixes a regression in the release candidate which makes dependencies: some_custom_target not work (gstreamer was using this to add build graph ordering rules).

@xclaesse
Copy link
Member

xclaesse commented Nov 6, 2022

@eli-schwartz @jpakkane would be nice to finalize this, I think it is release blocker.

@eli-schwartz
Copy link
Member Author

I think it's ready to merge, actually... It seems unnecessary to carry around deprecated support for something that should never happen, and the reasonable use case is maintained, right?

@xclaesse
Copy link
Member

xclaesse commented Nov 6, 2022

Deprecation warning for something that projects should stop doing is the whole point of this PR. If you don't agree with that why did you make at all?

@xclaesse
Copy link
Member

xclaesse commented Nov 6, 2022

Fixing half the problem is completely useless, the whole point is to keep GST working.

@xclaesse
Copy link
Member

xclaesse commented Nov 6, 2022

Hmm, actually yes it is useful because it gives a way to make GST work with both old and new meson. Good enough I guess.

@eli-schwartz
Copy link
Member Author

Well yes, I was making a distinction between "wanted to do X, X needs new kwargs, keep that working on old versions" and "this particular bit here was apparently wrong for old versions too". :D

@eli-schwartz
Copy link
Member Author

@jpakkane this needed to go in before the final release. Also several PRs to fix CI are still pending, how did you successfully release it? :D

@jpakkane jpakkane added this to the 0.64.1 milestone Nov 6, 2022
Internally we pass this as extra_depends to the CustomTarget
initializer, so it makes sense to call it that rather than confusing the
topic by referring to "dependencies", a term that indicates
CFLAGS/LDFLAGS interfaces.
…pendencies

We consistently use the "dependencies" kwarg to refer to C-like
CFLAGS/LDFLAGS interfaces. And for hotdoc, we actually accept libraries
for this as well, as we may want to document their (generated?) sources,
so we want their CFLAGS too.

But we also accepted custom targets and just added a build order
dependency on these, which was odd and typically we call that "depends".
Let's deprecate this in favor of the depends kwarg.
@xclaesse xclaesse merged commit bcc127b into mesonbuild:master Nov 7, 2022
@nirbheek nirbheek modified the milestones: 0.64.1, 0.63.4 Nov 8, 2022
@eli-schwartz eli-schwartz deleted the hotdoc-depends branch February 24, 2023 02:18
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.

None yet

5 participants