update documentation recommending use of Elpa for LCAO.  Update example on how to write high-performance code with LCAO

update documentation/docstrings that mention scalapack variables.  (Several are probably way outdated anyway)

update documentation of parallel keywords including the new 'order' keyword and the slightly less new 'kpt' keyword.

merges changes from trunk rev 9967 into the solvation branch
refactores solvation classes
adds new options for smoothed step functions

by popular demand, add keyword to choose scalapack parameters automatically.  Update documentation accordingly