Update documentation to mark the generator deprecated. Add a warning at the end of generation plus an option to turn off the warning.
Run "cmake --help-full cmake.1.rst" by hand on Windows and OS X. Copy the generator/*.rst documents for generators unique to those platforms into Help/generator.