Page MenuHomePhabricator

[backport#16947] doc: Doxygen-friendly script/descriptor.h comments
ClosedPublic

Authored by majcosta on Nov 13 2020, 03:49.

Details

Summary

15ac916642f20918f66e32729bb6b0b674e3bc24 doc: Doxygen-friendly descriptor.h comments (Jon Layton)

Pull request description:

Closes #16942.

- Make `Descriptor` overview subtext of `Interface for parsed descriptor objects.`
- Conform to `@param[in, out] argname: Info` in parameter comments. Present in code: https://github.com/bitcoin/bitcoin/blob/feb162d500273040c8a2e5cdd3393edf34dff45b/src/net_processing.cpp#L1001
- Remove redundant argument type, `in` vs `out` mentions
- Removed unnecessary backticks around `IsSolvable()`, since Doxygen builds a link to the known function's docs
- Add backticks to refer to `argname`s

`descriptor.cpp` has more documentation, but Doxygen's output doesn't include anything inside unnamed namespaces for some reason. Tried to access them via searchbar.

Backport of Core PR16947

Test Plan

Proofreading

Event Timeline

This revision is now accepted and ready to land.Nov 13 2020, 04:43