make a simpler generic api that looks right for global (bug 825347)