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
|
.TH PERUSER 1x "December 1998" "Debian Project" "News Peruser"
.SH NAME
peruser \- suite for offline reading and composing of Usenet articles
.SH SYNOPSIS
.B peruser
.br
.B npcollections
.br
.SH "DESCRIPTION"
This manual page documents briefly
.B News Peruser
and it was written for the Debian GNU/Linux distribution because the
original program does not have a manual page. Thus, the page is probably
.B "out of date" .
Instead, there is some documentation in the /usr/doc/peruser directory.
.PP
.B News Peruser
is a suite of seven small programs to enable a user to do offline
reading and composition of Usenet news articles. Peruser can compose
replies-by-mail, as well, and pass them off to a local sendmail.
The toplevel applet's filename is "npcollections", but you are able
to launch News Peruser by typing either that or "peruser" at the
shell prompt. Or invoking it from your window manager's menu.
.br
News Peruser has been designed with the concept of header retrieval in
mind. It is assumed that the user will wish to quickly download just
the headers of the unseen articles from the newsgroups he or she is
interested in, and then, perhaps while offline, peruse those headers,
selecting those whose full article text is of interest. The user can then
reconnect to the news server and transfer only the text of those
particular messages, saving considerable time if he or she reads many
newsgroups over a slow, dial-up network connection.
.br
All configuration of News Peruser is accomplished with the npconfig
applet, which is launched by pressing the configure button of
npcollections, although it can be launched from the command line. npconfig
requires no arguments.
.br
Newsgroups are organized into trees in the main scrolled window widget
of npcollections. The root node of each tree is the server" node, and
its children are the "newsgroups." Folders, if any have been configured,
are represented by trees also, below the actual newsgroup trees in the
scrolled window.
.br
All actual news server nodes have four groups appended to their group
trees automatically upon creation: the FOLLOW-UPS group, the POSTED
group, the OUTBOX group, and the SENT-MAIL group. Original news
articles created by News Peruser for a particular news server, sit in
the FOLLOW-UPS group until the next time the group is "transferred,"
when Peruser will attempt to post the articles to the appropriate news
server. Successfully posted articles are moved from the FOLLOW-UPS
group to the POSTED group, where they sit until explicitly deleted.
Outgoing mail messages generated by Peruser sit in the group's OUTBOX
file until the next time the group is "transferred," when Peruser will
attempt to pass the messages off to the sendmail program. Sent mail is
moved from the OUTBOX group to the SENT-MAIL group, where it sits
until explicitly deleted by the user. Each news server the user wishes
to access, and the groups accessed through that particular server, are
represented by a separate tree in the scrolled window.
.br
All message transfers are accomplished in the gui by the transfer button.
Transferring" a group will cause different actions to be performed,
depending upon the group's type. For newsgroups "transferring" the group
will retrieve usenet articles or headers from their appropriate news
servers, for FOLLOW-UPS groups "transferring" the group will post any
articles in the group to the appropriate news server, and any outgoing
mail messages will be passed off to the sendmail program. The appropriate
action is performed automatically.
.br
The scope of the actions which the transfer, pack, expire, and search
buttons launch, is limited by the currently-selected node in the main
group tree. If a server node is selected, then only the newsgroups in
that server's tree will be affected. If a single newsgroup is
selected, then only that group will be affected. If no selection
exists in the main group tree, all groups of all server nodes will be
affected by the transfer, pack, expire, or search operation.
.br
To pack a newsgroup, means to remove all the seen articles from it. To
expire a newsgroup, means to remove all articles having a Date header
describing a time older than the configured expiry period. The only
means to remove messages from newsgroups is by packing or expiring
them. If you wish to keep particular messages, and remove others, you
may mark those you wish to keep as unseen, and those you wish to
remove as seen, and then pack the newsgroup, or you can copy the
messages into a persistent folder, where it will remain until
explicitly deleted.
.br
Folders, FOLLOW-UPS, POSTED, OUTBOX, and SENT-MAIL groups are not
affected by packing or expiring. Messages linger in these groups until
they are explicitly deleted or they are posted/mailed. All explicitly
deleted messages are stored on disk by Peruser and can be undeleted or
purged from storage with the undelete button on the npcollections
window.
.br
In the thread tree of the npsummary applet, the presence or absence
of two upper-case letters beside entries indicates whether the
corresponding message contains a full article, or just the header (H =
header), whether the header has had its full article text requested
for future downloading (R = requested, instead of H), and whether the
message has been seen or not (U = unseen). As well, An uppercase 'D'
preceding a entry indicates it is a dummy node, inserted into the thread
tree by the program to represent a missing precursor, or to act as a
dummy root node for messages which have the same Subject header, but
which reference messages not currently residing in the newsgroup's spool
file. The fractions beside root nodes are similar to the statistics used
in the News Peruser Collections applet to summarize newsgroups, only here,
they represent the statistics for the articles in their respective thread
subtrees. The fractions are of the form: unseen/total : requested/headers.
.br
The final release of News Peruser will recognize quoted-printable MIME
Content-Transfer-Encodings of the iso8859-x character sets, and display
them appropriately; however, no other MIME support is planned for
the future.
.SH OPTIONS
There are no command line options available.
.SH FILES
.TP
.B ~/.peruser4-config
user's personal information
.TP
.B ~/.peruser4-newsrc
user's NNTP server information
.TP
.B ~/.peruser_spool/
user's news spool directory
.SH AUTHOR
.B News Peruser
was written by James Bailie <jbailie@wwdc.com>.
.br
This manual page was written by Josip Rodin <jrodin@jagor.srce.hr>,
for the Debian GNU/Linux system (but may be used by others).
|
