doc: groom README and man page a bit.

Mainly, we are no longer in the 'experimental' phase.