Document RTS behaviour upon encountering '--'.

The RTS treats -- specially: https://gitlab.haskell.org/ghc/ghc/blob/master/rts%2FRtsFlags.c#L701

This behaviour is very useful (I needed it today) and seems documented only in the oral tradition of #haskell. Perhaps it is time to write it down.