From: Aditya Garg Date: Tue, 22 Jul 2025 16:35:05 GMT Subject: Re: [PATCH] docs: explain how to use `git imap-send --list` command to get a list of available folders Message-ID: <06DB740D-4A94-4588-8666-DEF29C46538C@live.com> In-Reply-To: > On 22 Jul 2025, at 9:17 PM, Junio C Hamano wrote: > > Aditya Garg 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.