API comments (WAS: Re: Current osmo-pcu patch set)