git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] doc: document and test `@` prefix for raw timestamps

From
Jeff King <peff@peff.net>
Date
Jun 2, 2026, 06:17 UTC
Message-ID
<20260602061752.GA695568@coredump.intra.peff.net>
In-Reply-To
<xmqqfr35zt6h.fsf@gitster.g>
On Tue, Jun 02, 2026 at 09:23:34AM +0900, Junio C Hamano wrote:
Show 12 quoted lines
> > +    It is safer to prepend the `<unix-timestamp>` 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
Previous: Junio C HamanoNext: Luna Schwalbe
Message 3 of 5 in “doc: document and test `@` prefix for raw timestamps”
  1. doc: document and test `@` prefix for raw timestampsLuna Schwalbe, Jun 1, 2026
  2. Junio C HamanoJun 2, 2026
  3. Jeff KingJun 2, 2026
  4. Luna SchwalbeJun 2, 2026
  5. Junio C HamanoJun 2, 2026

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.