=======================
Notes for STLport Users
=======================

Iterator Issues
---------------

The STLport library seems to use the identical
iterator type for both set and multiset, and also
an identical type for both map and multimap. 

I could thus not come up quickly with an approach
that would guarantee a proper type qualification for
these iterators. Therefore, I decided to use a "generic"
name for both of the iterator types in the "set" family,
"gen_set<t>::iterator", and another generic name for
the map-family of iterators: gen_map<t>::iterator. By
using these names, the iterator policy code applies to
all iterators regardless of platform.

I suppose there's probably a way to have set iterators
be set<T>::iterator and multiset iterators be multiset<T>,
perhaps by scanning forward for the "multi" or lack of it;
however, this just seems kludgey because there may be *other*
types later on the line with "multi" in them and that
sort of special casing is just asking for trouble.

Debug mode: All "debug" iterators reduce to: "dbg_iter"
in debug mode. 


VC7/.NET issues:
----------------

When using the STLport library with VC7, there are still 
some issues with maps that I haven't completely figured out. 
Consider this a "work in progress".