Fix some errors in FAQ

stomar · stomar · commit 4af1f7e92996 · 2016-08-18T21:34:33.000+02:00
diff --git a/en/documentation/faq/11/index.md b/en/documentation/faq/11/index.md
@@ -50,10 +50,10 @@ fastest result.
 open("example").read.count("\n")  # => 3
 ~~~
 
-### What do `begin` and `end` of `MatchingData` return?
+### What do `begin` and `end` of `MatchData` return?
 
-They act with `$ `, and return the start index and the end index of the
-matched data (`$0`) in the original string. See an example in
+They act with `$~`, and return the start index and the end index of the
+matched data in the original string. See an example in
 [tab expansion](../9/#tab-expansion).
 
 ### How can I sum the elements in an array?
diff --git a/en/documentation/faq/4/index.md b/en/documentation/faq/4/index.md
@@ -123,14 +123,16 @@ end
 threads.each {|t| t.join }
 ~~~
 
-Produces:
+Might produce (in case the scheduler switches threads as hinted
+by `Thread.pass`; this depends on OS and processor):
 
 ~~~
-onetwo: : 00
-
-onetwo: : 11
-
-onetwo: : 33
+one: 0
+two: 0
+one: 1
+two: 1
+one: 3
+two: 3
 ~~~
 
 `while`, `until`, and `for` are control structures, not blocks, so local
@@ -195,7 +197,7 @@ A constant defined in a class or module definition can be accessed directly
 within that class's or module's definition.
 
 You can directly access the constants in outer classes and modules from
-within nested classes and constants.
+within nested classes and modules.
 
 You can also directly access constants in superclasses and included modules.
 
diff --git a/en/documentation/faq/5/index.md b/en/documentation/faq/5/index.md
@@ -194,7 +194,7 @@ def combine(*args)
   for it in args
     queue = SizedQueue.new(1)
     th = Thread.start(it, queue) do |i,q|
-      self.send(it) do |x|
+      self.send(i) do |x|
         q.push x
       end
     end
@@ -223,6 +223,6 @@ def it2 ()
 end
 
 combine('it1','it2') do |x|
-  # x is (1, 4), then (2, 5), then (3, 6)
+  # x is [1, 4], then [2, 5], then [3, 6]
 end
 ~~~
diff --git a/en/documentation/faq/7/index.md b/en/documentation/faq/7/index.md
@@ -327,7 +327,7 @@ change to it, and returns the copy. The version with the `!` modifies the
 receiver in place.
 
 Beware, however, that there are a fair number of destructive methods that
-do not have an `!`, including assignment operators (`name=`), array assignment
+do not have an `!`, including assignment methods (`name=`), array assignment
 (`[]=`), and methods such as `Array.delete`.
 
 ### Why can destructive methods be dangerous?
diff --git a/en/documentation/faq/8/index.md b/en/documentation/faq/8/index.md
@@ -177,14 +177,14 @@ way of extending the functionality associated with just one object.
 Take the lowly `Foo`:
 
 ~~~
-class Foo        # => hello<<7>>nil
+class Foo
   def hello
-    print "hello"
+    "hello"
   end
 end
 
 foo = Foo.new
-foo.hello
+foo.hello        # => "hello"
 ~~~
 
 Now let's say we need to add class-level functionality to just this one
@@ -276,6 +276,9 @@ class MyClass
   def <=>(o)
     return @legs <=> o.legs
   end
+  def inspect
+    @name
+  end
 end
 c = MyClass.new('cat', 4)
 s = MyClass.new('snake', 0)
@@ -337,7 +340,7 @@ is applied. A function-style method call implies `self` as the receiver.
 
 ### Why can't I load variables from a separate file?
 
-Say `file1` contains:
+Say `file1.rb` contains:
 
 ~~~
 var1 = 99
diff --git a/en/documentation/faq/9/index.md b/en/documentation/faq/9/index.md
@@ -365,15 +365,15 @@ the destructive one has a suffix `!`.
 
 ~~~
 def foo(str)
-    str = str.sub(/foo/, "baz")
+    str.sub(/foo/, "baz")
 end
 
 obj = "foo"
 foo(obj)         # => "baz"
 obj              # => "foo"
 
 def foo(str)
-    str = str.sub!(/foo/, "baz")
+    str.sub!(/foo/, "baz")
 end
 
 foo(obj)         # => "baz"
