In several places the docs suggest running the

update-build-files

goal, but is there any reason to prefer that over

pants.backend.build_files.fix.deprecations

? https://github.com/pantsbuild/pants/pull/17240/files

update-build-files runs that no?

Correct. Why have an extra goal when one can 'just' use

fix

?

It does some more stuff like format afaict https://github.com/pantsbuild/pants/blob/fdfd8d2a2ff985f8b8bae869b5467f6e48f65888/src/python/pants/core/goals/update_build_files.py#L512-L527

I think it's mostly historical at this point though

yea, that's from when that was the only way. It was added as a dedicated goal before

fix

existed. Then that feature was included as part of

fix

but the old goal is kept to not disrupt existing workflows, but the docs ought to be updated..