From 0b0e21f4fe6848c5c1f95d01fa870618092a825b Mon Sep 17 00:00:00 2001
From: Bastian Kleineidam <bastian.kleineidam@web.de>
Date: Thu, 24 Apr 2014 19:42:50 +0200
Subject: [PATCH] Updated installation docs [ci skip]

---
 doc/install.txt | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/doc/install.txt b/doc/install.txt
index 4a2ff451..75225c55 100644
--- a/doc/install.txt
+++ b/doc/install.txt
@@ -3,6 +3,18 @@ Installation
 If you are upgrading from older versions of LinkChecker you should
 also read the upgrading documentation stored in upgrading.txt.
 
+Setup with pip
+------------------
+If pip_ is available, this command should install LinkChecker on
+the local system:
+
+.. _pip: https://pypi.python.org/pypi/pip
+
+``sudo pip install LinkChecker``
+
+Note that this needs the Python development and a C compiler installed.
+For example on Debian Linux systems use ``sudo apt-get install python-dev``.
+
 
 Setup for Windows
 -----------------
@@ -20,11 +32,6 @@ Setup for GNU/Linux
 On all major Linux distributions (Debian, Mandriva, Redhat, Suse, Ubuntu),
 the ``linkchecker`` package is available for install.
 
-If ``pip`` is available, this command should install LinkChecker on
-the local system:
-
-``sudo pip install LinkChecker``
-
 
 Manual setup for Unix systems
 -----------------------------
@@ -134,7 +141,6 @@ Manual setup for OSX systems
    brew install gettext
    # link gettext or put the msgfmt binary in your PATH
    brew link --force gettext
-   pip install -r requirements.txt --use-mirrors
 
 4. Install py2app 
    (from http://svn.pythonmac.org/py2app/py2app/trunk/doc/index.html#installation)
@@ -148,7 +154,7 @@ Manual setup for OSX systems
 
 6. cd linkchecker
 
-7. Run "make app"
+7. Run ``pip install -r requirements.txt --use-mirrors`` and after that ``make app``
 
 8. Install the resulting .dmg