From 6585ff02fccc50f6bb6e3b23aa4dc906762af06e Mon Sep 17 00:00:00 2001 From: Nathan Wagner Date: Fri, 2 Dec 2011 03:27:54 -0500 Subject: [PATCH] Additions to INSTALL docs. --- INSTALL | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/INSTALL b/INSTALL index bf43d15..c20640e 100644 --- a/INSTALL +++ b/INSTALL @@ -13,3 +13,28 @@ though it doesn't need to be a local install. Only Postgres 9.1 has been tested but it should currently work with at least 8.4. I won't make any effort to maintain compatibility with versions of postgres earlier than 9.1. + +The basic server configuration is done in the manner of Net::Server. + +Provided example newsd program for how to call the module +and get a running server. + +For the Postgres storage to work, there must be a database +named 'news', create it user news and load the schema.sql +file into that database. See or execute the make schema target. + +You will probably want the regular set of newsgroups maintained +by ISC. A 'make activesync' will download and install them +into the database. + +You can fire up a test server with 'make testserver', and +the 'make test' target will start and use a test server. +These all use the existing database, so if you post against +the testing server, the articles will persist. + +The test server runs on the default Net::Server port of 20203, +so your newsreader needs to hit that port. I use slrn, + +NNTPSERVER=localhost:20203 slrn -C -f ~/.jnewsrc --create + +Will create the newsrc for slrn and you can post a message. -- 2.40.0