docs updated; use markdown

Makefile.am

@@ -9,7 +9,7 @@ SUBDIRS = 				\
 
 docsdir = $(datadir)/doc/asn1c
 
-docs_DATA = README FAQ COPYING ChangeLog BUGS TODO
+docs_DATA = README.md FAQ COPYING ChangeLog BUGS TODO
 
 EXTRA_DIST = asn1c.spec.in FAQ BUGS MANIFEST tests/
 CLEANFILES = asn1c.spec

README → README.md

-WHAT TO READ?
-=============
+# WHAT TO READ?
 
-If you haven't installed the asn1c yet, read the INSTALL file for
-a short installation guide.
+If you haven't installed the asn1c yet, read the INSTALL file for a
+short installation guide.
 
 For the list of asn1c command line options, see `asn1c -h` or `man asn1c`.
 
-For more complete documentation on this compiler and on using the
-results of compilation phase, please look into asn1c-quick.pdf and
-asn1c-usage.{pdf,html}.
-If you are building the compiler from the sources, these documents reside
-in the ./doc directory, otherwise they lie nearby the README file you're
-reading right now.
+The comprehensive documentation on this compiler is in asn1c-usage.pdf.
+
+If you are building the compiler from the sources, the PDFs reside
+in the ./doc directory. Normally the file is installed together with the
+README.md file you're reading right now.
 
 Please also read the FAQ file.
 
 An excellent book on ASN.1 is written by Olivier Dubuisson:
 "ASN.1 Communication between heterogeneous systems", ISBN:0-12-6333361-0.
 
-QUICK START (also check out asn1c-quick.pdf)
-============================================
+# QUICK START
+
+(also check out ./doc/asn1c-quick.pdf)
 
 After building [and installing] the compiler (see INSTALL), you may use
 the asn1c command to compile the ASN.1 specification:
@@ -52,12 +51,11 @@ by the compiler.
 
     asn1c -EF <module-to-test.asn1>     # Check semantic validity
 
-
-MODEL OF OPERATION
-==================
+# MODEL OF OPERATION
 
-The asn1c compiler works by processing the ASN.1 module specification
+The asn1c compiler works by processing the ASN.1 module specifications
 in several stages:
+
 1. In the first stage, the ASN.1 file is parsed.
    (Parsing produces an ASN.1 syntax tree for the subsequent levels)
 2. In the second stage, the syntax tree is "fixed".

asn1c.spec.in

@@ -37,7 +37,7 @@ rm -rf $RPM_BUILD_ROOT
 rm -rf $RPM_BUILD_ROOT
 
 %files
-%doc README FAQ COPYING ChangeLog BUGS TODO
+%doc README.md FAQ COPYING ChangeLog BUGS TODO
 %doc doc/asn1c-usage.pdf doc/asn1c-usage.html
 %attr(755,root,root) %{_bindir}
 %attr(644,root,root) %{_datadir}/asn1c

doc/Makefile.am

@@ -3,7 +3,7 @@ SUBDIRS = docsrc
 
 docsdir = $(datadir)/doc/asn1c
 
-docs_DATA = $(srcdir)/*.pdf
+docs_DATA = $(srcdir)/asn1c-*.pdf
 
-EXTRA_DIST = $(srcdir)/*.pdf
+EXTRA_DIST = $(srcdir)/asn1c-*.pdf