dweiss commented on a change in pull request #73:
URL: https://github.com/apache/lucene/pull/73#discussion_r609807318
##########
File path: help/regeneration.txt
##########
@@ -0,0 +1,23 @@
+Regeneration
+============
+
+Lucene makes use of some generated code (e.g. jflex tokenizers).
+
+Examples below assume cwd at the gradlew script in the top directory of
+the project's checkout.
+
+
+Generic regeneration commands
+------------------------------
+
+Regenerate code:
+
+gradlew regenerate tidy
+
+Force-regenerate code, even when it isn't necessary:
+
+gradlew --rerun-tasks regenerate tidy
+
+Force-regenerate code, except for one tokenizer which is extremely slow:
Review comment:
Most regeneration tasks are incremental at the moment - they do sense if
they need to run or not. There should be a big red "last resort" option in this
help file because in 99% of cases this should do the job: gradlew regenerate.
That's it. Skips over tasks that have the same inputs/ outputs, regenerates and
tidies up everything else. I've tested it on Linux and Windows and it really
does work. The trouble you fell into today was caused by the fact that you use
the low-level regeneration task and regenerate has all sorts of tweaks to make
those tasks incremental and clean up formatting, etc.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
