Re: [PATCH] docs: explain how to use `git imap-send --list` command to get a list of available folders

[Aditya Garg <gargaditya08@live.com>]

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