small fixes to listing
 module fixes plus add better docs