Fix headings

stomar · stomar · commit 5287fbe8b60e · 2016-08-07T11:36:08.000+02:00
diff --git a/en/documentation/faq/1/index.md b/en/documentation/faq/1/index.md
@@ -62,7 +62,7 @@ Ruby features:
 * High transportability (runs on various Unices, Windows, DOS, OSX, OS/2,
   Amiga, and so on)
 
-### Show me some Ruby code.
+### Show me some Ruby code!
 
 Let's define a class called Person, with a name and an age. We'll test our
 code by creating a few people and examining them.
@@ -121,7 +121,7 @@ Another way would be to change the comparison method for class Person:
     end
     people.sort      # -> [elmo (4), zoe (7), bert (8), ernie (8), cookie (11)]
 
-### Why the name 'Ruby'?
+### Why the name “Ruby”?
 
 Influenced by Perl, Matz wanted to use a jewel name for his new language, so
 he named Ruby after a colleague's birthstone.
@@ -192,7 +192,7 @@ You can search the mailing list archives using
 http://blade.nagaokaut.ac.jp/ruby/ruby-talk/index.shtml.
 (This is the url for the ruby-talk list: munge as required for the others).
 
-1.8 **Changed** How can I thread the mailing list in mutt?
+### How can I thread the mailing list in mutt?
 
 The Ruby mailing list software adds a prefix to the subject lines, for example
 [ruby-talk:1234]. This can confuse the threading in some mail user agents.
@@ -202,7 +202,7 @@ In mutt, you can get threading to work using the following variable setting.
     # reply regexp, to support MLs like ruby-talk.
     set reply_regexp="^(\[[a-z0-9:-]+\][[:space:]]*)?(re([\[0-9\]+])*|aw):[[:space:]]*"
 
-### Which is correct, Ruby or ruby?
+### Which is correct, “Ruby” or “ruby”?
 
 Officially, the language is called ``Ruby''. On most systems, it is invoked
 using the command ``ruby''. It's OK to use ruby instead of Ruby.
@@ -232,7 +232,7 @@ that covers the art and implementation of regular expressions in various
 programming languages. Most of it is highly relevant to Ruby regular
 expressions.
 
-### Which editors provide support for Ruby.
+### Which editors provide support for Ruby?
 
 * Emacs or XEmacs: ruby-mode.el is supplied in the Ruby distribution.
   With some versions of XEmacs, you may need to add (load "font-lock") to your
diff --git a/en/documentation/faq/3/index.md b/en/documentation/faq/3/index.md
@@ -99,7 +99,7 @@ configure options using:
 If you are working from the CVS archive, you may need to run autoconf before
 running configure.
 
-### **Changed** How do I tell Ruby where my libraries are?
+### How do I tell Ruby where my libraries are?
 
 On some systems, the build process may fail to find libraries used by
 extension modules (for example the dbm libraries).
@@ -152,7 +152,7 @@ Reuben Thomas writes:
 > I do provide a binary distribution of 1.4.3 for the Acorn at
 > http://www.cl.cam.ac.uk/users/rrt1001/ruby.zip.
 
-### What's all this 'cygwin', 'mingw', and 'djgpp' stuff?
+### What's all this “cygwin”, “mingw”, and “djgpp” stuff?
 
 Ruby is written to take advantage of the rich feature set of a Unix
 environment. Unfortunately, Windows is missing some of the functions, and
diff --git a/en/documentation/faq/4/index.md b/en/documentation/faq/4/index.md
@@ -218,7 +218,7 @@ and to make the object do something. You can do this with objects passed to
 methods. You need to be careful when doing this, as these kinds of side
 effects can make programs hard to follow.
 
-### What does ``*'' prepended to an argument mean?
+### What does `*` prepended to an argument mean?
 
 When used as part of a formal parameter list, the asterisk allows arbitrary
 numbers of arguments to be passed to a method by collecting them into an
@@ -260,7 +260,7 @@ For example:
     x     = [7, 8, 9]
     x                # -> [7, 8, 9]
 
-### What does ``&'' prepended to an argument mean?
+### What does `&` prepended to an argument mean?
 
 If the last formal argument of a method is preceeded with an ampersand,
 a block following the method call will be converted into a Proc object
diff --git a/en/documentation/faq/6/index.md b/en/documentation/faq/6/index.md
@@ -35,7 +35,7 @@ header: |
 
 ## Syntax
 
-### What does :var mean?
+### What does `:var` mean?
 
 A colon followed by a name generates an integer(Fixnum) called a symbol
 which corresponds one to one with the identifier. "var".intern gives the
@@ -80,7 +80,7 @@ may then call.
     m = d.method(:meth)  # -> #<Method: Demo(Demo)#meth>
     m.call               # -> "Hello, world"
 
-### Is loop a control structure?
+### Is `loop` a control structure?
 
 Although loop looks like a control structure, it is actually a method defined
 in Kernel. The block which follows introduces a new scope for local variables.
@@ -115,7 +115,7 @@ all the time. In this case, `a +b` is parsed as `a(+b)`. Remove the space
 to the left of `+` or add a space to the right of `+,` and it will be parsed
 as an addition.
 
-### `s = "x"; puts s *10` gives an error.
+### `s = "x"; puts s *10` gives an error!
 
 Again, Ruby sees the asymmetrical space and parses it as `puts(s(*10))`
 (which isn't too smart, really). Use `s*10` or `s * 10` to get the desired
@@ -127,7 +127,7 @@ The {} is parsed as a block, not a Hash constructor. You can force the {}
 to be treated as an expression by making the fact that it's a parameter
 explicit: `p({})`.
 
-### I can't get def pos=(val) to work.
+### I can't get `def pos=(val)` to work!
 
 I have the following code, but I cannot use the method pos = 1.
 
@@ -147,7 +147,7 @@ transformed and other combinations remain unchanged.
 However, in a doubled quoted string, "\1" is the byte \001, while "\\1"
 is the two character string containing a backslash and the character "1".
 
-### What's the difference between `or` and `||`?
+### What is the difference between `or` and `||`?
 
 Q: `p(nil || "Hello")` prints `"Hello"`, while `p(nil or "Hello")` gives a
 parse error.
