cplusplus / cplusplus/draft

\exposid (and similar macros) cause misalignment of columns in code blocks

Open
#4,381 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TeX
Stars
221
Forks
813
Avg merge
16h 4m
Merged PRs (30d)
36

Description

See the \expos comments near the beginning of [range.take.while.sentinel] for an example - they don't line up. The comments start on the same column in ranges.tex (after subtracting out the columns taken up by the use of \exposid), so the should line up. This appears to be similar to what I've seen when \placeholder is used instead of \placeholdernc. Do we need a \exposidnc?

In addition to \exposid, the use of other macros should be checked and possibly fixed as well.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start in ranges.tex near the beginning of range.take.while.sentinel and inspect the \expos comments whose columns do not align. Compare the behavior of \exposid with the mentioned \placeholder and \placeholdernc macros, then check similar macro uses. Done means the affected code-block comments align and the relevant macro cases are addressed.

Written by the indexing model from the issue text.

Assessment

Tech stack
tex
Domain
documentation
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.