deprecate --stable flag, add the --release flag

While at the same time maintaining the same behavior.

It also documents the changes. It issues a WARN message if used.