From 1560235424b1fb1065a44116b8ef7a7abd6b2cd8 Mon Sep 17 00:00:00 2001
From: Nico Alt <nicoalt@posteo.org>
Date: Tue, 4 Aug 2015 12:54:06 +0200
Subject: [PATCH] Port README to markdown

Also add instructions for Arch-Linux.
---
 README => README.md | 73 +++++++++++++++++++++++++++++++--------------
 1 file changed, 51 insertions(+), 22 deletions(-)
 rename README => README.md (57%)

diff --git a/README b/README.md
similarity index 57%
rename from README
rename to README.md
index c22523c5..4e7933c8 100644
--- a/README
+++ b/README.md
@@ -1,16 +1,25 @@
-F-Droid is an installable catalogue of FOSS (Free and Open Source Software)
-applications for the Android platform. The client makes it easy to browse,
-install, and keep track of updates on your device.
+F-Droid Server
+==============
+
+Server for [F-Droid](https://f-droid.org), the Free Software repository system
+for Android.
 
 The F-Droid server tools provide various scripts and tools that are used to
-maintain the main F-Droid application repository. You can use these same tools
-to create your own additional or alternative repository for publishing, or to
-assist in creating, testing and submitting metadata to the main repository.
+maintain the main [F-Droid application repository](https://f-droid.org/repository/browse).
+You can use these same tools to create your own additional or alternative
+repository for publishing, or to assist in creating, testing and submitting
+metadata to the main repository.
 
 For documentation, please see the docs directory.
 
-Alternatively, visit [https://f-droid.org/manual/](https://f-droid.org/manual/)
+Alternatively, visit [https://f-droid.org/manual/](https://f-droid.org/manual/).
 
+What is F-Droid?
+----------------
+
+F-Droid is an installable catalogue of FOSS (Free and Open Source Software)
+applications for the Android platform. The client makes it easy to browse,
+install, and keep track of updates on your device.
 
 Installing
 ----------
@@ -18,29 +27,46 @@ Installing
 The easiest way to install the `fdroidserver` tools is on Ubuntu, Mint or other
 Ubuntu based distributions, you can install using:
 
-    sudo apt-get install fdroidserver
+```
+sudo apt-get install fdroidserver
+```
 
 For older Ubuntu releases or to get the latest version, you can get
 `fdroidserver` from the Guardian Project PPA (the signing key
 fingerprint is `6B80 A842 07B3 0AC9 DEE2 35FE F50E ADDD 2234 F563`)
 
-    sudo add-apt-repository ppa:guardianproject/ppa
-    sudo apt-get update
-    sudo apt-get install fdroidserver
+```
+sudo add-apt-repository ppa:guardianproject/ppa
+sudo apt-get update
+sudo apt-get install fdroidserver
+```
 
 On OSX, `fdroidserver` is available from third party package managers,
 like Homebrew, MacPorts, and Fink:
 
-    sudo brew install fdroidserver
+```
+sudo brew install fdroidserver
+```
+
+For Arch-Linux is a package in the AUR available. If you have installed
+`yaourt` or something similiar, you can do:
+
+```
+yaourt -S fdroidserver
+```
 
 For any platform where Python's `easy_install` is an option (e.g. OSX
 or Cygwin, you can use it:
 
-    sudo easy_install fdroidserver
+```
+sudo easy_install fdroidserver
+```
 
 Python's `pip` also works:
 
-    sudo pip install fdroidserver
+```
+sudo pip install fdroidserver
+```
 
 The combination of `virtualenv` and `pip` is great for testing out the
 latest versions of `fdroidserver`.  Using `pip`, `fdroidserver` can
@@ -51,13 +77,16 @@ via other mechanisms like Brew/dnf/pacman/emerge/Fink/MacPorts.
 
 For Debian based distributions:
 
-    apt-get install python-dev python-pip python-virtualenv
-
+```
+apt-get install python-dev python-pip python-virtualenv
+```
 Then here's how to install:
 
-    git clone https://gitlab.com/fdroid/fdroidserver.git
-    cd fdroidserver
-    virtualenv env/
-    source env/bin/activate
-    pip install -e .
-    python2 setup.py install
+```
+git clone https://gitlab.com/fdroid/fdroidserver.git
+cd fdroidserver
+virtualenv env/
+source env/bin/activate
+pip install -e .
+python2 setup.py install
+```