there is very little documetation for the --target flag

[whitequill]

there is very little documetation for the --target flag

[whitequill]

the way I am using the --target flag is like this:
sudo ${HOME}/gitrepos/blender/extern/python/bin/pip3.12 install pybullet requests zstandard numpy brotli pyblas numpy --target ${HOME}/gitrepos/blender/extern/python/lib/python3.11/site-packages

[pfmoore]

While your point about documentation is fair (there is some documentation, under the command options for pip install) for this use case I think you should be using --prefix.

Documentation on the use of, and differences between, --prefix, --root, and --target would be useful, the problem is likely to be finding someone who understands the subtle differences and which flags are appropriate for which use cases 🙁

[whitequill]

I did find the information here on the official webpage: https://pip.pypa.io/en/stable/cli/pip_install/.
Google and other search engines don't send you here when one is looking for the information.