1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
|
--- README.in.orig Wed Apr 21 01:16:33 1999
+++ README.in Fri Feb 9 05:51:35 2001
@@ -1,9 +1,12 @@
+[edited by Winston Edmond 02/2001
+ Note: `./README' will be created by `./configure' from `README.in']
+
Newsx - An NNTP client for posting and fetching news
====================================================
- Version @VERSION@
- Written by Egil Kvaleberg
+ Version @VERSION@
+ Written by Egil Kvaleberg
------
@@ -107,36 +110,66 @@
test Directory for test code
-COMPILE AND INSTALL
--------------------
-
-1. Type `make', and hopefully you will get the newsx executable.
- Read the INSTALL for further enlightenment.
+CONFIGURE, COMPILE, AND INSTALL
+-------------------------------
-2. Type `su' to become root, and then `make install' to install the
- executables and the man pages.
+1. Set up your local news server first. Newsx auto-configuration depends
+ on the news server files and directories it finds and where.
+2. Glance at ./INSTALL to see if you need any special configuration
+ options. Run ./configure with the options you prefer.
-MAILING LISTS
--------------
+3. Type `make', and hopefully you will get the newsx executable.
-If you want to be informed about future newsx versions and receive
-possible bug alerts, you can send an email message to:
-
- majordomo@kvaleberg.no
-
-with the following line in the message body:
-
- subscribe newsx-announce
+4. Type `su' to become root, and then `make install' to install the
+ executables and the man pages.
-If you want to join the newsx discussion list, you can send an
-email message to the same address with the following line in the
-message body:
- subscribe newsx
+QUICK START -- GENERAL
+----------------------
-The Usenet newsgroup news.software.nntp is also a suitable forum for
-discussing newsx.
+Newsx moves articles between servers, so you need to have a working local
+news server with at least one newsgroup in order to test newsx. There are
+two basic tests:
+ (1) can an article locally posted to the newsgroup and queued by the news
+ server for delivery to the remote server be successfully sent to the
+ remote server, and
+ (2) can articles from the remote server be fetched and placed in the
+ local server's "in" queue.
+The "QUICK START WITH INN/C-NEWS" instructions below walk you through these
+tests.
+
+By default, an in.hosts/$server file is built automatically and will fetch
+all articles in all groups listed in active (except as limited by the sys
+file or command line options). It is sometimes worthwhile to set up this
+file by hand rather than accept the default.
+
+Special case #1:
+ * you've been reading news DIRECTLY from one or more REMOTE servers,
+ * you're now setting up a local server, AND
+ * you'd like to avoid downloading articles you've already seen.
+
+ You can copy your $HOME/.newsrc file and use it as the initial
+ in.hosts/$server file! The (remote server's) article numbers will be
+ extracted, and if you use "--forget-inactive" the first time you call
+ `newsx', groups that were in .newsrc that you've unsubscribed to will be
+ eliminated from in.hosts/$server, and current and future downloading
+ will be limited to only the groups you're subscribed to at the time.
+ (This does not "track" newsgroup subscription changes you make later.)
+
+Special case #2:
+ * you've been running a local server for some time and have lots of
+ newsgroups in 'active' that you don't want fetched.
+
+ Use the 'active' file or a .newsrc file, remove the article numbers
+ (assuming they're the local server's article numbers), trim the list
+ down to the groups you want, and use that as the in.hosts/$server
+ file.
+
+WARNING:
+ Newsgroups can have LOTS of articles. Please look at the newsx man page
+ descriptions of --maxnew, --syncnew, and --maxart before running newsx
+ to pull articles from the remote server the first time.
QUICK START WITH INN
@@ -144,6 +177,7 @@
We assume that you already have INN installed. What you have to do is:
+SETUP:
1. Do all maintenance of the news system as user `@DOC_NEWSUSER@'. Ensure
that the `.profile' of this user defines a path that includes
`@DOC_NEWSBIN@'. E.g.:
@@ -168,14 +202,21 @@
the special `newsx' in the example above with the particular exclude
string for the newsserver in question.
- 3. If you haven't done so already, define one or more newsgroups that
- will appear in the `@DOC_ACTIVE@' file:
+ 3. If you haven't done so already, create one or more newsgroups in the
+ `@DOC_ACTIVE@' file that you will be fetching from the remote
+ newsserver:
ctlinnd newgroup acme.test
- 4. Try to fetch news articles for these groups by doing:
+FETCH TEST:
+ 4. Dry-run test fetching news articles for these groups by doing:
+
+ newsx -ddddd -n --maxnew 100 acme news.acme.net
+
+ If the output looks correct, try running it for real (using your
+ preference of --maxnew, --maxart, and --syncnew options):
- newsx -ddddd acme news.acme.net
+ newsx -dd --maxnew 100 acme news.acme.net
5. The articles should now appear in the incoming batch
`@DOC_INCOMING@'. If you invoke:
@@ -185,13 +226,15 @@
the incoming articles should appear in the news spool. In the
example, you may look for them in `@DOC_SPOOL@/acme/test'.
+POST TEST:
6. Using a newsreader, post an article to a suitable test group. Try to
use a group with as small distribution as possible, preferably local
to the external newsserver you are using. If you haven't done so
already, the group must be in the `@DOC_ACTIVE@' file.
- The next time that `rnews' is invoked, the articles will be output
- to the spool file `@DOC_BATCH@/acme' specified in the `@DOC_NEWSFEEDS@' file.
+ The next time that `rnews' is invoked, the articles will be output to
+ the spool file `@DOC_BATCH@/acme' specified in the
+ `@DOC_NEWSFEEDS@' file.
7. Run:
@@ -210,16 +253,11 @@
newsx -l posted.log -f posted acme news.acme.net
- 9. To catch up with new newsgroups in a quicker way, you may want to
- limit the number of articles fetched by adding the option:
-
- --maxnew 100
-
-10. You may want to arrange for automatic news exchange by using `crontab'.
+ 9. You may want to arrange for automatic news exchange by using `crontab'.
It is usually good to invoke `newsrun' before and after the newsx
session.
-11. For more information about how to set up news and other subjects related
+10. For more information about how to set up news and other subjects related
to use of ordinary ISP accounts, you might want to consult:
http://www.kvaleberg.com/ISP-Hookup-HOWTO.html
@@ -231,6 +269,7 @@
We assume that you already have C News installed. What you have to do is:
+SETUP:
1. Do all maintenance of the news system as user `@DOC_NEWSUSER@'. Ensure
that the `.profile' of this user defines a path that includes
`@DOC_NEWSBIN@'. E.g.:
@@ -244,8 +283,9 @@
ME:all/all::
acme/newsx:all,!junk,!control/all:FL:
- The outgoing batch will be named `acme' - replace `acme' with what
- is appropriate for your configuration.
+ The filename of the outgoing batch will be the server's name, `acme' in
+ the example above. Replace `acme' with what is appropriate for your
+ configuration.
All groups that you do NOT want to exchange with the host in question
should be listed with an `!' before it, the `junk' group being a
@@ -254,27 +294,38 @@
The L-flag is a double insurance that only actual local postings will
be sent out.
- NOTE: Depending on how you use the spool, you may want to replace
- the special `newsx' in the example above with the particular exclude
- string for the newsserver in question.
-
- 3. If you haven't done so already, define one or more newsgroups that
- will appear in the `@DOC_ACTIVE@' file:
+ NOTE: Depending on how you use the spool, you may want to replace the
+ special `newsx' in the example above with the particular exclude string
+ for the newsserver in question. This is particularly true if you are
+ sending and receiving news with multiple servers or if the local system
+ names you're using aren't the name the servers use for themselvers in
+ "Path:".
+
+ 3. If you haven't done so already, create one or more newsgroups in the
+ `@DOC_ACTIVE@' file that you will be fetching from the remote
+ newsserver:
addgroup acme.test y
- 4. Try to fetch news articles for these groups by doing:
+FETCH TEST:
+ 4. Dry-run test fetching news articles for these groups by doing:
+
+ newsx -ddddd -n --maxnew 100 acme news.acme.net
- newsx -ddddd acme news.acme.net
+ If the output looks correct, try running it for real (using your
+ preference of --maxnew, --maxart, and --syncnew options):
+
+ newsx -dd --maxnew 100 acme news.acme.net
5. The articles should now appear in the incoming batch
- `@DOC_INCOMING@'. If you invoke:
+ `@DOC_INCOMING@'. If you invoke:
newsrun
- the incoming articles should appear in the news spool. In the
- example, you may look for them in `@DOC_SPOOL@/acme/test'.
+ the incoming articles should appear in the news spool. For newsgroup
+ acme.test, articles would be placed in `@DOC_SPOOL@/acme/test/'.
+POST TEST:
6. Using a newsreader, post an article to a suitable test group. Try to
use a group with as small distribution as possible, preferably local
to the external newsserver you are using. If you haven't done so
@@ -287,6 +338,28 @@
7. Continue with point 7 in the INN explanation above.
+MAILING LISTS
+-------------
+
+If you want to be informed about future newsx versions and receive
+possible bug alerts, you can send an email message to:
+
+ majordomo@kvaleberg.no
+
+with the following line in the message body:
+
+ subscribe newsx-announce
+
+If you want to join the newsx discussion list, you can send an
+email message to the same address with the following line in the
+message body:
+
+ subscribe newsx
+
+The Usenet newsgroup news.software.nntp is also a suitable forum for
+discussing newsx.
+
+
LEGAL MATTER
------------
@@ -398,6 +471,3 @@
Husebybakken 14A
N-0379 Oslo
Norway
-
-
-$Id: README.in,v 1.60 1999/04/21 05:16:33 src Exp $
|
