Re: git log format documentation/manpage
- From
D. Ben Knoble <ben.knoble@gmail.com>
- Date
- Oct 25, 2025, 13:42 UTC
- 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:
Show 16 quoted lines
>
> 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, MobergI 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