<xstddef>: document code-emitting function-like macros
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 68/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Stale
- Tech stack
- cpp
- Domain
- documentation
Research direction
Start in stl/inc/xstddef, at the function-like macro definitions in the referenced lines near the end of the header. Read each macro and its nearby existing uses to understand the variations it generates. Done means comments document the macros and their usage clearly without changing their behavior.
Written by the indexing model from the issue text.
Description
At the end of <xstddef>: https://github.com/microsoft/STL/blob/1d39dfac9929c0d3c405edf6bc7eff26bbe2a26b/stl/inc/xstddef#L293-L422 we define a small system of macros that are used to stamp out small variations of code for particular cv qualifiers, or calling conventions, etc. We go out of our way to avoid these macros in new code, but there are nevertheless some existing uses. It would be nice to document these macros and their usage via comments in the header.
- Dominant language
- C++
- Stars
- 11.2k
- Forks
- 1.7k
- Avg merge
- 4d 22h
- Merged PRs (30d)
- 20
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from microsoft/STL
-
performance
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
Difficulty 5/5 Over a week Newbie friendliness 35/100
-
`<regex>`: `regex_search()` throws `regex_error(error_complexity)` with an unwisely written pattern Openbug regex
Difficulty 4/5 3-5 days Newbie friendliness 48/100
-
bug compiler
Difficulty 4/5 3-5 days Newbie friendliness 45/100
-
visualizer
Difficulty 5/5 Over a week Newbie friendliness 25/100
Similar issues
-
Difficulty 1/5 Under an hour Newbie friendliness 90/100
AXERA-TECH/ax-llm#77 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
-
bug-unconfirmed
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
NVIDIA/cuda-samples#453 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
infiniflow/infinity#3502 ·