bazelbuild / bazel

a fast, scalable, multi-language and extensible build system
https://bazel.build
Apache License 2.0
22.98k stars 4.03k forks source link

merge_cc_infos document is missing #20375

Open trungdinhth opened 9 months ago

trungdinhth commented 9 months ago

Page link:

https://bazel.build/rules/lib/toplevel/cc_common

Problem description (include actual vs expected text, if applicable):

For previous versions of bazel untili 6.2.0, merge_cc_infos are still documented in cc_common, but in later versions of the doc, the documentation of this function has disappeared. However, the function seems to be migrated to a starlark implemstarlark. Therefore, maybe the doc generation has been broken.

Where do you see this issue? (include link to specific section of the page, if applicable)

On official doc page: https://bazel.build/rules/lib/toplevel/cc_common

Any other information you'd like to share?

It seems like not just merge_cc_infos's doc is missing, but there are other public functions in cc_common undocumented too (according to the list of exported functions at the end of the file), for example:

fmeum commented 9 months ago

CC @buildbreaker2021

keith commented 1 month ago

I assume this is because it's entirely starlark where the others still come from java?