Documentation genrule example - maybe avoid $(location ..) or $(locations ..) · bazelbuild/bazel#15078 | Good First Issue

(0 评论) (0 反应) (0 负责人)Java (4,465 fork)batch import

P3help wantedteam-Documentationteam-Rules-Servertype: documentation (cleanup)

仓库指标

Star: (25,384 star)
PR 合并指标: (平均合并 22天 20小时) (30 天内合并 77 个 PR)

描述

Description of the problem / feature request:

https://docs.bazel.build/versions/main/be/general.html#genrule_examples

Elsewhere I've seen that we're not supposed to be using $(location) calls and should instead be using $(rootpath ..) or $(execpath ..)

https://github.com/bazelbuild/bazel/issues/2475#issuecomment-339318016

I just spent hours debugging why a genrule of mine didn't work, when it wasn't exactly clear from the example that

We shouldn't be using $(location ..)
That $(location ..) can return different things in Skylark depending on srcs vs other generated outs.

Maybe this is clear for people who've been in Bazel for years and are aware of the changes to all make-style vars.

贡献者指南

研究方向: 该问题要求更新 https://docs.bazel.build/versions/main/be/general.html#genrule examples 中的 genrule 示例，使用 $(rootpath) 或 $(execpath) 替代 $(location)，并引用了之前的讨论。目前没有评论或 PR。修复涉及编辑 genrule 示例的文档文件，替换 $(location) 调用，并添加关于弃用的说明。
技术栈: 无
领域: documentation
议题类型: 文档
难度: 1
预计时间: 1 小时以内
活动状态: 新近可参与
清晰度: 清晰
前置要求: basic Bazel understanding
新手友好度: 85