What's the difference between bun install --production and bun install --frozen-lockfile?

[pierskarsenbarg]

From reading https://bun.sh/docs/cli/install:

My interpretation is that:

bun install --production will install packages unless it's in devDependencies or optionalDependencies, however if package.json is different from bun.lock{b} then it'll just update the lock file.

bun install --frozen-lockfile will compare the lock file with what's in package.json and if there's a difference then it exits with an error.

However, I'm using --production and getting: error: lockfile had changes, but lockfile is frozen

Am I mis-interpreting the docs or are the docs wrong (or is there a bug)?

related #10949