From: Jeff King Date: Tue, 02 Jun 2026 06:17:52 GMT Subject: Re: [PATCH] doc: document and test `@` prefix for raw timestamps Message-ID: <20260602061752.GA695568@coredump.intra.peff.net> In-Reply-To: On Tue, Jun 02, 2026 at 09:23:34AM +0900, Junio C Hamano wrote: > > + It is safer to prepend the `` with `@` > > + (e.g., `@0 +0000`), which forces Git to interpret it as a raw > > + timestamp. This is required for values less than 100,000,000 > > + (which have fewer than 9 digits) to avoid confusion with other > > + date formats (like `YYYYMMDD`). > > Does this "additional paragraph" format correctly, instead of > rendered as a literal block (typically typeset in typewriter font, > monospace)? Don't you need to do something like what is done for > "ISO 8601::" that appears later in the same file? I.e. lose the > four-space indent and replace the blank line before it with a single > '+' list continuation operator? Yes, I think so. As a tip for contributors, running: cd Documentation ./doc-diff HEAD^ HEAD is often good for seeing a rough approximation of the rendered doc. It shows here that the result is incorrectly indented versus the rest of the section. Sadly it is somewhat limited in terms of typography, since it is diffing the roff-rendered manpages. So you wouldn't realize that it is rendered in a typewriter font, as you would if you looked at the html output. Spot-checking the html is also a good thing to do when writing doc patches. -Peff