conan-io / conan-io/docs

`self.settings` vs `self.info.settings` in `validate`/`validate_build`

Open
#2,792 7 comments 2 reactions 1 assignee Claimed by @prince-chrismc View on GitHub
Dominant language
C++
Stars
125
Forks
382
Avg merge
22h 39m
Merged PRs (30d)
21

Description

right now, documentation is inconsistent, e.g.:
https://docs.conan.io/en/latest/reference/conanfile/methods.html#validate
https://docs.conan.io/en/latest/reference/conanfile/methods.html#validate-build
use just `self.settings`, while:
https://docs.conan.io/en/latest/creating_packages/define_abi_compatibility.html
uses `self.info.settings`.
for newcomers, it's not clear, which one should be used and in that circumstances.
I think documentation should be aligned with the same recommendation on all pages.
if for some reason, both `self.info.settings` and plain `self.settings` could be used, it should have some disclaimer, describing the difference between them.
see also https://github.com/conan-io/conan-center-index/pull/13754

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.