[mkgmap-dev] Options overhaul

Fri Mar 25 18:50:30 GMT 2011

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 03/25/2011 06:17 AM, Steve Ratcliffe wrote:

> 2. Add a way to document old options and and give a warning that the
> option is no longer in use and what should replace it if anything.
> This will allow for options to be removed from the help list, without
> actually removing them from the program, so as not to break existing
> scripts.
> 
> If anyone has any thoughts on how the options could be improved now
> would be a good time to discuss it.
> 
> ..Steve
> _______________________________________________

As a user, I would rather see a warning that the option is deprecated
and will be removed in a future version. In this application, that
future version might be reported by a date 6, 9, or 12 months from now.
This will give all developers enough time to make sure that all
new/modified options are working as they should, and give downstream
providers, gmapsupp creators, and other administrators of tools that
depend on mkgmap ample notice that the application will be substantially
changing.

Additionally, if there is a flurry of activity on the users maillist
about arguments being deprecated, it may warrant rethinking on a
particular configuration option or better documentation of the replaced
option.

- -- 
Jeff Harris. OASAASLLS
http://barbershopbass.com/public.key
2006 Barbershopper of the Year, AHSOW
Fremont-Hayward Chapter Alumnus
Random Baritone Guy, Palo Alto-Mountain View Chapter
www.barbershop-harmony.org
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJNjOPyAAoJELq82vdIW8cwr38H/1kFu/YiVVv2RsywOsdtEAAN
2iD/VujYjqnysHcX7LmX673YxQbNpWpS6QPEztd/m+d3oQI9iLpaOziCdnJLGYsI
X/QYb3Xa2T7zxxSGCWXa0yo9Vd6JuXtk19ahbMkvGq0PfBG3Z1p3Brw+0PLXq/rS
HmXsvXsY7CBDGIctzAi9ZB0N/3N8vwQL3N91LyOZYvVwy0w48Ns4QvQ3iacAqJlF
vYMCB3ApqrYf2bjnoxNvUh62XUVDxSpUekyiHBvWagU4wNLK12bQrGQF/LwIFsJV
z79QcNFXe2Xb7SS5vm5eZ9Sib+HLnhN+EYBM7gYes/Ja7dGPLNyPDRbEOPSbST8=
=taMi
-----END PGP SIGNATURE-----