documented chromo function