tentatively rename allow_oversubscribe, document

[jlnav]

No description provided.

[coveralls]

Pull Request Test Coverage Report for Build 1261935208

• 2 of 2 (100.0%) changed or added relevant lines in 2 files are covered.
• 60 unchanged lines in 14 files lost coverage.
• Overall coverage increased (+0.7%) to 92.542%

---

Files with Coverage Reduction	New Missed Lines	%
libensemble/alloc_funcs/give_pregenerated_work.py	1	93.33%
libensemble/alloc_funcs/give_sim_work_first.py	1	95.0%
libensemble/alloc_funcs/start_only_persistent.py	1	97.06%
libensemble/resources/mpi_resources.py	1	76.87%
libensemble/tools/alloc_support.py	1	94.52%
libensemble/alloc_funcs/inverse_bayes_allocf.py	2	92.31%
libensemble/alloc_funcs/only_one_gen_alloc.py	2	90.0%
libensemble/alloc_funcs/start_fd_persistent.py	2	93.44%
libensemble/alloc_funcs/start_persistent_consensus.py	2	93.68%
libensemble/alloc_funcs/start_persistent_local_opt_gens.py	2	95.24%

Totals
Change from base Build 1259005701:	0.7%
Covered Lines:	6155
Relevant Lines:	6576

---

💛 - Coveralls

[shuds13]

A grep shows couple of mentions of allow_oversubscribe still in docs