gdal icon indicating copy to clipboard operation
gdal copied to clipboard

3 (out of 46) man pages missing

Open jidanni opened this issue 1 year ago • 3 comments

Feature description

$ dlocate --man gdal-bin|sed s/..// > m
$ dlocate --lsbin gdal-bin | sed 's!.*/!!;s!\.py$!!;' > b
$ wc -l b m | sed \$d
  46 b
  43 m
$ comm -3 b m
gdal2xyz
gdalattachpct
gdalenhance

Additional context

apropos(1) users: you are "not playing with a full deck"!

jidanni avatar Mar 24 '24 05:03 jidanni

I'm not sure of the fate of the other 43 man pages after https://gdal.org/en/latest/programs/index.html#gdal-application is implemented, but this bug should still be fixed, even if only "for old times' sake". (And apropos(1) users, who can't find the three programs. So assume they aren't installed.)

jidanni avatar Jan 23 '25 09:01 jidanni

As a Windows user I have no idea about man pages, but maybe they are something that Linux users are learned to use. Do they really check with man gdal2xyz if the utility exists, without ever trying gdal2xyz or gdal2xyz.py?

jratike80 avatar Jan 23 '25 10:01 jratike80

We do in Linux

$ apropos xyz
xyz: nothing appropriate.

to see if that ...xyz... command that we sort of remember using is installed.

Oh well, I guess it isn't installed. It must have been part of the GRASS package or something. Oh well.

We do one final guess:

$ gdal_<TAB>

Nope. Yes we should have tried

$ gdal<TAB>

or did

$ ls /usr/bin|grep xyz

but that is getting extreme.

jidanni avatar Jan 23 '25 10:01 jidanni

closing. we won't invest in those historical utilities

rouault avatar Jul 10 '25 19:07 rouault