Some bugfixes and PHPDoc improvements

[mkkeck]

PHPDoc improvements

Undefined variable '$value' (see line #1470):

 public function having_id_is($id) {
  return (is_array($this->_get_id_column_name())) ?
    $this->having($this->_get_compound_id_column_values($value)) :
    $this->having($this->_get_id_column_name(), $id);
  }

Correct

public function having_id_is($id) {
  return (is_array($this->_get_id_column_name())) ?
    $this->having($this->_get_compound_id_column_values($id)) :
    $this->having($this->_get_id_column_name(), $id);
  }

In most cases using the same variable as a key or value both by the onner and outer 'foreach' loop either is an error or may result in an error in future (see line #1254):

  public function where_any_is($values, $operator='=') {
    $data = array();
    $query = array("((");
    $first = true;
    foreach ($values as $item) {
      if ($first) {
        $first = false;
      } else {
        $query[] = ") OR (";
      }
      $firstsub = true;
      foreach($item as $key => $item) {
        $op = is_string($operator) ? $operator : (isset($operator[$key]) ? $operator[$key] : '=');
        if ($firstsub) {
          $firstsub = false;
        } else {
          $query[] = "AND";
        }
        $query[] = $this->_quote_identifier($key);
        $data[] = $item;
        $query[] = $op . " ?";
      }
    }
    $query[] = "))";
    return $this->where_raw(join($query, ' '), $data);
  }

Correct

  public function where_any_is($values, $operator='=') {
    $data = array();
    $query = array("((");
    $first = true;
    foreach ($values as $value) {
      if ($first) {
        $first = false;
      } else {
        $query[] = ") OR (";
      }
      $firstsub = true;
      foreach($value as $key => $item) {
        $op = is_string($operator) ? $operator : (isset($operator[$key]) ? $operator[$key] : '=');
        if ($firstsub) {
          $firstsub = false;
        } else {
          $query[] = "AND";
        }
        $query[] = $this->_quote_identifier($key);
        $data[] = $item;
        $query[] = $op . " ?";
      }
    }
    $query[] = "))";
    return $this->where_raw(join($query, ' '), $data);
  }

[treffynnon]

Thank you for the pull request. Unfortunately this will not be merged.