code: public boolean recordDeprecationReason(String reason) {
      if (currentInfo.setDeprecationReason(reason)) {
        populated = true;
        return true;
      } else {
        return false;
      }
    }
docs: Records the deprecation reason.