ogrinfo usage message not coordinated with man page

[jidanni]

What is the bug?

ogrinfo usage message

• contains items not mentioned on the man page, like -summary
• lines that go off the screen, even 100 character wide screens.

Steps to reproduce the issue

Test with ogrinfo --zzzz

Versions and provenance

GDAL 3.10.1, released 2025/01/08

[jratike80]

First: Seems to be out-of-sync, -summary documented still as -so https://gdal.org/en/stable/programs/ogrinfo.html#cmdoption-ogrinfo-so
Second: Are you using Linux or Windows? On Windows the lines do not go off the screen. Lines are dynamically split but the text continues on the next line and no characters are lost.

That is standard behavior on Windows. Test by running any windows command with help switch and making the window narrow . However, long help texts of the Windows commands are usually hardcoded to split on several lines. Lines have about 80 characters at maximum.

[jidanni]

Emacs -nw on Linux:

Wrapping is bad enough. And many people would have truncated them instead of wrapping,
https://emacs.stackexchange.com/questions/51989/how-to-truncate-lines-by-default

[jratike80]

I tried to find some example and Linux sed https://github.com/mirror/sed/blob/master/sed/sed.c formats longer help texts this way

fprintf (out, _("  -u, --unbuffered\n\
                 load minimal amounts of data from the input files and flush\n\
                 the output buffers more often\n"));