docs: public void setPrincipals(Set<JsonEntityBean> newPrincipals, boolean initPermissionsForNew) {
  
          final Set<JsonEntityBean> previousPrincipals = new HashSet<>(principals);
          principals.clear();
          principals.addAll(newPrincipals);
  
          if (initPermissionsForNew) {
              principals.stream()
                      .forEach(
                              bean -> {
                                  if (!previousPrincipals.contains(bean)) {
                                      /*
                                       * Previously unknown principals receive BROWSE & SUBSCRIBE by
                                       * default (but not CONFIGURE!);  known principals do not receive
                                       * this treatment b/c we don't want to reset previous selections.
                                       */
                                      initPermissionsForPrincipal(bean);
                                  }
                              });
          }
      }