Closed PolarGoose closed 1 week ago
I have uncommented set -o xtrace line. Do we really want it to be commented out? Then, it is not clear what happens when scripts are run.
I'd prefer it commented out. The general rule for build scripts is to be silent or output only a few "this step is complete" messages on successful execution, and be verbose only in case of errors (and then keep verbosity scoped to the error). This way developers don't have to needlessly look at pages of text, trying to understand why it was printed and if it contains some errors/warnings that require attention. We keep to this rule of thumb in other re2c build /test scripts, build system, etc.
In particular, I run this script quite often when working on the docs, and I'd like to see as small output as possible when I focus on the content changes (not script changes). If you wish, you can add a --verbose
option (or if you really prefer verbose by default, add a --quiet
option).
FYI I added a few options to the sync script.
I'd prefer it commented out.
Ok, np. If it is more convenient, then it is fine. I have commented it out like it was before.
I have uncommented
set -o xtrace
line. Do we really want it to be commented out? Then, it is not clear what happens when scripts are run.