[maintenance] docu + pointer cleanup