Bug 678732 - gimp-image-insert-layer inserts into a wrong place...
Fix the docs, the function does what it's supposed to do. Passing "0, -1" actually means "insert where the ui would insert" and is supposed to be used when e.g. scripts create layers.
Showing with 12 additions and 10 deletions