docs: public void resolveReferences() throws RepositoryException {
          if (resolveFutures.isEmpty()) return;
  
          List<ResolveFuture> futures = resolveFutures;
          resolveFutures = new LinkedList<ResolveFuture>();
          for (ResolveFuture future : futures) {
              future.resolve(); // anything not resolved goes back on the new 'resolvedFutures' list ...
          }
      }