more complete descriptions of features and gotchas relating to new
configuration