From: D. Ben Knoble <ben.knoble@gmail.com>
Date: Sat, 25 Oct 2025 13:42:03 GMT
Subject: Re: git log format documentation/manpage
Message-ID: <CALnO6CBLUGgBMeRf0uLA=TKVaMQvap9Wpa4uTAGQD5he40xeWw@mail.gmail.com>
In-Reply-To: <KL1PR03MB5748DE5406618053D0A6CE0AEBF1A@KL1PR03MB5748.apcprd03.prod.outlook.com>

On Fri, Oct 24, 2025 at 4:07 AM David Moberg <David.Moberg@mediatek.com> wrote:
>
> Hi I'm trying to replicate the "oneline" log format and add notes to it. What I can't figure out:
>
> 1. What is the format string that corresponds to pretty format "oneline"?
> 2. What is the placeholder for the title-line? By searching for "title-line" in `man git log` I couldn't find anything. Surely this is in here somewhere?
>    Searching for `full-commit-message` also left me empty-handed.
> 3. How can I display notes (%N from `git notes add`) as in-line information (stripping away newlines at the end)?
>
> How do I figure out the placeholders?
>
> Suggestion for manpage improvements:
> 1. the pretty formats (oneline, short, ...) should come with a (t)format string that it corresponds to. They will act as great examples.
> 2. Make sure the descriptions of the pretty formats ("<title-line>", "<full-commit-message>", ...) are searchable.
>
> Kind Regards,
> David, kaddkaka, Moberg

I don't have the answer to everything, but for your goal, does
`--oneline --notes` not give you something close enough?

Since notes can be arbitrary text, making them "inline" with the
oneline format seems like an uphill battle to me.

-- 
D. Ben Knoble