restored 2.x docs with warning