doc: document more number methods, with samples

add PN_number to GC protected area.
bleach method comment style from '///' to '/* */' in number.c