Merge remote-tracking branch 'upstream/main'

* upstream/main:
  Add hint on auto formatting (#13886)
  Add ADR-0050 on code formatter (#13895)
  Reformat codebase (more carefully) (#13885)
  New Crowdin updates (#13892)
  Fix record wrapping (#13889)
  Fix JavaDoc (#13888)
  Improve IntelliJ settings (#13887)
  Manual code reformattings (#13883)

Author: Siedlerchr

.jbang/CheckoutPR.java

@@ -1,3 +1,5 @@
+////usr/bin/env jbang "$0" "$@" ; exit $?
+
 import java.io.File;
 import java.util.List;
 import java.util.Optional;
@@ -15,8 +17,6 @@
 import org.kohsuke.github.GitHubBuilder;
 import org.kohsuke.github.PagedIterator;
 
-///usr/bin/env jbang "$0" "$@" ; exit $?
-
 //JAVA 21+
 //RUNTIME_OPTIONS --enable-native-access=ALL-UNNAMED
 
@@ -62,7 +62,7 @@ public static void main(String[] args) throws Exception {
             while (prIterator.hasNext()) {
                 pr = prIterator.next();
                 if ((contributor.isEmpty() || pr.getHead().getUser().getLogin().equals(contributor)) &&
-                    pr.getHead().getRef().equals(branchName)) {
+                        pr.getHead().getRef().equals(branchName)) {
                     found = true;
                     System.out.println("Found pull request #" + pr.getNumber());
                     break;
@@ -165,9 +165,9 @@ private static void checkoutUpstreamMain() throws Exception {
             // Check if a remote pointing to JabRef/jabref already exists
             List<RemoteConfig> remotes = git.remoteList().call();
             Optional<RemoteConfig> jabrefRemote = remotes.stream()
-                // We use "contains", because there could be SSH remote URLs
-                .filter(r -> r.getURIs().stream().anyMatch(uri -> uri.toString().contains("JabRef/jabref")))
-                .findFirst();
+                                                         // We use "contains", because there could be SSH remote URLs
+                                                         .filter(r -> r.getURIs().stream().anyMatch(uri -> uri.toString().contains("JabRef/jabref")))
+                                                         .findFirst();
 
             String remoteToUse;
             if (jabrefRemote.isPresent()) {
@@ -176,9 +176,9 @@ private static void checkoutUpstreamMain() throws Exception {
             } else {
                 System.out.println("Adding remote 'upstream' pointing to " + jabrefRepoUrl);
                 git.remoteAdd()
-                    .setName(upstreamName)
-                    .setUri(new URIish(jabrefRepoUrl))
-                    .call();
+                   .setName(upstreamName)
+                   .setUri(new URIish(jabrefRepoUrl))
+                   .call();
                 remoteToUse = upstreamName;
             }
 

.jbang/CloneJabRef.java

@@ -1,8 +1,8 @@
+///usr/bin/env jbang "$0" "$@" ; exit $?
+
 import java.nio.file.Files;
 import java.nio.file.Path;
 
-///usr/bin/env jbang "$0" "$@" ; exit $?
-
 //JAVA 21+
 //RUNTIME_OPTIONS --enable-native-access=ALL-UNNAMED
 

.jbang/JabKitLauncher.java

@@ -1,5 +1,3 @@
-///usr/bin/env jbang "$0" "$@" ; exit $?
-
 //JAVA 24
 //RUNTIME_OPTIONS --enable-native-access=ALL-UNNAMED
 

.jbang/JabLsLauncher.java

@@ -1,5 +1,3 @@
-///usr/bin/env jbang "$0" "$@" ; exit $?
-
 //JAVA 24
 //RUNTIME_OPTIONS --enable-native-access=ALL-UNNAMED
 
@@ -44,7 +42,6 @@
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
-
 /// Has to be started in the root of the repository due to <https://github.com/jbangdev/jbang-gradle-plugin/issues/11>
 public class JournalListMvGenerator {
 

.jbang/JabSrvLauncher.java

@@ -1,5 +1,3 @@
-///usr/bin/env jbang "$0" "$@" ; exit $?
-
 //JAVA 24
 //RUNTIME_OPTIONS --enable-native-access=ALL-UNNAMED
 

build-support/src/main/java/CitationStyleCatalogGenerator.java

@@ -1,6 +1,13 @@
 <code_scheme name="JabRef" version="173">
   <option name="RIGHT_MARGIN" value="0" />
   <option name="SOFT_MARGINS" value="120" />
+  <option name="DO_NOT_FORMAT">
+    <list>
+        <fileSet type="globPattern" pattern=".jbang/*.java" />
+        <fileSet type="globPattern" pattern="AutoCompletionTextInputBinding.java" />
+        <fileSet type="globPattern" pattern="SuggestionProvider.java" />
+    </list>
+  </option>
   <JavaCodeStyleSettings>
     <option name="DO_NOT_WRAP_AFTER_SINGLE_ANNOTATION" value="true" />
     <option name="SPACE_INSIDE_ONE_LINE_ENUM_BRACES" value="true" />
@@ -26,6 +33,7 @@
         <package name="" withSubpackages="true" static="true" />
       </value>
     </option>
+    <option name="RECORD_COMPONENTS_WRAP" value="0" />
     <option name="MULTI_CATCH_TYPES_WRAP" value="0" />
   </JavaCodeStyleSettings>
   <codeStyleSettings language="JAVA">
@@ -37,7 +45,7 @@
     <option name="ALIGN_MULTILINE_CHAINED_METHODS" value="true" />
     <option name="ALIGN_MULTILINE_TERNARY_OPERATION" value="true" />
     <option name="SPACE_BEFORE_ARRAY_INITIALIZER_LBRACE" value="true" />
-    <option name="TERNARY_OPERATION_WRAP" value="5" />
+    <option name="DOWHILE_BRACE_FORCE" value="3" />
     <arrangement>
       <rules>
         <section>
@@ -298,4 +306,4 @@
       </rules>
     </arrangement>
   </codeStyleSettings>
-</code_scheme>
+</code_scheme>

build-support/src/main/java/JournalListMvGenerator.java

@@ -0,0 +1,157 @@
+---
+nav_order: 50
+parent: Decision Records
+---
+# Use custom code style
+
+## Context and Problem Statement
+
+Code should be formatted consistently.
+Which code style and auto formatter to be used?
+
+## Decision Drivers
+
+* Consistency to the Java world (to lower the cognitive load)
+* Maintained tooling to reduce risk of non-working tooling in the future
+
+## Considered Options
+
+* Use custom code style
+* Use prettier-java
+* Use palantir-java-format
+* Use google-java-format
+* Use spring-javaformat
+* Use eclipse formatter
+
+## Decision Outcome
+
+Chosen option: "Use custom code style", because comes out best (see below).
+
+### Consequences
+
+* Good, because the style closely follows the maintainer's expectations on code formatting
+* Good, because the IntelliJ tooling works reasonably well
+* Bad, because users need to setup IntelliJ to use the code style
+
+## Pros and Cons of the Options
+
+<!-- markdownlint-disable-next-line MD024 -->
+### Use custom code style
+
+IntelliJ offers to customize the code style and export it into an XML file.
+
+* Good, because the style closely follows the maintainer's expectations on code formatting
+* Good, because the IntelliJ tooling works reasonably well
+* Bad, because users need to setup IntelliJ to use the code style
+* Bad, because depends on IntelliJ's capabilities (and is not tool-independent)
+* Bad, because the statement after `->` is [always on the next line](https://youtrack.jetbrains.com/issue/IDEA-330487/Disable-line-breaks-after-switch-cases-on-simple-on-liner-case-blocks-in-switch-expression).
+
+### Use prettier-java
+
+[prettier-java](https://github.com/jhipster/prettier-java) is a prettier plugin for Java.
+
+It uses around [80 characters as soft width limit](https://prettier.io/docs/options#print-width):
+
+> For readability we recommend against using more than 80 characters:
+>
+> In code styleguides, maximum line length rules are often set to 100 or 120. However, when humans write code, they don’t strive to reach the maximum number of columns on every line. Developers often use whitespace to break up long lines for readability. In practice, the average line length often ends up well below the maximum.
+>
+> Prettier’s `printWidth` option does not work the same way. It is not the hard upper allowed line length limit. It is a way to say to Prettier roughly how long you’d like lines to be. Prettier will make both shorter and longer lines, but generally strive to meet the specified `printWidth`.
+
+We tried out at <https://github.com/JabRef/jabref-koppor/pull/717>.
+
+Example:
+
+```java
+        action
+            .getKeyBinding()
+            .ifPresent(keyBinding ->
+                keyBindingRepository
+                    .getKeyCombination(keyBinding)
+                    .ifPresent(combination -> setAccelerator(combination))
+            );
+```
+
+* Good, because `prettier-java` is updated regularly.
+* Good, because the subject is "always" in the first thing in the line.
+* Good, because it also formats the imports
+* Neutral, because optimized for code review (because of the 80 characters width):
+  Favors short lines (80 characters); the reading is more top-to-buttom; screens are typically wider.
+* Bad, because [prettier-action cannot be used](https://github.com/creyD/prettier_action/issues/149)
+* Bad, because [has line breaks at single variables](https://github.com/jhipster/prettier-java/issues/777)
+
+## Use palantir-java-format
+
+Example:
+
+```java
+        action.getKeyBinding().ifPresent(keyBinding -> keyBindingRepository
+                .getKeyCombination(keyBinding)
+                .ifPresent(combination -> setAccelerator(combination)));
+```
+
+* Good, because [optimized for code review](https://github.com/palantir/palantir-java-format#optimised-for-code-review)
+* Bad, because [not compatible with JDK21](https://github.com/palantir/palantir-java-format/issues/934). Especially, [does not support `_`](https://github.com/palantir/palantir-java-format/issues/1236)
+
+## Use google-java-format
+
+* Bad, because [Markdown JavaDoc cannot be used](https://github.com/google/google-java-format/issues/1193)
+* Bad, because [does not support `format:off` comments](https://github.com/google/google-java-format/issues/137).
+* Bad, because not actively maintained; there are [139 opened issues](https://github.com/google/google-java-format/issues?q=sort%3Aupdated-desc%20is%3Aissue%20is%3Aopen&page=1).
+
+## Use spring-javaformat
+
+[spring-javaformat](https://github.com/spring-io/spring-javaformat) is a code style of Spring.
+The plugin is automatically activated in IntelliJ. For the code style, see <https://github.com/spring-projects/spring-framework/wiki/Code-Style>.
+
+We tried out at <https://github.com/JabRef/jabref-koppor/pull/716>.
+
+* Neutral, because each class field is separated by an empty line:\
+
+   ![empty lines between class fields](assets/0050-spring-empty-lines.png)
+
+* Bad, because merges lines together where it should not:
+
+   ![style merges lines](assets/0050-spring-merge.png)
+
+* Bad, because `import` statements are not handled.
+* Bad, because we need to accept that `else` starts on the "first" column. ("Kernighan and Ritchie style") -> <https://github.com/spring-projects/spring-framework/wiki/Code-Style#block-like-constructs-kr-style>
+* Bad, because it provides bad wrapping:
+
+    ```diff
+        /**
+    -     * Add X11 clipboard support to a text input control. It is necessary to call this method in every input where you
+    -     * want to use it: {@code ClipBoardManager.addX11Support(TextInputControl input);}.
+    -     *
+    -     * @param input the TextInputControl (e.g., TextField, TextArea, and children) where adding this functionality.
+    -     * @see <a href="https://www.uninformativ.de/blog/postings/2017-04-02/0/POSTING-en.html">Short summary for X11
+    -     * clipboards</a>
+    -     * @see <a href="https://unix.stackexchange.com/questions/139191/whats-the-difference-between-primary-selection-and-clipboard-buffer/139193#139193">Longer
+    +     * Add X11 clipboard support to a text input control. It is necessary to call this
+    +     * method in every input where you want to use it:
+    +     * {@code ClipBoardManager.addX11Support(TextInputControl input);}.
+    +     * @param input the TextInputControl (e.g., TextField, TextArea, and children) where
+    +     * adding this functionality.
+    +     * @see <a href=
+    +     * "https://www.uninformativ.de/blog/postings/2017-04-02/0/POSTING-en.html">Short
+    +     * summary for X11 clipboards</a>
+    +     * @see <a href=
+    +     * "https://unix.stackexchange.com/questions/139191/whats-the-difference-between-primary-selection-and-clipboard-buffer/139193#139193">Longer
+        * text over
+    ```
+
+    ```diff
+    -    public ArgumentProcessor(String[] args,
+    -                             Mode startupMode,
+    -                             PreferencesService preferencesService,
+    -                             FileUpdateMonitor fileUpdateMonitor,
+    -                             BibEntryTypesManager entryTypesManager) throws org.apache.commons.cli.ParseException {
+    +    public ArgumentProcessor(String[] args, Mode startupMode, PreferencesService preferencesService,
+    +            FileUpdateMonitor fileUpdateMonitor, BibEntryTypesManager entryTypesManager)
+    +            throws org.apache.commons.cli.ParseException {
+    ```
+
+## Use eclipse formatter
+
+* Good, because it [can be used in IntelliJ](https://github.com/krasa/EclipseCodeFormatter)
+* Bad, because not actively maintained