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"]