Re: [PATCH v3 09/13] trailer --parse docs: add explanation for its usefulness

From: Junio C Hamano <gitster@pobox.com>
Date: Sep 8, 2023, 21:57 UTC
Message-ID: <xmqq7cp0s4z4.fsf@gitster.g>
In-Reply-To: <ef6b77016cd50c438fb58d79ffb10f748ddc5244.1694125210.git.gitgitgadget@gmail.com>

"Linus Arver via GitGitGadget" <gitgitgadget@gmail.com> writes:

Show 7 quoted lines

>  --parse::
>  	A convenience alias for `--only-trailers --only-input
> -	--unfold`.
> +	--unfold`. This makes it easier to only see the trailers coming from the
> +	input without influencing them with any command line options or
> +	configuration variables, while also making the output machine-friendly with
> +	--unfold.

Nicely explained. Without a concise explanation like this, it is hard to see what the value of the "convenience" alias actually is.

$ 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.