From: Adam Dickmeiss Date: Fri, 8 Jan 2016 11:04:19 +0000 (+0100) Subject: Markdown X-Git-Url: http://sru.miketaylor.org.uk/cgi-bin?a=commitdiff_plain;p=simpleserver-moved-to-github.git Markdown --- diff --git a/MANIFEST b/MANIFEST index df9a257..2fb14ed 100644 --- 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 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 - Sebastian Hammer - Mike Taylor - -COPYRIGHT AND LICENCE - -See file LICENSE - diff --git a/README.md b/README.md new file mode 100644 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 + + Sebastian Hammer + + Mike Taylor + + Adam Dickmeiss + +### COPYRIGHT AND LICENCE + +See file LICENSE + diff --git a/debian/rules b/debian/rules index 56271bb..dd8ccc5 100755 --- 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 --- 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}