documented BCP 47 semantics

Change-Id: Ia2fad8e79833a66bb3e95047fc5885880d6da17c