change _use_root to _use_global_spec and document it