[Proj] [patch] add missing projects.h

[Sisyphus]

----- Original Message ----- 
From: "Mateusz Loskot" <mateusz at loskot.net>
To: "PROJ.4 and general Projections Discussions" <proj at lists.maptools.org>
Cc: "Mark Brand" <mabrand at mabrand.nl>
Sent: Monday, March 26, 2012 9:35 PM
Subject: Re: [Proj] [patch] add missing projects.h


> On 26 March 2012 11:18, Greg Troxel <gdt at ir.bbn.com> wrote:
>>
>> I had the impression that not installing projects.h was a conscious
>> choice in 4.8.0. So perhaps it belongs in noinst_include_HEADERS, but
>> your patch seems to revert the planned withdrawal, as noted in NEWS.
>
> Indeed, projects.h is a private header, not part of public API.

Oh ... so I guess our programs should no longer begin with:

#include <projects.h>

But if we delete that inclusion, will the programs still build ok against 
4.7.0 and earlier ?

I recently updated from 4.7.0 to 4.8.0 and found a program (that began by 
including projects.h) no longer built - the build failed with an error about 
the unknown projCtx_t type. The projCtx_t type is defined in the 4.8.0 
projects.h, but not the 4.7.0 projects.h (which was the projects.h that got 
loaded).
Naturally, I fixed the error by replacing that 4.7.0 projects.h with a copy 
of the projects.h from the 4.8.0 source :-))
(I did wonder why 'make install' had not done that for me .... )

This particular program will likely be built in various places by various 
people using different versions of the proj library, so the code needs to be 
portable.

Cheers,
Rob