Markdown

diff --git a/MANIFEST b/MANIFEST
index df9a257..2fb14ed 100644 (file)
--- a/MANIFEST
+++ b/MANIFEST
@@ -6,7 +6,7 @@ MANIFEST
 MANIFEST.SKIP
 Makefile.PL
 OID.pm
-README
+README.md
 SimpleServer.pm
 SimpleServer.xs
 grs_test.pl

diff --git a/README b/README
deleted file mode 100644 (file)
index 83b3b35..0000000
--- a/README
+++ /dev/null
@@ -1,32 +0,0 @@
-Net::Z3950::SimpleServer - Simple Perl API for building Z39.50 servers.
-
-The SimpleServer module is a tool for constructing Z39.50 "Information
-Retrieval" servers in Perl. The module is easy to use, but it does
-help to have an understanding of the Z39.50 query structure and the
-construction of structured retrieval records.
-
-Z39.50 is a network protocol for searching remote databases and
-retrieving the results in the form of structured "records". It is
-widely used in libraries around the world, as well as in the US
-Federal Government. In addition, it is generally useful whenever you
-wish to integrate a number of different database systems around a
-shared, abstract data model.
-
-The model of the module is simple: It implements a "generic" Z39.50
-server, which invokes callback functions supplied by you to search for
-content in your database. You can use any tools available in Perl to
-supply the content, including modules like DBI and WWW::Search.
-
-The server will take care of managing the network connections for you,
-and it will spawn a new process (or thread, in some environments)
-whenever a new connection is received.
-
-AUTHORS
-       Anders Sønderberg <sondberg@indexdata.dk>
-       Sebastian Hammer <quinn@indexdata.dk>
-       Mike Taylor <mike@indexdata.com>
-
-COPYRIGHT AND LICENCE
-
-See file LICENSE
-

diff --git a/README.md b/README.md
new file mode 100644 (file)
index 0000000..692db88
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+## Net::Z3950::SimpleServer - Simple Perl API for building Z39.50 servers.
+
+The SimpleServer module is a tool for constructing Z39.50 "Information
+Retrieval" servers in Perl. The module is easy to use, but it does
+help to have an understanding of the Z39.50 query structure and the
+construction of structured retrieval records.
+
+Z39.50 is a network protocol for searching remote databases and
+retrieving the results in the form of structured "records". It is
+widely used in libraries around the world, as well as in the US
+Federal Government. In addition, it is generally useful whenever you
+wish to integrate a number of different database systems around a
+shared, abstract data model.
+
+The model of the module is simple: It implements a "generic" Z39.50
+server, which invokes callback functions supplied by you to search for
+content in your database. You can use any tools available in Perl to
+supply the content, including modules like DBI and WWW::Search.
+
+The server will take care of managing the network connections for you,
+and it will spawn a new process (or thread, in some environments)
+whenever a new connection is received.
+
+### AUTHORS
+
+ Anders Sønderberg <sondberg@indexdata.dk>
+
+ Sebastian Hammer <quinn@indexdata.com>
+
+ Mike Taylor <mike@indexdata.com>
+
+ Adam Dickmeiss <adam@indexdata.com>
+
+### COPYRIGHT AND LICENCE
+
+See file LICENSE
+

diff --git a/debian/rules b/debian/rules
index 56271bb..dd8ccc5 100755 (executable)
--- a/debian/rules
+++ b/debian/rules
@@ -12,4 +12,4 @@ override_dh_installchangelogs:
 
 override_dh_installdocs:
        cp LICENSE debian/copyright
-       dh_installdocs -A README
+       dh_installdocs -A README.md

diff --git a/libnet-z3950-simpleserver-perl.spec b/libnet-z3950-simpleserver-perl.spec
index ea16c3f..8710923 100644 (file)
--- a/libnet-z3950-simpleserver-perl.spec
+++ b/libnet-z3950-simpleserver-perl.spec
@@ -38,7 +38,7 @@ find $RPM_BUILD_ROOT/usr/share/man -name '*.gz' -exec rm -f '{}' \;
 # Install additional documentation
 DOCDIR=$RPM_BUILD_ROOT%{_datadir}/doc/perl-simpleserver
 mkdir -p $DOCDIR
-cp -p README Changes $DOCDIR/
+cp -p README.md Changes $DOCDIR/
 
 %clean
 rm -fr ${RPM_BUILD_ROOT}