Change main header file name (or provide alternative)

[andrew.bell.ia@…]

map.h was used to store C++ library map data structure definitions before the
standard became formal and still exists on many systems.  This can cause a
conflict which searching for the mapserver map.h file.  Suggest renaming map.h,
or providing an alternative file (mapserver.h, perhaps) which would simply
include a well-specified map.h to avoid naming conflicts:

#ifndef MAPSERVER_H
#define MAPSERVER_H

#include "./map.h"

#endif

[dmorissette]

I have always feared that the name map.h was a bit too generic and could
eventually cause conflicts.

I think renaming it to something like mapserver.h might be best, unless we're
worried that this could possibly cause confusions with the already existing
mapserv.h.

Adding other developers to CC to get their thoughts.

[sdlime]

mapserver.h sounds fine to me. I can't see why changing that would impact users 
at all. - Steve

[fwarmerdam]

I am ok with changing it to mapserver.h, but I can't help but wonder if there
is any other rationalization we ought to do at the same time.  

[hobu]

Should we revisit this change for the 5.0 release? Any external clients using MapServer through C would be affected, but all of the mapscripts could be changed without much trouble.