Improve Javadoc

opentripplanner · Feb 19, 2025 · 933280b · 933280b
1 parent 7b213ba
commit 933280b
Showing 1 changed file with 5 additions and 4 deletions.
diff --git a/application/src/main/java/org/opentripplanner/transit/service/TimetableRepository.java b/application/src/main/java/org/opentripplanner/transit/service/TimetableRepository.java
@@ -525,11 +525,12 @@ public void addFlexTrip(FeedScopedId id, FlexTrip<?, ?> flexTrip) {
   }
 
   /**
-   * Sets the updater manager for this repository.
+   * Sets the updater manager for this repository and makes sure the configured updaters
+   * are correctly applied to {@code transitAlertService}.
    * <p>
-   * Note: this also resets the {@code transitAlertService} so that the next call to
-   * {@link TimetableRepository#getTransitAlertService()} will then create a new instance
-   * of it.
+   * Note: before this method is called an empty {@code transitAlertService} is returned instead.
+   * <p>
+   * This logic is unfortunate and quite brittle. We would like to improve it in the future.
    */
   public void setUpdaterManager(GraphUpdaterManager updaterManager) {
     this.updaterManager = updaterManager;