[mkgmap-dev] documentation improvement

Wed Apr 8 08:40:39 BST 2020

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

-------------- next part --------------
A non-text attachment was scrubbed...
Name: splitter.txt.patch
Type: application/octet-stream
Size: 1068 bytes
Desc: not available
URL: <http://www.mkgmap.org.uk/pipermail/mkgmap-dev/attachments/20200408/e8eddc52/attachment.obj>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: options3.txt.patch
Type: application/octet-stream
Size: 5287 bytes
Desc: not available
URL: <http://www.mkgmap.org.uk/pipermail/mkgmap-dev/attachments/20200408/e8eddc52/attachment-0001.obj>