docs: static PairTable newInstanceFromPairsArray(final int[] pairs, final int numPairs, final int lgK) {
      int lgNumSlots = 2;
      while ((upsizeDenom * numPairs) > (upsizeNumer * (1 << lgNumSlots))) {
        lgNumSlots++;
      }
      final PairTable table = new PairTable(lgNumSlots, 6 + lgK);
  
      /* Note: there is a possible
       * <a href="{@docRoot}/resources/dictionary.html#SnowPlow">Snow Plow Effect</a> here because
       * the caller is passing in a sorted pairs array. However, we are starting out with the correct
       * final table size, so the problem is not likely to occur.
      */
  
      for (int i = 0; i < numPairs; i++) {
        mustInsert(table, pairs[i]);
      }
      table.numPairs = numPairs;
      return table;
    }