Re: [PATCH v4 11/11] doc: interpret-trailers: document comment line treatment
- From
- Kristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com>
- Date
- Aug 8, 2026, 19:45 UTC
- Message-ID
- <b9cac360-ec97-4715-b176-7850a40ff433@app.fastmail.com>
- In-Reply-To
- <CALnO6CB_0ucqnAowrNcPmsXmxxDfJQZPVGkbsHVuya7NLR4dsg@mail.gmail.com>
On Thu, Aug 6, 2026, at 13:52, D. Ben Knoble wrote:
Show 11 quoted lines
> Hi Kristoffer, > > On Thu, Jul 30, 2026 at 5:22 AM <kristofferhaugsbakk@fastmail.com> wrote: >> >> From: Kristoffer Haugsbakk <code@khaugsbakk.name> >> >> Comment lines have always been ignored but this is not documented. >> >> The primary motivation here is to reasonably complete in the > > "to be"?
Thanks. I keep staring at the text but in the end you need someone else to read it as well.
Show 13 quoted lines
>>[snip] >> Notes (series): >> v4: >> • Msg: rewrite motivation for documenting this. The motivation is >> not super solid, but it reflects my own ambiguity on the matter, >> so to speak; I think we ought to be very thorough about >> documenting the format, while making sure to not use the main text >> to exhaustively lay it all out. The information should be >> somewhere in this doc. But not in your face. > > I agree we should be thorough but not in your face, esp. based on the > work Julia Evans has done in the past around Git documentation. > Thanks!
Thanks. I’m glad that I was able to communicate that. ;)
> >>[snip]