docs: public static void checkCapacity(final int capacity)
      {
          if (!BitUtil.isPowerOfTwo(capacity))
          {
              final String msg = "capacity must be a positive power of 2 + TRAILER_LENGTH: capacity=" + capacity;
              throw new IllegalStateException(msg);
          }
      }