Doxygen links to wrong implementation file

[amcn]

The documentation for llvm::Use::zap refers to the implementation at line 35 of llvm/lib/IR/Use.cpp but the link that doxygen inserts points instead to the file llvm/lib/ShadowIR/Use.cpp. I'm guessing it should probably point to llvm/lib/IR/Use.cpp as that is where zap is defined.

My doxygen-fu is rusty but I imagine it is not able to correctly disambiguate the two different files, lib/ShadowIR/Use.cpp and lib/IR/Use.cpp as they share the same name. There might be other examples of this kind of link confusion but I haven't done a thorough check.

[llvmbot]

Hi!

This issue may be a good introductory issue for people new to working on LLVM. If you would like to work on this issue, your first steps are:

1. Check that no other contributor has already been assigned to this issue. If you believe that no one is actually working on it despite an assignment, ping the person. After one week without a response, the assignee may be changed.
2. In the comments of this issue, request for it to be assigned to you, or just create a pull request after following the steps below. Mention this issue in the description of the pull request.
3. Fix the issue locally.
4. Run the test suite locally. Remember that the subdirectories under test/ create fine-grained testing targets, so you can e.g. use make check-clang-ast to only run Clang's AST tests.
5. Create a Git commit.
6. Run git clang-format HEAD~1 to format your changes.
7. Open a pull request to the upstream repository on GitHub. Detailed instructions can be found in GitHub's documentation. Mention this issue in the description of the pull request.

If you have any further questions about this issue, don't hesitate to ask via a comment in the thread below.

[llvmbot]

@llvm/issue-subscribers-good-first-issue

Author: Andrew McNulty (amcn)

Details

The documentation for [`llvm::Use::zap`](https://llvm.org/doxygen/classllvm_1_1Use.html#a017fb8dfaf7591379bf7596ce0f196eb) refers to the implementation at line 35 of [`llvm/lib/IR/Use.cpp`](https://llvm.org/doxygen/IR_2Use_8cpp_source.html) but the link that doxygen inserts points instead to the file [`llvm/lib/ShadowIR/Use.cpp`](https://llvm.org/doxygen/SandboxIR_2Use_8cpp_source.html). I'm guessing it should probably point to [`llvm/lib/IR/Use.cpp`](https://llvm.org/doxygen/IR_2Use_8cpp_source.html) as that is where `zap` is defined.

My doxygen-fu is rusty but I imagine it is not able to correctly disambiguate the two different files, lib/ShadowIR/Use.cpp and lib/IR/Use.cpp as they share the same name. There might be other examples of this kind of link confusion but I haven't done a thorough check.

[TheShubhendra]

Hi, I’d like to work on this issue. Could you please assign it to me?