README.markdown in iso-639-0.1.0 vs README.markdown in iso-639-0.2.0

- old
+ new

@@ -8,12 +8,10 @@ The [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) specification uses a two-letter code to identify a language and is often the recommended way to identify languages in computer applications. The ISO 639-1 specification covers most developed and widely used languages. The [ISO 639-2](http://www.loc.gov/standards/iso639-2/) ([Wikipedia](http://en.wikipedia.org/wiki/ISO_639-2)) specification uses a three-letter code, is used primarily in bibliography and terminology and covers many more languages than the ISO 639-1 specification. -The other ISO 639 standards are considered beyond the scope of this library. - ## Usage require 'iso-639' To find a language entry: @@ -24,9 +22,16 @@ ISO_639.find("en") # by English name ISO_639.find_by_english_name("Russian") # by French name ISO_639.find_by_french_name("français") + +The `ISO_639.search` class method searches across all fields and will +match names in cases where a record has multiple names. This method +always returns an array of 0 or more results. For example: + + ISO_639.search("spanish") + # => [["spa", "", "es", "Spanish; Castilian", "espagnol; castillan"]] Entries are arrays with convenience methods for accessing fields: @entry = ISO_639.find("slo") # => ["slo", "slk", "sk", "Slovak", "slovaque"]