A buddy of mine is ramping up his command-line fu lately. He’s a thorough notetaker, and he’s taken to commenting his shell code immaculately. I applaud this. He mentioned that he really liked this particular formatting for describing what each flag/switch in a command does:
This is a companion discussion topic for the original entry at https://brettterpstra.com/2021/03/26/prettier-comments-for-flags-and-switches