[pstreams-users] Include path for pstream.h

[Jonathan W. <re...@ka...>]

I have been contacted by Antonio S. de A. Terceiro, who is preparing a
debian package for PStreams, and I am in the process of writing an RPM
spec file. This means I can no longer avoid the sticky question of where
to install the pstream.h file. Antonio and I have decided that the file
should be installed in $PREFIX/include/pstreams/pstream.h (where $PREFIX
is /usr/local/ or /usr). This means you should include it in your code
like so:

    #include <pstreams/pstream.h>

The rationale for this is that other packages could install a file
called pstream.h which could clash with my header. To avoid this,
PStreams installs to a sub-directory of include/ and should be included
by specifying the sub-directory name.

It is preferable to specify the sub-directory name in the #include
directive, rather than specifying it on the command line with "-I". This
is because it avoids an extra "-I" option just for pstream.h (assuming
that $PREFIX is already in the set of include directories).

Additionally, there will be a process.h header as part of PStreams at
some point, which would be even more likely to clash with headers from
other libraries if it wasn't in the pstreams sub-directory.

Comments welcome, as ever,

jon