code: public Subscription limitValidity( String subscription, Interval.Period newValidity ) {
      return limitValidity( new Subscription( subscription ), newValidity );
    }
docs: Change the period of validity for a subscription.
  
  @param subscription the subscription.
  @param newValidity the new validity.
  @return the updated subscription.