> On 22 Jul 2025, at 9:17 PM, Junio C Hamano <gitster@xxxxxxxxx> wrote: > > Aditya Garg <gargaditya08@xxxxxxxx> 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.