Mention that we're aiming to follow RFC 7159 now.

Cause README.md to show up in Doxygen output as the main page.

Doxyfile

@@ -417,7 +417,7 @@ WARN_LOGFILE           =
 # directories like "/usr/src/myproject". Separate the files or directories 
 # with spaces.
 
-INPUT                  = 
+INPUT                  = README.md .
 
 # If the value of the INPUT tag contains directories, you can use the 
 # FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 
@@ -426,7 +426,7 @@ INPUT                  =
 # *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx *.hpp 
 # *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm
 
-FILE_PATTERNS          = *.h
+FILE_PATTERNS          = *.h *.md
 
 # The RECURSIVE tag can be used to turn specify whether or not subdirectories 
 # should be searched for input files as well. Possible values are YES and NO. 

README.html

@@ -10,7 +10,9 @@
 		<h3>Overview</h3>
 		<p>JSON-C implements a reference counting object model that allows you to easily 
 		construct JSON objects in C, output them as JSON formatted strings and parse 
-		JSON formatted strings back into the C representation of JSON objects.</p>
+		JSON formatted strings back into the C representation of JSON objects.
+		It aims to conform to <a href="https://tools.ietf.org/html/rfc7159">RFC 7159</a>
+		</p>
 
 		<h3>Building</h3>
 		<p>To setup JSON-C to build on your system please run <tt>configure</tt> and <tt>make</tt>.</p>

README.md

@@ -1,6 +1,14 @@
-`json-c`
+`json-c`                       {#mainpage}
 ========
 
+JSON-C - A JSON implementation in C
+-----------------------------------
+
+JSON-C implements a reference counting object model that allows you to easily 
+construct JSON objects in C, output them as JSON formatted strings and parse 
+JSON formatted strings back into the C representation of JSON objects.
+It aims to conform to <a href="https://tools.ietf.org/html/rfc7159">RFC 7159</a>
+
 Building on Unix with `git`, `gcc` and `autotools`
 --------------------------------------------------