The function interface, including the doc comment, should encapsulate the implementation complexity. Now we have fixed a bug in the implementation and found that the doc is wrong. Leaving it wrong will only bite us the next time we use it.

Either fix the doc right away or add a "FIXME: PREFIXLEN is actually set" so that we know to fix it when porting to master.