Pulse In

Hello, I have recently come across this code, http://www.arduino.cc/en/Reference/PulseIn

I know what it does: reads the pwm input. But I don't exatly know how to use it. Is there any examples on setup, and projects asscoiated with Pulse In, or maybe some better documentation would help...? Thanks guys!

This isn't really a bug or suggestion, is it?
What's wrong with the documentation here:http://arduino.cc/en/Reference/PulseIn?

I know what it does: reads the pwm input.

No, not really; it reads any digital input and allows you to measure the width of positive or negative pulses.