set meaninful return code & updated readme