[Tile-serving] [openstreetmap/mod_tile] Documentation clarity (Issue #387)

[zenonp]

render_list -h says 
```
If you are using --all, you can restrict the tile range by adding these options:
  -x, --min-x=X        minimum X tile coordinate
```
etc. The word "coordinate", together with general knowledge and habit of how these things work, leads to the interpretation of "tile coordinate" as "bbox", which is wrong. This thing wants tile numbers, not tile coordinates. And you only realise this when you try a negative geographical coordinate after having rendered millions of useless tiles with "-x 3.47 -y 53.77" and other such, because render_list doesn't throw an error on decimal input either, although it expects integers for -x -X -y -Y. 

A better term for "tile coordinate" would be "tile number". But even so, a couple of lines of explanatory text could save thousands of collective hours of unnecessary work and subsequent frustration. 

Yet better would be if render_list actually did accept bbox geographical coordinates. 


-- 
Reply to this email directly or view it on GitHub:
https://github.com/openstreetmap/mod_tile/issues/387
You are receiving this because you are subscribed to this thread.

Message ID: <openstreetmap/mod_tile/issues/387 at github.com>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstreetmap.org/pipermail/tile-serving/attachments/20240205/27c0f9c4/attachment.htm>