doc: document more number methods, with samples