This is mostly a documentation issue, but I'm hoping for consistent
terminology to differentiate between dataset methods that stack/merge/
join options unto previous options, and those that replace previous
options.

For example, multiple calls to Dataset#filter do not replace previous
filters, but append to them. On the other hand, multiple calls to
Dataset#order replace all previous orders:

  ds.filter(:x => 1).filter(:y => 2)
  # SELECT * FROM ds WHERE (x = 1) and (y = 2)

  ds.order(:x).order(:y)
  # SELECT * FROM ds ORDER BY y

Other methods that behave like #filter include #with and #join.
Other methods that have like #order include #group, #select, and
#from.

Here are some suggestions to describe methods that support chaining:
* supports multiple calls
* stacks multiple calls
* merges multiple calls
* stackable
* chainable
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"sequel-talk" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to 
[email protected]
For more options, visit this group at 
http://groups.google.com/group/sequel-talk?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to