docs: Update to reference host_platform instead of target_platform
#1496
Conversation
Update the documentation throughout to replace the references to `target_platform` with `host_platform` where appropriate. That said, unless I've missed some fine point, this means pretty much everywhere.
|
Thanks for the changes! I am wondering which one is "clearer" to the user ... |
|
I think cross-builds are inherently "hard" difficulty, and all terms are hard. In Gentoo, I personally went for explicit |
|
This change was basically prompted by regro/cf-scripts#3832 (comment) |
@isuruf has been making the case for following build/host/target (and fixing conda's inconsistent usage of these terms). This matches autotools conventions, but not only. For example, I like meson's write-up on this topic, which comes to the same conclusion. The "problem" is that the vast majority of cross-compiled cases (already not the most common concern itself) only care about two architectures - where it's built and where it's run. But if you use "target" for the latter, it becomes very confusing in those cases where the full generality is actually necessary (e.g. "canadian cross" compilers). This is, for example, why our compiler feedstocks need to hack around this by using In short: I agree that we should use v1 as an opportunity to clean up these inaccuracies, and +1 for using host_platform. |
|
I think the easiest way to explain to users is
|
Update the documentation throughout to replace the references to
target_platformwithhost_platformwhere appropriate. That said, unless I've missed some fine point, this means pretty much everywhere.