Added doxgen comments : trap.c

added doxgen comments : trap.c