У меня есть несколько сложных регулярных выражений, которые мне нужно комментировать для удобства чтения и обслуживания. Спецификация Java довольно лаконична, и я долго пытался заставить это работать. Я наконец поймал свою ошибку и опубликую ее как ответ, но ябуду благодарен за любые другие советы по поддержанию регулярных выражений

В качестве примера я хочу прокомментировать субкомпоненты (из patternS) в простом парсере имен:

    String testTarget = "Waldorf T. Flywheel";
    String patternS = "([A-Za-z]+)\\s+([A-Z]\\.)?\\s+([A-Za-z]+)";
    Pattern pattern = Pattern.compile(patternS, Pattern.COMMENTS);
    Assert.assertTrue(pattern.matcher(testTarget).matches());

РЕДАКТИРОВАТЬ: Я был бы благодарен за примеры формата (? X).

РЕДАКТИРОВАТЬ: @ Geowa4 есть хорошее предложение, которое избегает встроенных комментариев. Sinnce Java и другие предоставили встроенные комментарии, в каких случаях они полезны? (Я думаю, у меня есть дело, но ябыло бы интересно увидеть других).

РЕДАКТИРОВАТЬ: Как отмечено ниже @mikej, регулярное выражение не поддерживает дополнительную начальную скважину и будет лучше, как:

        String patternS = "([A-Za-z]+)\\s+([A-Z]\\.\\s+)?([A-Za-z]+)";

но это в конечном итоге извлекает место в начальном