2020-12-17 07:11:54 -05:00
|
|
|
Code formatting
|
|
|
|
|
===============
|
|
|
|
|
|
|
|
|
|
Starting with (LUCENE-9564) Java code is enforced to comply with
|
|
|
|
|
google-java-format conventions. In theory you shouldn't worry about
|
|
|
|
|
what the convention actually looks like - write the code in any way
|
|
|
|
|
you like and then run:
|
|
|
|
|
|
|
|
|
|
./gradlew tidy
|
|
|
|
|
|
|
|
|
|
prior to running your regular precommit checks. This will reformat
|
|
|
|
|
your code so that it complies with the convention and passes gradle
|
|
|
|
|
'check' task.
|
|
|
|
|
|
|
|
|
|
IMPORTANT: There is *no* way to mark sections of the code as excluded
|
|
|
|
|
from formatting. This is by design and cannot be altered. In vast
|
|
|
|
|
majority of cases the formatter will do a great job of cleaning up the
|
|
|
|
|
code. Occasionally you may want to rewrite the code (introduce a local
|
2023-12-21 13:58:53 -05:00
|
|
|
variable or reshape code paths) so that it's easier to read after
|
2020-12-17 07:11:54 -05:00
|
|
|
automatic formatting.
|
