New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
In Latex sources, do columns start counting at 0 or 1? #3131
Comments
The example is correct. The first/zeroth column is a multiple of 4. |
Maybe a better way to say this is that "the number of spaces preceding a comment should be a multiple of four". |
Most comments aren't preceded by spaces only. We also can't say just characters, as that'd be ambiguous between source characters (LaTeX) and rendered characters (using |
Yes, sorry, that's what I meant. (And indeed, if you have macros in the source, you need to know how many characters they expand to, which is something I try to document as part of the macro in cases that come up a lot, like |
Editorial teleconference: @tkoeppe's is the right rule. |
Our coding style guidelines say that the starting columns for comments in examples should be multiples of 4, but starting from where? If we start counting at 1, the examples' comments in [diff.cpp17.dcl.dcl] start on column 25, suggesting that at least those comments start counting from 0, while other comments (including the ones I've edits) assume we start counting at 1. Which is correct? Example from compatibility.tex:
FWIW, the comments in the guideline's own Latex example text start on column 48 when counting from 1, suggesting that whoever wrote the guidelines was thinking they should start at 1:
\begin{note} %% own lines if possible
The guidelines should be fixed to specify, and the examples fixed to adhere to them.
The text was updated successfully, but these errors were encountered: