The banner in the generated requirements.txt is confusing

[jceresini]

When I use pip-compile to generate a requirements.txt file, it includes this banner at the top:

# This file is autogenerated by pip-compile with python 3.8
# To update, run:
#
#    pip-compile --no-emit-index-url

However, without the --upgrade argument, that command won't generate a new requirements.txt file, unless the setup.py changes. It sounds like it's the distinction between updating the file vs upgrading the packages pinned in the file. As a new user, I found that confusing when subsequent runs of pip-compile weren't picking up upgraded packages.

Ref: https://github.com/jazzband/pip-tools/blob/master/README.rst?plain=1#L64-L68

[AndydeCleyre]

Just adding a note: even if the setup.py doesn't change, the output file may be updated if dependency versions get revoked, or if the command is run on a different platform resulting in a different dep tree.

[atugushev]

Agreed. Perhaps, there should be mentioned that a file is autogenerated by the command.

[CodePint]

just jumping on this to say; it would also be appreciated if the command was multiline