Converted README to markdown, updated the description, and updated links

2 files changed, 78 insertions, 76 deletions

diff --git a/README b/README
deleted file mode 100644
index c91bb37..0000000
--- a/README
+++ /dev/null
@@ -1,76 +0,0 @@
-About
-=====
-
-The idevicerestore tool allows to restore firmware files to iOS devices.
-
-It is a full reimplementation of all granular steps which are performed during
-restore of a firmware to a device.
-
-In general, upgrades and downgrades are possible, however subject to
-availability of SHSH blobs from Apple for signing the firmare files.
-
-To restore a device to some firmware, simply run the following:
-$ sudo idevicerestore -l
-
-This will download and restore a device to the latest firmware available.
-
-Requirements
-============
-
-Development Packages of:
-        libcurl
-	libimobiledevice
-	libirecovery
-	libusbmuxd
-	libplist
-	libzip
-	openssl
-
-Software:
-	usbmuxd
-	make
-	autoheader
-	automake
-	autoconf
-	libtool
-	pkg-config
-	gcc
-
-Installation
-============
-
-To compile run:
-	./autogen.sh
-	make
-	sudo make install
-
-Who/What/Where?
-===============
-
-Home:
-	http://www.libimobiledevice.org/
-
-Code:
-	git clone http://git.libimobiledevice.org/idevicerestore.git
-
-Code (Mirror):
-	git clone https://github.com/libimobiledevice/idevicerestore.git
-
-Tickets:
-	http://github.com/libimobiledevice/idevicerestore/issues
-
-Mailing List:
-	http://lists.libimobiledevice.org/mailman/listinfo/libimobiledevice-devel
-
-IRC:
-	irc://irc.freenode.net#libimobiledevice
-
-Credits
-=======
-
-Apple, iPhone, iPod, and iPod Touch are trademarks of Apple Inc.
-idevicerestore is an independent software tool and has not been
-authorized, sponsored, or otherwise approved by Apple Inc.
-
-README Updated on:
-	2015-10-06
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d31e50d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,78 @@
+# idevicerestore
+
+## About
+
+The idevicerestore tool allows to restore firmware files to iOS devices.
+
+It is a full reimplementation of all granular steps which are performed during
+restore of a firmware to a device.
+
+In general, upgrades and downgrades are possible, however subject to
+availability of SHSH blobs from Apple for signing the firmare files.
+
+To restore a device, simply run
+```bash
+idevicerestore -l
+```
+
+This will print a selection of firmware versions that are currently being signed
+for the attached device. It will then download and restore the selected firmware.
+
+By default, an update restore is performed, which will preserve the user data
+(unless the firmware image does not contain a 'Customer Upgrade Install' variant,
+in which case an erase restore will be performed).
+
+**WARNING**
+
+This tool can easily destroy your user data irreversibly. Use with caution and
+make sure to backup your data before trying to restore.
+
+**In any case, usage is at your own risk.**
+
+## Requirements
+
+Development Packages of:
+* libimobiledevice
+* libirecovery
+* libusbmuxd
+* libplist
+* libcurl
+* libzip
+* openssl
+
+Software:
+* usbmuxd
+* make
+* autoheader
+* automake
+* autoconf
+* libtool
+* pkg-config
+* gcc or clang
+
+## Installation
+
+To compile run:
+```bash
+./autogen.sh
+make
+sudo make install
+```
+
+## Who/What/Where?
+
+* Home: https://www.libimobiledevice.org/
+* Code: `git clone https://git.libimobiledevice.org/idevicerestore.git`
+* Code (Mirror): `git clone https://github.com/libimobiledevice/idevicerestore.git`
+* Tickets: https://github.com/libimobiledevice/idevicerestore/issues
+* Mailing List: https://lists.libimobiledevice.org/mailman/listinfo/libimobiledevice-devel
+* IRC: irc://irc.freenode.net#libimobiledevice
+
+## Credits
+
+Apple, iPhone, iPad, iPod, iPod Touch, and Apple TV are trademarks of Apple Inc.
+idevicerestore is an independent software tool and has not been
+authorized, sponsored, or otherwise approved by Apple Inc.
+
+README Updated on:
+	2019-09-11