Update `gen_aidl` documentation to be more clear

Created by: sdwilsh

This fixes https://github.com/facebook/buck/issues/103

Test Plan: Loaded http://localhost:9811/rule/gen_aidl.html