funcs moved into doc-ready func