Restore links in FAQ

stomar · stomar · commit 27daea3f492b · 2016-08-08T19:26:45.000+02:00
* restore internal links
* make external links clickable
diff --git a/en/documentation/faq/1/index.md b/en/documentation/faq/1/index.md
@@ -175,19 +175,23 @@ June 4, 1999. (The birthday of Ruby is corrected in [ruby-list:15977]).
 
 ### Where is the Ruby Home Page?
 
-The official Ruby Home Page is http://www.ruby-lang.org (in English) and
-http://www.ruby-lang.org/ja/ (in Japanese).
+The official Ruby Home Page is [http://www.ruby-lang.org](http://www.ruby-lang.org)
+(in English) and [http://www.ruby-lang.org/ja/](http://www.ruby-lang.org/ja/)
+(in Japanese).
 
-You can also find Ruby information at http://www.rubycentral.com.
-In particular, there is a complete online reference to Ruby's built-in classes
-and methods.
+You can also find Ruby information at
+[http://www.rubycentral.com](http://www.rubycentral.com).
+In particular, there is a complete
+[online reference](http://www.rubycentral.com/book/builtins.html)
+to Ruby's built-in classes and methods.
 
 ### Is there a Ruby newsgroup?
 
 comp.lang.ruby was established in May, 2000 (thanks to the efforts of
-Conrad Schneiker).
+[Conrad Schneiker](mailto:schneiker@jump.net)).
 
 ### Is there a Ruby mailing list?
+{: #mailing-lists}
 
 There are five mailing lists now talking about Ruby. The first is in English,
 the last four in Japanese:
@@ -200,10 +204,10 @@ ruby-ext:  List for people writing extensions for or with Ruby.
 ruby-math: Ruby in mathematics.
 ~~~
 
-See joining the mailing list.
+See [joining the mailing list](http://www.ruby-lang.org/en/ml.html).
 
 You can search the mailing list archives using
-http://blade.nagaokaut.ac.jp/ruby/ruby-talk/index.shtml.
+[http://blade.nagaokaut.ac.jp/ruby/ruby-talk/index.shtml](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).
 
 ### How can I thread the mailing list in mutt?
@@ -250,20 +254,25 @@ expressions.
 
 ### 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 `.emacs` file to allow `ruby-mode.el` to detect the syntax
-  highlighting package you're using.
-* Vim: Vim 5.7 and later have Ruby syntax files as standard in the runtime
-  package. For prior versions, a syntax file for Ruby is available at
-  http://www.xs4all.nl/~hipster/lib/ruby/ruby.vim.
-* Jedit: A portable editor written in Java, comes with support for Ruby.
-* Jed: An s-lang file supporting Ruby is available at
-  http://www.kondara.org/~g/slang/ruby.sl.
-* Nedit (http://www.nedit.org): Eric Santonacci has written Ruby support for
-  Nedit, available from ftp://ftp.talc.fr/pub/ruby/ruby.nedit-0.1.tar.gz.
+* [Emacs](http://www.gnu.org/software/emacs/emacs.html)
+  or [XEmacs](http://www.xemacs.org/): `ruby-mode.el` is supplied in the Ruby
+  distribution. With some versions of XEmacs, you may need to add
+  `(load "font-lock")` to your `.emacs` file to allow `ruby-mode.el` to detect
+  the syntax highlighting package you're using.
+* [Vim](http://www.vim.org/): Vim 5.7 and later have Ruby syntax files as
+  standard in the runtime package. For prior versions, a syntax file for Ruby
+  is available at
+  [http://www.xs4all.nl/~hipster/lib/ruby/ruby.vim](http://www.xs4all.nl/~hipster/lib/ruby/ruby.vim).
+* [Jedit](http://jedit.sourceforge.net/): A portable editor written in Java,
+  comes with support for Ruby.
+* [Jed](http://space.mit.edu/~davis/jed.html): An s-lang file supporting Ruby
+  is available at
+  [http://www.kondara.org/~g/slang/ruby.sl](http://www.kondara.org/~g/slang/ruby.sl).
+* [Nedit](http://www.nedit.org): Eric Santonacci has written Ruby support for
+  Nedit, available from
+  [ftp://ftp.talc.fr/pub/ruby/ruby.nedit-0.1.tar.gz](ftp://ftp.talc.fr/pub/ruby/ruby.nedit-0.1.tar.gz).
 * Barry Shultz has written a Ruby definition file for TextPad, available at
-  http://www.textpad.com/add-ons/ntsyn.html.
+  [http://www.textpad.com/add-ons/ntsyn.html](http://www.textpad.com/add-ons/ntsyn.html).
 
 ### How can I annotate Ruby code with its results?
 
@@ -278,8 +287,8 @@ str[0,1] + str[2,1] + str[-2,2]  # => "Blob"
 ~~~
 
 Gotoken's `xmp` package, available from
-http://www.ruby-lang.org/en/raa-list.rhtml?name=xmp is a utility that
-annotates Ruby source code this way.
+[http://www.ruby-lang.org/en/raa-list.rhtml?name=xmp](http://www.ruby-lang.org/en/raa-list.rhtml?name=xmp)
+is a utility that annotates Ruby source code this way.
 
 Emacs and vim users can integrate this with their editing environments, which
 is useful if you want to send people e-mail with annotated Ruby code. Having
@@ -310,15 +319,17 @@ The syntax of Ruby has been fairly stable since Ruby 1.0, but new features are
 added every now and then. So, the books and the online documentation can get
 behind.
 
-If you have a problem, feel free to ask in the mailing list (see ruby-talk
-mailing list). Generally you'll get timely answers from matz himself, the
+If you have a problem, feel free to ask in the mailing list
+(see [ruby-talk mailing list](#mailing-lists)).
+Generally you'll get timely answers from matz himself, the
 author of the language, from other gurus, and from those who've solved
 problems similar to your own.
 
 Please include the output of `ruby -v` along with any problematic
 source code.
 
-If you have a problem using `irb`, be aware that it has some limitations.
+If you have a problem using [`irb`](../10/#irb),
+be aware that it has some limitations.
 Try the script using `irb --single-irb`, or directly using the
 `ruby` command.
 
diff --git a/en/documentation/faq/10/index.md b/en/documentation/faq/10/index.md
@@ -38,12 +38,13 @@ header: |
 ## Extension library
 
 ### How can I use Ruby interactively?
+{: #irb}
 
 You can try using `irb`. The following is paraphrased from Goto Kentaro
 (Gotoken), and originally appeared in ruby-talk:444.
 
 ~~~
-Get the latest tarball of irb from the contrib directory in the Ruby archive.
+Get the latest tarball of irb from the contrib directory (ftp://ftp.netlab.co.jp/pub/lang/ruby/contrib/) in the Ruby archive.
 Extract the irb directory tree.
 Add the location of the irb/ directory to the $RUBYLIB environment variable
 Make a symbolic link from $RUBYLIB/irb/irb.rb to a file called irb somewhere in your path.
diff --git a/en/documentation/faq/11/index.md b/en/documentation/faq/11/index.md
@@ -53,7 +53,8 @@ open("example").read.count("\n")  # => 3
 ### What do `begin` and `end` of `MatchingData` 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 tab expansion.
+matched data (`$0`) 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/2/index.md b/en/documentation/faq/2/index.md
@@ -98,5 +98,5 @@ mined for P3K. I'm not sure how many Python programmers will be attracted to
 it though - it hasn't won me over (yet). But it is worthy of serious study and
 could be a real threat to Perl.
 
-Posted by John Dell'Aquila in comp.lang.python, 11/17/2000.
-Reproduced with permission.
+Posted by [John Dell'Aquila](mailto:jbd@alum.mit.edu) in comp.lang.python,
+11/17/2000. Reproduced with permission.
diff --git a/en/documentation/faq/3/index.md b/en/documentation/faq/3/index.md
@@ -52,19 +52,20 @@ See http://developer.apple.com/technotes/tn2002/tn2053.html.
 H Morita notes:
 
 > There's a MacOS (not X) port of Ruby, by Hisakuni FUJIMOTO at
-> http://www.imasy.or.jp/~hisa/ruby/macruby.html. However it's based on
-> Ruby 1.1b7, and hasn't been updated since December 1999. It's highly
-> experimental. It may crash and sometimes freeze the OS, even with the
-> sample scripts included in the Ruby distribution. (Sounds like fun ;-).
+> [http://www.imasy.or.jp/~hisa/ruby/macruby.html](http://www.imasy.or.jp/~hisa/ruby/macruby.html).
+> However it's based on Ruby 1.1b7, and hasn't been updated since
+> December 1999. It's highly experimental. It may crash and sometimes freeze
+> the OS, even with the sample scripts included in the Ruby distribution.
+> (Sounds like fun ;-).
 
 Rob tells us that there's Ruby 1.6.4 for OS/2 at
-http://www.aminet.org/systems/os2/dev/misc/.
+[http://www.aminet.org/systems/os2/dev/misc/](http://www.aminet.org/systems/os2/dev/misc/).
 However, that link seems broken: can anyone give us something that works?
 
 ### Where can I get Ruby sources?
 
 The latest version of Ruby can be downloaded from:
-http://www.ruby-lang.org/en/download.html
+[http://www.ruby-lang.org/en/download.html](http://www.ruby-lang.org/en/download.html)
 Mirror sites are also listed on this page.
 
 Also on this page is a link to a nightly snapshot of the development tree.
@@ -81,7 +82,8 @@ CVS password: guest
 ~~~
 
 If you do not have CVS you can get a nightly snapshot of the development
-source from ftp://ftp.netlab.co.jp/pub/lang/ruby/snapshot.tar.gz.
+source from
+[ftp://ftp.netlab.co.jp/pub/lang/ruby/snapshot.tar.gz](ftp://ftp.netlab.co.jp/pub/lang/ruby/snapshot.tar.gz).
 
 ### How do I compile Ruby?
 
@@ -151,22 +153,25 @@ He recommends installing the GNU equivalent.
 ### Are precompiled binaries available?
 
 A single download that contains everything you need to run Ruby under various
-Windows operating systems. is available from RubyCentral's One-click Windows
-installer. This installation uses cygwin, and includes Tk support.
+Windows operating systems. is available from
+[RubyCentral's One-click Windows installer](http://www.rubycentral.com/downloads/ruby-install.html).
+This installation uses cygwin, and includes Tk support.
 
 If you want other installation options, precompiled binaries for Windows are
-also available from http://www.os.rim.or.jp/~eban/. If you download the
-ruby-1.x.y-yyyymmdd-i386-cygwin.tar.gz package (which is a good choice),
-you'll also need to download the cygwin DLL, available from the same page.
+also available from
+[http://www.os.rim.or.jp/~eban/](http://www.os.rim.or.jp/~eban/).
+If you download the `ruby-1.x.y-yyyymmdd-i386-cygwin.tar.gz` package
+(which is a good choice), you'll also need to download the cygwin DLL,
+available from the same page.
 
-Reuben Thomas writes:
+[Reuben Thomas](mailto:Reuben.Thomas@cl.cam.ac.uk) writes:
 
 > You could mention that there's a port to Acorn RISC OS, currently of v1.4.3.
 > I made the port, and have no plans to maintain it, but I did send the
 > patches to matz, so newer versions may well compile too.
 
 > I do provide a binary distribution of 1.4.3 for the Acorn at
-> http://www.cl.cam.ac.uk/users/rrt1001/ruby.zip.
+> [http://www.cl.cam.ac.uk/users/rrt1001/ruby.zip](http://www.cl.cam.ac.uk/users/rrt1001/ruby.zip).
 
 ### What's all this “cygwin”, “mingw”, and “djgpp” stuff?
 
@@ -179,14 +184,15 @@ You may come across different versions of the Ruby executable that use
 different wrapper mapping layers.
 
 The rbdj version is a stand-alone version of the Windows binary of Ruby.
-It uses the DJ Delorie tools (http://www.delorie.com).
+It uses the DJ Delorie tools
+([http://www.delorie.com](http://www.delorie.com)).
 
 The rbcw version is a Windows binary of Ruby that requires the cygwin library,
-available at http://www.cygwin.com or from the Ruby download pages. Cygwin is
-a both an emulation layer and a set of utilities initially produced by Cygnus
-Solutions (now part of Redhat). The Cygwin version of Ruby probably has the
-fullest set of features under Windows, so most programmers will want to use
-it.
+available at [http://www.cygwin.com](http://www.cygwin.com) or from the
+Ruby download pages. Cygwin is a both an emulation layer and a set of
+utilities initially produced by Cygnus Solutions (now part of Redhat).
+The Cygwin version of Ruby probably has the fullest set of features under
+Windows, so most programmers will want to use it.
 
 To use the rbcw version, you will need to install the cygwin .dll separately.
 Once you have installed cygwin on your computer, copy `cygwin1.dll` (which
@@ -198,8 +204,8 @@ Thanks to Anders Schneiderman for the basis of this description
 ### Why doesn't Tk graphics work under Windows?
 
 Is Tk installed correctly on your Windows box? Go to
-http://dev.scriptics.com/software/tcltk/ to find a precompiled binary
-Tcl/Tk distribution for your box.
+[http://dev.scriptics.com/software/tcltk/](http://dev.scriptics.com/software/tcltk/)
+to find a precompiled binary Tcl/Tk distribution for your box.
 
 Are the environment variables `TCL_LIBRARY` and `TK_LIBRARY` pointing to the
 directories containing tcl and tk?
diff --git a/en/documentation/faq/4/index.md b/en/documentation/faq/4/index.md
@@ -38,6 +38,7 @@ header: |
 ## Variables, constants, and arguments
 
 ### Does assignment generate a new copy of an object?
+{: #assignment}
 
 All variables and constants reference (point at) some object. (The exception
 is uninitialized local variables, which reference nothing. These raise a
@@ -51,7 +52,8 @@ There's a slightly deeper explanation in certain special cases. Instances of
 variables or constants--there is no reference involved. A variable holding the
 number `42` or the constant `true`, actually holds the value, and not a
 reference to it. Assignment therefore physically produces a copy of objects
-of these types. We discuss this more in Immediate and Reference Objects.
+of these types. We discuss this more in
+[Immediate and Reference Objects](../9/#immediate).
 
 ### What is the scope of a local variable?
 
@@ -202,7 +204,7 @@ the `::` operator--`ModuleName::CONST1` or `ClassName::CONST2`.
 ### How are arguments passed?
 
 The actual argument is assigned to the formal argument when the method is
-invoked. (See assignment for more on the semantics of assignment.)
+invoked. (See [assignment](#assignment) for more on the semantics of assignment.)
 
 ~~~
 def addOne(n)
diff --git a/en/documentation/faq/7/index.md b/en/documentation/faq/7/index.md
@@ -317,6 +317,7 @@ to give it an alternative name. Finally, you can call the original method as
 a singleton method of `Kernel`.
 
 ### What is a destructive method?
+{: #destructive-method}
 
 A destructive method is one which alters the state of an object. `String`,
 `Array`, and `Hash`, and others have such methods. Often there are two
diff --git a/en/documentation/faq/8/index.md b/en/documentation/faq/8/index.md
@@ -107,6 +107,7 @@ an instance of `Class` class. (phew!)
 There is no way to access class instance variables from instance methods.
 
 ### What is a singleton method?
+{: #singleton-method}
 
 A singleton method is an instance method associated with one specific object.
 
@@ -136,8 +137,10 @@ Singleton methods are useful when you want to add a method to an object and
 creating a new subclass is not appropriate.
 
 ### Does Ruby have class methods?
+{: #class-method}
 
-A singleton method of a class object is called a class method.
+A [singleton method](#singleton-method) of a class object is called a
+class method.
 (Actually, the class method is defined in the metaclass, but that is pretty
 much transparent). Another way of looking at it is to say that a class method
 is a method whose receiver is a class.
@@ -203,8 +206,8 @@ We've customized `foo` without changing the characteristics of `Foo`.
 ### What is a module function?
 
 A module function is a private, singleton method defined in a module.
-In effect, it is similar to a class method, in that it can be called using
-the `Module.method` notation:
+In effect, it is similar to a [class method](#class-method),
+in that it can be called using the `Module.method` notation:
 
 ~~~
 Math.sqrt(2)     # => 1.414213562
diff --git a/en/documentation/faq/9/index.md b/en/documentation/faq/9/index.md
@@ -60,6 +60,7 @@ different sequences of random numbers. To get the old, predictable, behavior
 (perhaps for testing), call `srand` with a constant seed.
 
 ### What is the difference between an immediate value and a reference?
+{: #immediate}
 
 `Fixnum`, `true`, `nil`, and `false` are implemented as immediate values.
 With immediate values, variables hold the objects themselves, rather than
@@ -319,6 +320,7 @@ character code as an integer constant by prefixing the character with a
 question mark, so `?a` is also 97 (`Fixnum`).
 
 ### How can I expand tabs to spaces?
+{: #tab-expansion}
 
 If `a` holds the string to be expanded, you could use one of:
 
@@ -355,9 +357,9 @@ In `sub`, a copy of the receiver is generated, substituted and returned.
 In `sub!`, the receiver is altered and returned if any match was found.
 Otherwise, `nil` is returned.
 
-Methods like `sub!` are called destructive methods which alter the attribute
-of the receiver. If there are two similar methods and one is destructive,
-the destructive one has a suffix `!`.
+Methods like `sub!` are called [destructive methods](../7/#destructive-method)
+which alter the attribute of the receiver. If there are two similar methods
+and one is destructive, the destructive one has a suffix `!`.
 
 ~~~
 def foo(str)
