Add documentation for torch.overrides submodule.

[hameerabbasi]

Fixes #48087

[dr-ci]

💊 CI failures summary and remediations

As of commit 32eed06 (more details on the Dr. CI page):

---

• 2/2 failures possibly* introduced in this PR
  • 2/2 non-CircleCI failure(s)

---

Extra GitHub checks: 1 failed

• Failed: GitHub Actions - flake8-py3

---

ci.pytorch.org: 1 failed

• Failed: pr/pytorch-linux-bionic-rocm3.9-py3.6

---

This comment was automatically generated by Dr. CI (expand for details).

Follow this link to opt-out of these comments for your Pull Requests.

Please report bugs/suggestions on the GitHub issue tracker or post in the (internal) Dr. CI Users group.

See how this bot performed.

This comment has been revised 21 times.

[hameerabbasi]

@ezyang Now that these things are being documented, it's our last chance to make anything private. So let me know if you'd make anything else private.

[ezyang]

I looked over all the funcs, and I agree with your assessment of what should be public and private.

[ezyang]

Ooh... I forgot that you refer to this explicitly in the docs. Referencing a private function here is kind of weird. Perhaps that means this particular function should be kept public. _get_testing_overrides and _get_ignored_functions are the ones that definitely should not be public.

[hameerabbasi]

Version 1.7 is the only version where these were public. Before that, the submodule was private. v1.7.1 is the only version where the docs might show it as public.

[ezyang]

Sorry, it doesn't have to do with the historical context is. What I mean is, it's weird to mark a function with a leading underscore, and then immediately turn around and in the docs say, "Hey, you should call this private function to find out what functions to implement it with!" It's like saying, "This thing, which you're not supposed to use, is so useful that we are going to tell you about it in the public documentation hint hint wink wink"

[hameerabbasi]

I'll make these public.

[codecov]

Codecov Report

Merging #48170 (0dbf0d7) into master (49f0e5d) will decrease coverage by 0.00%.
The diff coverage is 95.83%.

@@            Coverage Diff             @@
##           master   #48170      +/-   ##
==========================================
- Coverage   81.31%   81.31%   -0.01%     
==========================================
  Files        1839     1839              
  Lines      198692   198703      +11     
==========================================
+ Hits       161561   161569       +8     
- Misses      37131    37134       +3     

[hameerabbasi]

The CI failures are all unrelated.

• For the flake8 failure, see Pin flake8 version in CI #24188 (comment).
• CircleCI macOS build had an infrastructure issue.
• The failing test for ROCm is test_streaming_backward_sync_graph_root (__main__.TestCuda) (Tensors failed to compare as equal!), which has nothing to do with this PR either.

[facebook-github-bot]

@ezyang has imported this pull request. If you are a Facebook employee, you can view this diff on Phabricator.

[facebook-github-bot]

@ezyang merged this pull request in 4e15877.