X-Git-Url: https://pd.if.org/git/?p=newsd;a=blobdiff_plain;f=INSTALL;h=c20640efb1e799d400f3efd8a355c035cddb3664;hp=bf43d15bdff9ee7904f6e797733f507e432c4c1c;hb=HEAD;hpb=df08ad87b02f43f5bc10209d61d26ccb05103d48

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.