[mkgmap-dev] documentation improvement patch

Tue Dec 31 00:31:09 GMT 2019

Hi Gerd, it looks like I inadvertently indented one section of the file
which caused the blanks. I have reworked the program so that it now has a
very basic understanding of paragraphs and can do the line length limiting
itself. It only has a very basic understanding of HTML (just ,<p>, <pre> and
</pre> and only when on a line by themselves). I have reverted my manual
chopping up of lines in options.txt, so there are now far fewer changes
(though I have fixed a few more typos) so it's much easier to see what is
going on (still lots of changes in the generated options file of course). I
have chopped out a number of <p> tags in options.txt for consistency - there
were some places where it was used before a new option and some where it was
not. Looking at the existing web page, you can see a small difference in
spacing between the two cases.  I just run the buildoptions program from
within my Eclipse Java environment. You can compile and run it by following
the following steps assuming you have a command prompt with its working
directory set to the mkgmap root directory:

cd options
javac buildoptions\main.java
java buildoptions.main

Note that so that the above works, I have changed the hard coded paths to
the input and output files to be relative to the options folder, so if
running from Eclipse, you need to set the working directory to
${workspace_loc:mkgmap/options} instead of using the default.

Cheers,
Mike

-----Original Message-----
From: Gerd Petermann [mailto:gpetermann_muenchen at hotmail.com] 
Sent: 30 December 2019 09:40
To: Mike Baggaley <mike at tvage.co.uk>; 'Development list for mkgmap'
<mkgmap-dev at lists.mkgmap.org.uk>
Subject: AW: [mkgmap-dev] documentation improvement patch

Hi Mike,

thanks for the work. The patch applies fine now.
I don't understand some of the reformatting in options.txt.  I think they
were not intended.
See for example --split-name-index: Blanks at the beginning of the lines and
"See also option road-name-config." is no longer on a separate line.

It seems I am to stupid to run the java program on my machine :(
Please desribe the steps to compile and run it.

Looking at the source it seems you want to force max. 80 characters on one
line in the options.txt file so that the
buildoptions program doesn't have to reformat paragraphs?
This looks like a complicated work flow when I edit options.txt:
Edit, save, run buildoptions program, check if it complains about lines
longer than 80 characters, edit again ...
I think the java code should be able to detect a paragraph and split it into
pieces?

Gerd

-------------- next part --------------
A non-text attachment was scrubbed...
Name: doc-v5.patch
Type: application/octet-stream
Size: 183702 bytes
Desc: not available
URL: <http://www.mkgmap.org.uk/pipermail/mkgmap-dev/attachments/20191231/a49a49e1/attachment-0001.obj>