added examples & compatibility info