empty function added + documentation improved