From 6006e2c8248f906665ec9931db9bc555db4aa927 Mon Sep 17 00:00:00 2001
From: Patrick Trottier <patrick.arrow206@outlook.com>
Date: Tue, 16 Aug 2016 19:16:55 -0500
Subject: [PATCH] servo: Merge #12880 - Added OS Links in Markdown (from
 Coder206:osReadMe); r=nox,Ms2ger

<!-- Please describe your changes on the following line: -->

It is really an improvement to make room for a commit that links contributors to https://janitor.technology

---
<!-- Thank you for contributing to Servo! Please replace each `[ ]` by `[X]` when the step is complete, and replace `__` with appropriate data: -->
- [x] `./mach build -d` does not report any errors
- [x] `./mach test-tidy` does not report any errors

<!-- Pull requests that do not address these steps are welcome, but they will require additional verification as part of the review process. -->

Source-Repo: https://github.com/servo/servo
Source-Revision: 17df3c276b5ac56645e5acf3b09ae684d732631f
---
 servo/README.md | 35 ++++++++++++++++++++---------------
 1 file changed, 20 insertions(+), 15 deletions(-)

diff --git a/servo/README.md b/servo/README.md
index cba4907649e9..9830932e4c7f 100644
--- a/servo/README.md
+++ b/servo/README.md
@@ -12,22 +12,30 @@ for help getting started.
 
 Visit the [Servo Project page](https://servo.org/) for news and guides.
 
-## Prerequisites
+## Setting up your environment
 
-On OS X (homebrew):
+Please select your operating system:
+* [OS X](#os-x)
+* [Debian-based Linuxes](#on-debian-based-linuxes)
+* [Fedora](#on-fedora)
+* [Arch Linux](#on-arch-linux)
+* [Gentoo Linux](#on-gentoo-linux)
+* [Microsoft Windows](#on-windows)
+* [Android](#cross-compilation-for-android)
+
+#### OS X
+#### On OS X (homebrew)
 
 ``` sh
 brew install automake pkg-config python cmake ffmpeg
 pip install virtualenv
 ```
-
-On OS X (MacPorts):
+#### On OS X (MacPorts)
 
 ``` sh
 sudo port install python27 py27-virtualenv cmake ffmpeg
 ```
-
-On OS X 10.11 (El Capitan), you also have to install openssl:
+#### On OS X 10.11 (El Capitan), you also have to install openssl
 
 ``` sh
 brew install openssl
@@ -57,7 +65,7 @@ brew install ffmpeg --build-from-source
 
 If you've already partially compiled servo but forgot to do this step, run ./mach clean, link openssl, and recompile.
 
-On Debian-based Linuxes:
+#### On Debian-based Linuxes
 
 ``` sh
 sudo apt-get install git curl freeglut3-dev autoconf \
@@ -71,7 +79,7 @@ If you are on **Ubuntu 14.04** and encountered errors on installing these depend
 
 If `virtualenv` does not exist, try `python-virtualenv`.
 
-On Fedora:
+#### On Fedora
 
 ``` sh
 sudo dnf install curl freeglut-devel libtool gcc-c++ libXi-devel \
@@ -80,14 +88,12 @@ sudo dnf install curl freeglut-devel libtool gcc-c++ libXi-devel \
     rpm-build openssl-devel cmake bzip2-devel libXcursor-devel libXmu-devel mesa-libOSMesa-devel \
     dbus-devel ffmpeg-devel
 ```
-
-On Arch Linux:
+#### On Arch Linux
 
 ``` sh
 sudo pacman -S --needed base-devel git python2 python2-virtualenv python2-pip mesa cmake bzip2 libxmu glu pkg-config
 ```
-
-On Gentoo Linux:
+#### On Gentoo Linux
 
 ```sh
 sudo emerge net-misc/curl media-libs/freeglut \
@@ -95,8 +101,7 @@ sudo emerge net-misc/curl media-libs/freeglut \
     dev-python/virtualenv dev-python/pip dev-libs/openssl \
     x11-libs/libXmu media-libs/glu x11-base/xorg-server
 ```
-
-On Windows:
+#### On Windows
 
 Download Python for Windows [here](https://www.python.org/downloads/release/python-2711/). This is
 required for the SpiderMonkey build on Windows.
@@ -131,7 +136,7 @@ mv python2.7.exe python2.7-mingw64.exe
 
 Now, open a MINGW64 (not MSYS!) shell window, and you should be able to build servo as usual!
 
-Cross-compilation for Android:
+#### Cross-compilation for Android
 
 Pre-installed Android tools are needed. See wiki for
 [details](https://github.com/servo/servo/wiki/Building-for-Android)