[mkgmap-dev] documentation improvement

Tue Apr 7 08:57:24 BST 2020

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
>
>
> ________________________________________
> Von: mkgmap-dev <mkgmap-dev-bounces at lists.mkgmap.org.uk> im Auftrag
> von Mike Baggaley <mike at tvage.co.uk>
> Gesendet: Montag, 6. April 2020 16:46
> An: 'Development list for mkgmap'
> Betreff: [mkgmap-dev] documentation improvement
>
> Hi Gerd, please find attached a small patch that improves the
> documentation
> primarily for the following, but with a few other minor tweaks:
>
> removal of the statement about putting --description after -c
> template.args,
> as this incorrect
> simplification of the description of --style-file as this was
> confusing
> clarification that the number of bytes are the file sizes in the Hill
> Shading section
>
> I note that the '' symbols used to denote arcseconds are being
> interpreted
> as italic identifiers <i></i> by whatever process produces the web
> page. I
> suggest this process needs to be changed so that this does not
> happen. I
> have replaced the first mentions of '' with words. If the process
> cannot
> easily be changed, I suggest that the remaining  '' symbols are
> replaced
> with arc second or arc seconds.
>
> I also note that the --dem-dists mentions that values should be a
> multiple
> or submultiple of 3314 or 9942 then goes on to suggest values that
> are
> multiples of 3312, which I believe is the nearest value to 3314 that
> is a
> multiple of 16. I think the explanation needs some improvement by
> someone
> who knows exactly how it works. I have been experimenting with
> various
> values of --dem-dists - the default value of 9936 works fine for me
> at
> higher resolutions in Basecamp, but becomes very blocky at low
> resolution. I
> find --dem-dists=9936,9936,9936,9936,9936,9936,39744,317952 gives the
> best
> results for my levels of 0:24,1:22,2:21,3:20,4:19,5:18,6:17,7:15.
> Based on
> this, I'd be very surprised if the example in the documentation of
> --dem-dists=3312,13248,26512,53024 for levels 0:24, 1:22, 2:20, 3:18
> gives
> decent results at resolution 18. However, not having any 1 arc second
> DEM
> data, I can't try it.
>
> Regards,
> Mike
> _______________________________________________
> mkgmap-dev mailing list
> mkgmap-dev at lists.mkgmap.org.uk
> http://www.mkgmap.org.uk/mailman/listinfo/mkgmap-dev
_______________________________________________
mkgmap-dev mailing list
mkgmap-dev at lists.mkgmap.org.uk
http://www.mkgmap.org.uk/mailman/listinfo/mkgmap-dev