Document `BAZEL_LINKOPTS` and other environment variables used in autoconfiguration
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 72/100
- Issue type
- Documentation
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- cpp
- Domain
- build-system, documentation
Research direction
Start with the autoconfiguration code and the split_escaped call in lib_cc_configure.bzl, then use issue #28639 to understand the BAZEL_LINKOPTS confusion. Document the environment variables used there and identify which pass through split_escaped, including the special handling they require; done means the behavior is clear to users configuring link options.
Written by the indexing model from the issue text.
Description
In https://github.com/bazelbuild/bazel/issues/28639, there is some confusion about how to set BAZEL_LINKOPTS: the core issue is that BAZEL_LINKOPTS is passed through split_escaped, but some linkopts contain the ":" character that is split on.
If we had documentation of the environment variables used in autoconfiguration, and which ones use split_escaped (and thus need special handling when set), this would have at least made the underlying issue more clear.
- Dominant language
- Starlark
- Stars
- 247
- Forks
- 196
- PR merge metrics
- No merged PRs in 30d
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from bazelbuild/rules_cc
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
bazelbuild/rules_cc#841 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
bazelbuild/rules_cc#839 · 2 comments ·
-
Difficulty 4/5 3-5 days Newbie friendliness 55/100
bazelbuild/rules_cc#895 ·
-
Difficulty 5/5 Over a week Newbie friendliness 25/100
bazelbuild/rules_cc#847 ·
-
category: core rules P4 type: feature request
Difficulty 4/5 3-5 days Newbie friendliness 50/100
bazelbuild/rules_cc#844 · 4 comments ·
All issues in bazelbuild/rules_cc
Similar issues
-
comp/dashboard P3 type/bug
Difficulty 2/5 1-3 hours Newbie friendliness 86/100
NousResearch/hermes-agent#117722 ·
-
Needs Design Priority: Wishlist
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
elementary/flatpak-platform#253 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
objectionary/hone-maven-plugin#1060 ·
-
0.kind: build failure
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
-
Update Vish to 1.1.5 Openpackage-update
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
oSoWoSo/vOid_Community_repOsitory#144 · 1 comment ·