documented registry function