osmcode / osmium-tool

Command line tool for working with OpenStreetMap data based on the Osmium library.
https://osmcode.org/osmium-tool/
GNU General Public License v3.0
509 stars 107 forks source link

No links between documentation pages #250

Closed SomeoneElseOSM closed 1 year ago

SomeoneElseOSM commented 2 years ago

Pages such as https://docs.osmcode.org/osmium/latest/osmium-extract.html seem to be the current documentation for (in this case) "osmium extract". That pages mentions, but does not link to, pages such as "osmium merge". It would be much more usable as documentation if it did.

joto commented 2 years ago

Generally those man pages are supposed to be installed and used locally on your machine like any other man pages. This has the advantage that you'll always have the correct documentation for the installed version of osmium. The web versions of those man pages are only there for convenience, but you are right, they would be more convenient with links. I added the links to the "master" set of man pages now https://docs.osmcode.org/osmium/master/index.html . I can not easily add them retroactively to older versions of the manuals, but new versions will get the links, too.