document workaround.