updated manual and examples