Re: [PATCH] docs: explain how to use `git imap-send --list` command to get a list of available folders
Show 17 quoted lines
> On 22 Jul 2025, at 9:17 PM, Junio C Hamano <gitster@pobox.com> wrote:
>
> Aditya Garg <gargaditya08@live.com> writes:
>
>> The output `git imap-send --list` command can be a bit confusing for new
>> users since the IMAP LIST command output is very verbose. Help such users
>> to analyse the same by using an example output.
>
> The documentation added by 067a91b0 (imap-send: add ability to list
> the available folders, 2025-06-20) is overly insufficient, so let's
> queue this update on top of it.
>
> But I am not sure if "very verbose" is a cause for worry. I would
> agree if the argument were that it is not very friendly to end-users
> to throw raw IMAP protocol messages at them. But it is what needs
> to be fixed in the implementation, not papered over with
> documentation.
It’s not really easy to make it more user friendly. Regex with C is a PITA for me, and different email servers might have slightly different ways to express the same output. Also, this much verbosity gives necessary details to locate subfolders, tags etc.
Aditya Garg <gargaditya08@live.com>