Update to reflect changes related to number of threads.

Document the new symbolic string values 'MAX_PHYSICAL' and 'MAX_LOGICAL'
for CHPL_RT_NUM_THREADS_PER_LOCALE.  Change terminology to talk about
physical CPUs and logical CPUs instead of cores and hyperthreads.