add descriptor interface (unused right now)

+ formatting