remove restriction on column size for a module's capability array. (255 is unreasonably small)
ensure module is in array before checking resultset
add new Search method/api to search module
add docs for new search method/api
implement new search method/api in the Users module
remove untrue comment
CS
Merge pull request #1635 from craigh/searchMakeover

This PR was merged into zikula:1.4 branch.

Discussion
----------

Search makeover

Attached is a *fully backward-compatible* makeover of the search API for 1.4.0+. Also included is an implementation in the Users module (which is, frankly, more complex that most other modules in this regard). 

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | yes
| BC breaks?    | no
| Deprecations? | no
| Tests pass?   | yes
| Fixed tickets | -
| Refs tickets  | #634
| License       | MIT
| Doc PR        | included

I also considered an events-based method which I discarded because of the need for a base helper class and other considerations. This is intended to lay the groundwork for future (Core2) improvements (possibly as referenced in #634). It is **fully functional** and requires nothing further for 1.4.0 release (IMO). Enhancements of course are always possible.

Commits
-------

230c9aab046cb13f87b425dba98f4751b375dd01 remove restriction on column size for a module's capability array. (255 is unreasonably small) craigh
1b7f70c833310c50559954a5099ff9cfc54eb79a ensure module is in array before checking resultset craigh
fb3974049dc6eba826c05856ae4aa8859b2607dc add new Search method/api to search module craigh
7eae23255ba68fd52871ca09f7fb0d48a8773452 add docs for new search method/api craigh
bd4f25087ed7d988d46e0c881767281ab1134323 implement new search method/api in the Users module craigh
dc33da0f09f8b9f2f43aa4a8936a5c7266a88df1 remove untrue comment craigh
78a7d01ed53557cd42efb75f92aa8aac784fc286 CS craigh