From 334b16962adfd036650156a18edf9847ae5f33d9 Mon Sep 17 00:00:00 2001
From: Ulf Magnusson <ulfalizer@gmail.com>
Date: Sun, 16 Dec 2012 09:25:09 +0100
Subject: Spiffy up README.

---
 README.md | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index b668366..ef41deb 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,4 @@
-Kconfiglib
-==========
+# Kconfiglib #
 
 A Python library for doing stuff with Kconfig-based configuration systems. Can
 extract information, query and set symbol values, and read and write
@@ -7,11 +6,12 @@ extract information, query and set symbol values, and read and write
 utilities in the kernel, usually invoked via make targets such as
 <i>menuconfig</i> and <i>defconfig</i>.
 
-See kconfiglib.py for a longer introduction. The (extensive) documentation is
-generated with
+The (extensive) documentation is generated with
 
 > $ pydoc [-w] kconfiglib
 
+## Installation ##
+
 Installation instructions for the Linux kernel (in the kernel root):
 
 > $ git clone git://github.com/ulfalizer/Kconfiglib.git  
@@ -21,11 +21,14 @@ Installation instructions for the Linux kernel (in the kernel root):
 
 In addition to creating a handy interface, the make targets are needed to pick
 up environment variables set in the kernel makefiles, which are referenced in
-the Kconfig files (ARCH, SRCARCH, and KERNELVERSION as of Linux 3.7.0).
+the Kconfig files (<i>ARCH</i>, <i>SRCARCH</i>, and <i>KERNELVERSION</i> as of
+Linux 3.7.0).
 
 Please tell me if the patch does not apply. It should be trivial to apply
 manually.
 
+## Test suite ##
+
 The test suite is run with
 
 > $ python Kconfiglib/testsuite.py
@@ -35,6 +38,8 @@ configurations generated by Kconfiglib with configurations generated by
 <i>scripts/kconfig/conf</i> for a number of cases. You might want to use the
 "speedy" option; see testsuite.py.
 
+## Misc. notes ##
+
 Please tell me if you miss some API instead of digging into internals. The
 internal data structures and APIs, and dependency stuff in particular, are
 unlikely to be exactly what you want as a user (hence why they're internal :).
-- 
cgit v1.2.3