[PATCH] ath9k_htc_firmware: rename README to README.md

Luis R. Rodriguez mcgrof at do-not-panic.com
Thu Mar 28 21:15:39 EDT 2013


From: "Luis R. Rodriguez" <mcgrof at do-not-panic.com>

Use the github markup language. This allows README's
to have dynamic links and display on github.

I've done a bit of trimmng too.

Signed-off-by: Luis R. Rodriguez <mcgrof at do-not-panic.com>
---
 README => README.md |   83 +++++++++++++++++----------------------------------
 1 file changed, 28 insertions(+), 55 deletions(-)
 rename README => README.md (57%)

diff --git a/README b/README.md
similarity index 57%
rename from README
rename to README.md
index 18af41f..788c3a3 100644
--- a/README
+++ b/README.md
@@ -1,15 +1,12 @@
-This is the firmware for the Qualcomm Atheros AR7010 and AR9271 USB
-802.11n NICs.
-
-What is this exactly?
----------------------
+ath9k_htc open firmare
+======================
 
-This is the firmware which resides in RAM on the AR7010/AR9271 NICs.
-It is used by ath9k (Linux) and athn (OpenBSD) to provide wireless
-services.
+This is the firmware for the Qualcomm Atheros AR7010 and AR9271 USB
+802.11n NICs. This is the firmware which resides in RAM on the
+AR7010/AR9271 NICs. It is used by ath9k (Linux) and athn (OpenBSD)
+to provide wireless services.
 
-What licence is this covered by?
---------------------------------
+## What licence is this covered by?
 
 The Qualcomm Atheros owned code is under the ClearBSD licence.
 
@@ -29,8 +26,7 @@ not bring the rest of the binary under the GPLv2.  Please read the
 ECOS caveats in more detail.
 
 
-Ok, what are those NICs?
-------------------------
+## Ok, what are those NICs?
 
 The AR7010 is a USB/PCIe SoC with onboard RAM, ROM and flash.
 It comes with an external wireless chip connected via PCIe - typically
@@ -40,61 +36,38 @@ The AR9271 is a USB/Wifi SoC with onboad RAM, ROM, flash and the
 actual wireless chip.  The wireless core is an off-shoot of the AR9285.
 It is a single-chip solution.
 
-How do I build it?
-------------------
-
-You're in for a treat.
-
-* You first have to build the toolchain.
-
-  * Linux:
-
-  $ make toolchain
-
-  * FreeBSD:
-
-  $ gmake toolchain
-
-  (Yes, I made this work on FreeBSD as well.)
+## How do I build it?
 
-* Next, build the firmware.
-
-  * Linux:
+You will end up with two .fw files - one for the AR7010 and one for
+the AR9271. You can build this on Linux and FreeBSD. You first
+have to buid the toolchain and then the firmware.
 
-  $ ./build
+### Linux
 
-  * FreeBSD:
+```bash 
+make toolchain
+./build
+```
 
-  edit the build script, change make to gmake, and then
+### FreeBSD
 
-  $ ./build
+Edit the build script, change make to gmake, and then
 
-You will end up with two .fw files - one for the AR7010 and one for
-the AR9271.
+```bash 
+gmake toolchain
+./build
+```
 
-
-Then what?
-----------
+## Install the firmware
 
 You need to then copy this into the relevant location for your operating
 system.  Yes, this means you need a driver.  No, there's no FreeBSD
 driver yet for this particular chipset, sorry.
 
+## Bug reports
 
-Where do I file bugs?
----------------------
-
-Please file bugs in github - http://github.com/qca/open-ath9k-htc-firmware/issues .
-
-
-Mailing lists?
---------------
-
-Here you go:
-
-http://lists.infradead.org/mailman/listinfo/ath9k_htc_fw
-
-And
+Please file [bugs in github](http://github.com/qca/open-ath9k-htc-firmware/issues) 
 
-ath9k_htc_fw at lists.infradead.org
+## Mailing lists
 
+  * [Mailing List for ath9k_htc](http://lists.infradead.org/mailman/listinfo/ath9k_htc_fw) 
-- 
1.7.10.4




More information about the Ath9k_htc_fw mailing list