Added all of the MH sources, including RCS files, in
[mmh] / docs / historical / mh-6.8.5 / conf / doc / bboards.rf
1 .\"     @(MHWARNING)
2 .\" @(#)$Id: bboards.rf,v 1.6 1994/04/15 23:10:56 jromine Exp $
3 .SC BBOARDS 1
4 .NA
5 bboards \- the UCI BBoards facility
6 .SY
7 bbc
8 \%[\-check]
9 \%[\-read]
10 bboards ...
11 \%[\-help]
12 .DE
13 The home directory of \fIbboards\fR is where the BBoard system is kept.
14 This documentation describes some of the nuances of the BBoard system.
15
16 Note that if your system is configured to use the Network News
17 Transfer Protocol (\fBNNTP\fP) to read BBoards,
18 @BEGIN: NNTP
19 (your system does seem to be configured this way),
20 @END: NNTP
21 then there is no local bboards setup; instead, \fIbbc\fP 
22 opens an \fBNNTP\fP connection to the local server.
23
24 .in +.5i
25 .ti -.5i
26 \fBBBoards, BBoard\-IDs\fR
27 .br
28 A BBoard is just a file containing a group of messages relating to the same
29 topic.
30 These files live in the ~bboards home directory.
31 Each message in a BBoard file has in its header the line
32 \*(lqBBoard-Id: n\*(rq,
33 where \*(lqn\*(rq is an ascending decimal number.
34 This id-number is unique for each message in a BBoards file.
35 It should NOT be confused with the message number of a message,
36 which can change as messages are removed from the BBoard.
37
38 .ti -.5i
39 \fBBBoard Handling\fR
40 .br
41 To read BBoards, use the \fIbbc\fR and \fImsh\fR programs.
42 The \fImsh\fR command is a monolithic program which contains all the
43 functionality of \fIMH\fR in a single program.
44 The `\-check' switch to \fIbbc\fR lets you check on the status of BBoards,
45 and the `\-read' switch tells \fIbbc\fR to invoke \fImsh\fR to read
46 those BBoards.
47
48 .ti -.5i
49 \fBCreating a BBoard\fR
50 .br
51 Both public, and private BBoards are supported.
52 Contact the mail address \fIPostMaster\fR if you'd like to have a BBoard
53 created.
54
55 .ti -.5i
56 \fBBBoard addresses\fR
57 .br
58 Each BBoard has associated with it 4 addresses,
59 these are (for the ficticious BBoard called ``hacks''):
60 .in +.75i
61 .br
62 .ti -.5i
63 \fBhacks\fR\0: The Internet wide distribution list.
64 .br
65 .ti -.5i
66 \fBdist-hacks\fR\0: The local BBoard.
67 .br
68 .ti -.5i
69 \fBhacks-request\fR\0:
70 The people responsible for the BBoard at the Internet level.
71 .br
72 .ti -.5i
73 \fBlocal-hacks-request\fR\0:
74 The people responsible for the BBoard locally.
75 .in -.75i
76 .in -.5i
77 .Fi
78 ^$HOME/\&.mh\(ruprofile~^The user profile
79 ^$HOME/\&.bbrc~^BBoard information
80 .Pr
81 ^Path:~^To determine the user's MH directory
82 .Ps
83 ^bboards:~^To specify interesting BBoards
84 .Ps
85 ^mshproc:~^Program to read a given BBoard
86 .Sa
87 bbc(1), bbl(1), bbleader(1), msh(1)
88 .De
89 The default bboard is \*(lqsystem\*(rq
90 .Co
91 None
92 .En