Hi Gerd Looking at the svn log it seems that the man page splitter.1 which is in groff format can be generated from splitter.1.xml which is in DocBook XML format. I can't be bothered to install and try this so I think just keep all files as you have. The version of splitter.txt I attached can go in dist/doc where it will be copied into a local system you make with ant - check what you have there to see of this makes sense. If splitter.html is there replace that as well. I presume Steve's automatic building process does this; I'll have a look next week to see if splitter-r654 has been created and the contents of its doc. Ticker On Fri, 2024-04-05 at 13:55 +0000, Gerd Petermann wrote:
Hi Ticker,
thanks for checking. I also don't know where those doc files are used or how a man file should be installed. I'd be happy to drop any doc which is of no use.
I've committed r654 for now. Not sure what to do with your version of splitter.txt.
Gerd
________________________________________ Von: mkgmap-dev <mkgmap-dev-bounces@lists.mkgmap.org.uk> im Auftrag von Ticker Berkin <rwb-mkgmap@jagit.co.uk> Gesendet: Freitag, 5. April 2024 12:09 An: Development list for mkgmap Betreff: Re: [mkgmap-dev] Patch to update documentation for splitter
Hi Gerd
The unix man entry looks fine
$ man -l ${splitterSvn}/trunk/doc/splitter.1
but I don't know how anyone would be expected to find and use it unless it gets installed with the other man pages
dist/doc/splitter.txt and .html generated with mwconf from doc/splitter.txt are attached; I don't know if you need either or both before committing the change, but I doubt if you need the .html version - www.mkgmap.org.uk should re- generate it in the correct context.
I have no idea how splitter.1.xml is used
Ticker
On Fri, 2024-04-05 at 07:37 +0000, Gerd Petermann wrote:
Hi Felix,
don't worry. My contribution should be read by other developers. If you want to become one see https://www.mkgmap.org.uk/dev/index.html
Gerd
________________________________________ Von: mkgmap-dev <mkgmap-dev-bounces@lists.mkgmap.org.uk> im Auftrag von Felix Herwegh <mlmmduk@herwegh.de> Gesendet: Freitag, 5. April 2024 09:03 An: Development list for mkgmap Betreff: Re: [mkgmap-dev] Patch to update documentation for splitter
What exactly should one do?
I'm on Debian but so far have never compiled from source.
//Felix
-------- Original Message -------- From: Gerd Petermann <gpetermann_muenchen@hotmail.com> Sent: April 5, 2024 7:16:37 AM GMT+02:00 To: "mkgmap-dev@lists.mkgmap.org.uk" <mkgmap-dev@lists.mkgmap.org.uk> Subject: [mkgmap-dev] Patch to update documentation for splitter
Hi all,
the attached patch adds a hint that holes in *.poly files are ignored. It also adds the --polygon-desc-file option in splitter.txt.
Unfortunately I don't know how to test the formatting in the various formats, esp. the man page. Would be nice if someone on a linux system could test this.
Gerd _______________________________________________ mkgmap-dev mailing list mkgmap-dev@lists.mkgmap.org.uk https://www.mkgmap.org.uk/mailman/listinfo/mkgmap-dev _______________________________________________ mkgmap-dev mailing list mkgmap-dev@lists.mkgmap.org.uk https://www.mkgmap.org.uk/mailman/listinfo/mkgmap-dev _______________________________________________ mkgmap-dev mailing list mkgmap-dev@lists.mkgmap.org.uk https://www.mkgmap.org.uk/mailman/listinfo/mkgmap-dev
_______________________________________________ mkgmap-dev mailing list mkgmap-dev@lists.mkgmap.org.uk https://www.mkgmap.org.uk/mailman/listinfo/mkgmap-dev