Re: git log format documentation/manpage
From: D. Ben Knoble <hidden>
Date: 2025-10-25 13:42:16
On Fri, Oct 24, 2025 at 4:07 AM David Moberg [off-list ref] 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, 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