include better docs on software_gem option