prune path behavior, both the method and flag(s), is under-specified

[luketpeterson]

We need clear precise documentation on the pruning behavior.

(Optional) We also ought to audit the API so any method capable of removing a subtrie gets a prune flag. Most already have it but I can think of a couple that don't.