>>    2. The problem with the include variable syntax is because `quail-help'
>>       (which is used eventually by `describe-input-method') calls
>>       `substitute-command-keys' on the docstring so to get the intended
>>       behaviour, one has to write \\=\\<VAR> not \\<VAR>.  The logic,
>>       otherwise, is fine.  Maybe this needs to be documented?
>
> Yes, please.
>

I tried to fix this, please see attached patch,