xiph / flac

Free Lossless Audio Codec
https://xiph.org/flac/
GNU Free Documentation License v1.3
1.58k stars 278 forks source link

Update main.c with new help text #708

Closed H2Swine closed 2 weeks ago

H2Swine commented 1 month ago

I updated help text from void show_help(void) definition, to new line 1397 Most are reorderings by topic, some minor rewording and reformatting.

Possibly one needs to take a stand on when one should use double quotation marks. Is that shell-independent? Anyway I did use double quotation marks in the explanation of -6/-7/-8 because it was already used under -A. But also, what about in --output-name and --output-prefix?

From the top: General options, ordered: -v, -h, -H and then the operations, then what to do about the output file, then user feedback (-s and -w) Encoding options: Reordering; there is no need to have --lax etc. first, and ordinary users would probably not read tagging commands first. Also, they fit on the same indentation

Format options reordered and slightly reworded:

Negative options: specified that latter takes precedence. Ordered them according to alphabet.