[PATCH] Doxygen documentation for slist

[Lorenz Minder]

Hi,

cow@compsoc.man.ac.uk:
> I guess it was the information about iterator invalidation that has
> taken a bit longer to seep through my brain.

Oh! I was never talking about that part, myself. It's still there, and I
don't think it should be taken out.

The fact that iterators are not invalidated is particular to lists: It
does not hold for vectors, for example.

So I definitely think this part should be left there.

Jonathan, am I correct in assuming you weren't talking about that
sentence either?

> I never imagined replicating any of this information per function. 
> Once per file would be best IMO.

I vote for leaving it once per function; splicing has different semantics,
for example.

--Lorenz