[mkgmap-dev] Patch to update documentation for splitter

Fri Apr 5 16:08:22 BST 2024

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 at lists.mkgmap.org.uk> im Auftrag von Ticker
> Berkin <rwb-mkgmap at 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 at lists.mkgmap.org.uk> im Auftrag von
> > Felix
> > Herwegh <mlmmduk at 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 at hotmail.com>
> > Sent: April 5, 2024 7:16:37 AM GMT+02:00
> > To: "mkgmap-dev at lists.mkgmap.org.uk" <mkgmap-dev at 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 at lists.mkgmap.org.uk
> > https://www.mkgmap.org.uk/mailman/listinfo/mkgmap-dev
> > _______________________________________________
> > mkgmap-dev mailing list
> > mkgmap-dev at lists.mkgmap.org.uk
> > https://www.mkgmap.org.uk/mailman/listinfo/mkgmap-dev
> > _______________________________________________
> > mkgmap-dev mailing list
> > mkgmap-dev at lists.mkgmap.org.uk
> > https://www.mkgmap.org.uk/mailman/listinfo/mkgmap-dev
> 
> _______________________________________________
> mkgmap-dev mailing list
> mkgmap-dev at lists.mkgmap.org.uk
> https://www.mkgmap.org.uk/mailman/listinfo/mkgmap-dev