[mkgmap-dev] documentation improvement

Wed Apr 8 09:25:23 BST 2020

Hi

I'll have a look and try and work out if the web version of options is
generated using the same software as the style manual, but, given there
are 2 unconnected processors being used to transform options.txt, I'd
recommend just replacing the '' with it spelt out.

The patch looks fine to me as well, but I'd have left in the bit about
tile selection by --description as this is the only usage of the tile
description that I've ever come across.

Ticker

On Wed, 2020-04-08 at 08:08 +0000, Gerd Petermann wrote:
> Hi Mike,
> 
> reg. 1 arc second or 1'' : I have no idea how to change the HTML
> creation process. My understanding is that we have to use some escape
> characters in options.txt and maybe some additional code in
> OptionsBuilder.java to remove those escape characters.
> @Ticker: Can you look at that?
> 
> Besides that the patch options3.txt.patch looks good to me.
> 
> Gerd
> 
> 
> ________________________________________
> Von: mkgmap-dev <mkgmap-dev-bounces at lists.mkgmap.org.uk> im Auftrag
> von Mike Baggaley <mike at tvage.co.uk>
> Gesendet: Mittwoch, 8. April 2020 09:40
> An: 'Development list for mkgmap'
> Betreff: Re: [mkgmap-dev] documentation improvement
> 
> Hi Gerd, please find an updated patch and another for the splitter
> documentation that describe the current operation.
> 
> It seems wrong to me for splitter to put the default description in a
> comment if --geonames-file is used without also specifying -
> -description.
> This means that a tile that cannot get a suitable value from the
> geonames
> file will end up getting the description of the preceding tile. I
> think that
> splitter should always output a description to the template.args file
> when
> --geonames-file is specified.
> 
> Regards,
> Mike
> 
> -----Original Message-----
> From: Gerd Petermann [mailto:gpetermann_muenchen at hotmail.com]
> Sent: 08 April 2020 06:34
> To: 'Development list for mkgmap' <mkgmap-dev at lists.mkgmap.org.uk>
> Subject: Re: [mkgmap-dev] documentation improvement
> 
> Hi Mike,
> 
> I've attached the template.args generated for this command:
> java -jar d:\splitter\dist\splitter.jar --description=test
> --max-nodes=100000 --geonames-file=f:\osm\cities15000.zip
> f:\osm\bremen-latest.osm.pbf
> and
> java -jar d:\splitter\dist\splitter.jar --description=test
> --geonames-file=f:\osm\cities15000.zip  f:\osm\niedersachsen
> -latest.osm.pbf
> 
> Note that the one for Bremen is special because some tiles get the
> default
> description given with the --description option.
> 
> Gerd
> 
> ________________________________________
> Von: mkgmap-dev <mkgmap-dev-bounces at lists.mkgmap.org.uk> im Auftrag
> von Mike
> Baggaley <mike at tvage.co.uk>
> Gesendet: Mittwoch, 8. April 2020 00:55
> An: 'Development list for mkgmap'
> Betreff: Re: [mkgmap-dev] documentation improvement
> 
> Hi Gerd & Ticker,
> 
> Please find an updated patch that includes the essence of your
> comments on
> the --description option (I hope). Please let me know if you think
> further
> tweaks are needed.
> 
> Note, I'm not clear on the effect the splitter --geonames-file option
> has on
> the description. The splitter documentation only indicates it affects
> the
> file names of tiles. Does the splitter documentation need something
> adding?
> 
> There is still the question of whether the quote symbols need to be
> replaced
> with 'arc seconds' or whether the HTML creation process should be
> amended.
> 
> Also, clarification on the 3314/3312 values in --dem-dists.
> 
> Regards,
> Mike
> 
> -----Original Message-----
> From: Ticker Berkin [mailto:rwb-mkgmap at jagit.co.uk]
> Sent: 07 April 2020 10:34
> To: Development list for mkgmap <mkgmap-dev at lists.mkgmap.org.uk>
> Subject: Re: [mkgmap-dev] documentation improvement
> 
> Hi Gerd & Mike
> 
> @gerd - as you say, it is better to just improve the documentation of
> what is there. As far as I could see it was only the tiles and
> gmapsupp
> that took the --description.
> 
> I'd suggest changing from:
> 
> ;--description=text
> :       Set the descriptive text for the map. This may be displayed
> in
> QLandkarte, MapSource or on a GPS, where it is normally shown
> below the family name. Example: --description="Germany, Denmark"
> Please note: if you use splitter to build a template.args file
> and pass it to mkgmap, then that file may contain a "description"
> that will override this option. To prevent splitter from overriding
> your description, place the --description option
> after "-c template.args".
> 
> to:
> 
> ;--description=text
> :       Set the descriptive text of map components.
> Map tiles take the most recent --description before the --input-file
> that defines the tile.
> gmapsupp.img takes the last --description.
> Note that the splitter generated template.args includes
> relevant --description values (see splitter --geonames-file).
> The usage of the component descriptions is not consistent between
> GPS devices, MapSource, Basecamp and QLandkarte.
> Some use the --family-name to enable the complete map, others use the
> gmapsupp.img description.
> Some devices can enable individual tiles using the tile description.
> Suggested usage:
>   ... -c options.cfg -c template.args --family-name=Scandinavia
>   --description=Scandinavia --gmapsupp typFile.txt
> 
> @mike - if you & Gerd are happy with something like this, do you want
> to put it into your patch, otherwise I'll do it once your option
> changes are out of the way.
> 
> Ticker
> 
> On Tue, 2020-04-07 at 07:57 +0000, Gerd Petermann wrote:
> > Hi Ticker,
> > 
> > I think this was discussed before and that discussion lead to the
> > chapter about template.args. My suggestion would be to add a hint
> > that the last given description is used by the combiners. I found
> > usage in OverviewBuilder, TdbBuilder, and GmapsuppBuilder, not sure
> > what the other combiners use. NsisBuilder and GmapiBuilder should
> > be
> > checked.
> > I don't like the idea to introduce just another "description"
> > option
> > with unclear meaning, we already have so many.
> > I also don't like the idea that we might break backward
> > compatibility.
> > 
> > Gerd
> > 
> > ________________________________________
> > Von: mkgmap-dev <mkgmap-dev-bounces at lists.mkgmap.org.uk> im Auftrag
> > von Ticker Berkin <rwb-mkgmap at jagit.co.uk>
> > Gesendet: Montag, 6. April 2020 19:01
> > An: Development list for mkgmap
> > Betreff: Re: [mkgmap-dev] documentation improvement
> > 
> > Hi
> > 
> > This explains an annoyance I've had with my newer eTrex 30x.
> > 
> > On the eTrex HCx, the map selection function uses the --family-name
> > value. The same map on the 30x just gave the name of one of the
> > tiles,
> > which, now I look, was always the last.
> > 
> > Putting a final --description after the tile definitions now gives
> > me
> > something that will work sensibly on both.
> > 
> > I'd like to request an enhancement that gmapSuppBuilder uses a new
> > option instead of --description.
> > 
> > Ticker
> > 
> > On Mon, 2020-04-06 at 15:04 +0000, Gerd Petermann wrote:
> > > Hi Mike,
> > > 
> > > will have a closer look tomorrow. Why do you think that  "putting
> > > -
> > > -description after -c template.args " is incorrect?
> > > When you use splitter with the --geonames-file option or with the
> > > -
> > > -description option the template.args file will set
> > > description.
> > > If you use both the --description option is ignored.
> > > The last given value for description is used for the combiners.
> > > 
> > > Gerd
> 
> 
> _______________________________________________
> mkgmap-dev mailing list
> mkgmap-dev at lists.mkgmap.org.uk
> http://www.mkgmap.org.uk/mailman/listinfo/mkgmap-dev