Document error cases for AlarmManager methods and add examples regarding...

... the crossing of timezone or DST boundaries