File: README

package info (click to toggle)
uqwk 2.21-3
  • links: PTS
  • area: main
  • in suites: woody
  • size: 468 kB
  • ctags: 475
  • sloc: ansic: 4,550; sh: 1,105; makefile: 122; perl: 11
file content (75 lines) | stat: -rw-r--r-- 3,034 bytes parent folder | download | duplicates (4)
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
				$Id: README,v 1.3 2000/01/03 08:56:55 js Exp $


UQWK
                       Copyright     1993-1994,             steve belczyk
                       Modifications 1996, 1997, 1998, 1999,
                                     2000                   jeroen scheerder


uqwk is a program which collects all a user's unread mail or news
and formats it into a packet for offline reading.  QWK, Simple
Offline Usenet Packet (SOUP), and ZipNews packet formats are supported.
See the manual page for sommand line options, environment variables and
examples.

Uqwk also accepts reply packets, so replies can be mailed or posted,
depending whether the message is marked private (email) or public (news).

Uqwk also supports a small offline command language, so the contents
of the user's .newsrc file can be viewed and manipulated offline.

0.  Install uqwk if not installed already; see the INSTALL file.

1.  Now you can try it.  Login as a normal user who has some mail.
    First, tell uqwk to print its options: issue

	uqwk -p

    Check that the output reflects your choices in the makefile.
    Next, issue:

	uqwk +r +m

    (The "+r" stops uqwk from clearing the user's mail spool file.)
    This should create a number of *.MSG files in your home directory,
    along with a file named AREAS.  These are the files the offline
    SOUP reader will need.  (Some readers expect these files to have been
    archived using an archiver like zip, lharc, or arj.  You may need
    to obtain Unix versions of these archivers.)

2a. If you will not be using uqwk in QWK mode (hurray!), you need not
    even  bother reading [2b]; advance to [3].
2b. If you are using uqwk to create QWK packets (please *don't*, really,
    since the QWK format does not allow storing Usenet messages
    correctly): QWK packets contain the name, location, etc., of the BBS
    from which messages are being downloaded.  If you plan to use the
    QWK format (please, please, please don't!), you should configure
    this information. The best way is probably to use environment
    variables.  If you are using a Bourne shell, you should add
    something like this to /etc/profile or .profile:

        UQ_BBS_NAME="My Super BBS"
	UQ_BBS_CITY="Somewhere, PA"
	UQ_BBS_PHONE="+1 215 555 1212"
	UQ_BBS_SYSOP="Joe Shmoe"
	UQ_BBS_ID="0,MYBBS"
	export UQ_BBS_NAME UQ_BBS_CITY UQ_BBS_PHONE
	export UQ_BBS_SYSOP UQ_BBS_ID

    If you use a C type shell, try something like this in your
    .cshrc or .login:

        setenv UQ_BBS_NAME "My Super BBS"
	setenv UQ_BBS_CITY "Somewhere, PA"
	setenv UQ_BBS_PHONE "+1 215 555 1212"
	setenv UQ_BBS_SYSOP "Joe Shmoe"
	setenv UQ_BBS_ID "0,MYBBS"

    In both cases, the last entry, the "BBS ID", is the most important.
    It always consists of an integer, a comma, and a string less than
    nine characters, with no intervening spaces.  The string will be
    used to identify reply packets.

3.  Now would be a good time for reading the man page ("man uqwk")
    and the Frequently Asked Questions list ("more FAQ").