Contrary to popular belief, Network manager _HAS_ some documentation.
You can find it here http://live.gnome.org/NetworkManager