Preprocessor Gradle plugin behavior

[Jolanrensen]

As discussed in https://github.com/Kotlin/dataframe/pull/616 and https://github.com/Jolanrensen/docProcessorGradlePlugin/issues/40#issuecomment-1991382530 the preprocessor plugin can sometimes behave a bit odd.

Currently, it's configured to run automatically on each commit and add all newly generated files to Git. This comes with a few downsides:

• You cannot specify which generated files to commit without turning off the commit hook
• The processor is run each time a Jar is created or something is committed, even when nothing has changed in the source/generated files

Actually, the generated files only need to be updated when:

• ~the input has changed~
• ~the output has changed (if we make the output Read only, we only need to detect file deletions~

And as for the SimpleGit auto-add, only the files that are added/have commits in the src folder should be added in the generated-sources folder.

[koperagen]

In the IDEA there's similar thing: you can run analysis for commit. Now it would not block the commit itself, but only notify user afterwards when analysis is finished. We cannot create IDE notification, but anyway if preprocessor will run and generate new files it should be enough for author to notice and maybe amend commit themselves. So i propose to not block commit / run post-commit hook that only generates files (without automatically adding them)

[Jolanrensen]

https://github.com/Jolanrensen/docProcessorGradlePlugin/releases/tag/v0.3.6 fixes a small piece of the behavior