|
|
1.1 root 1: .TH APNEWS 7 alice
2: .CT 1 inst_info
3: .SH NAME
4: apnews, ap.keys \- present AP wire stories
5: .SH SYNOPSIS
6: .B apnews
7: [
8: .B -f
9: .I dir
10: ]
11: [
12: .B -r
13: ]
14: .SH DESCRIPTION
15: .I Apnews
16: presents news from the AP wire on a cursor-addressed screen.
17: The top half of the screen contains 20
18: story slugs (two-word labels).
19: .I Apnews
20: responds to these commands:
21: .TP "\w'c file 'u"
22: .I n
23: Print story for slug
24: .IR n ;
25: page through it by typing newlines.
26: .TP
27: .B m
28: Present more slugs.
29: .TP
30: .B \&.
31: Return to current slug list.
32: .TP
33: .B t
34: Top. Return to first list of slugs
35: .TP
36: .BI s " keywords"
37: Present slugs for stories containing these keywords.
38: .TP
39: .B y
40: Present slugs for stories containing words from the last story read.
41: .TP
42: .BI c " file"
43: Copy. Add story being read to named file or directory.
44: .TP
45: .B ?
46: Print some help.
47: .PP
48: To suggest interest,
49: slugs may be followed by a bracketed number that shows
50: the average number of pages (up to 5) that readers
51: have perused.
52: Option
53: .B -r
54: turns this feature off.
55: .PP
56: Option
57: .B -f
58: directs the attention of
59: .I apnews
60: to a specified directory of AP stories, as may be collected by
61: .FR ap.keys .
62: .PP
63: To monitor news automatically, put a file
64: .F ap.keys
65: in your home directory.
66: This file contains instructions marked by
67: .LR * ,
68: each followed by one or more search lines.
69: Instructions specify what to capture:
70: .TP
71: .B S
72: whole story
73: .PD0
74: .TP
75: .B P
76: first paragraph
77: .TP
78: .B H
79: heading
80: .PD
81: .LP
82: then what to do with it:
83: .TP
84: .BI | " command
85: specifying a command (often mail) to be executed with the
86: story as standard input
87: .PD0
88: .TP
89: .BI > " file"
90: .PD
91: specifying a file or directory to add the story to;
92: pathnames are relative to your home directory
93: .PP
94: If no instruction is present, the default is
95: .IP
96: .L *S | mail yourself
97: .PP
98: Search lines may contain:
99: .IP (1)
100: a sequence of blank-separated words; these words
101: must occur in this order
102: .PD0
103: .IP (2)
104: a sequence of words separated
105: by commas; these words must appear in the same sentence
106: .IP (3)
107: a sequence of words separated by periods; these words may
108: occur anywhere in the story, but all must appear
109: .PD
110: .PP
111: Combinations
112: are allowed, e.g.\&
113: .L " x . y, z"
114: specifies
115: .L y
116: and
117: .L z
118: in the same sentence and
119: .L x
120: somewhere in the same story.
121: The character
122: .L !
123: means not, so that
124: .L !chocolate chip
125: means
126: .L chip
127: not preceded by
128: .LR chocolate .
129: Some suffixes are removed; and
130: capitals are ignored except when entire words are
131: capitalized.
132: Thus
133: .L ERA
134: and
135: .L era
136: are distinguished, but
137: .L Waters
138: and
139: .L waters
140: are not.
141: Special `words' specify story types:
142: .TP
143: .B #f
144: flash
145: .PD0
146: .TP
147: .B #b
148: bulletin
149: .TP
150: .B #u
151: urgent news
152: .TP
153: .B #r
154: regular news
155: .TP
156: .B #d
157: deferred news
158: .PD
159: .SH EXAMPLES
160: .EX
161: *S > stuff
162: bell laboratories
163: FCC . telephone, regulation
164: *P | mail joe
165: #b
166: AM-NewsDigest
167: .EE
168: .SH FILES
169: .F ap.keys
170: .br
171: .F /usr/spool/ap/*
172: .SH BUGS
173: .I Apnews
174: can fail to work well in a
175: .IR mux (9.1)
176: window, for two reasons.
177: .br
178: (1) The window needs a terminal emulator.
179: Before invoking
180: .I apnews,
181: do
182: .L "exec term 5620"
183: (or
184: .BR 2621 );
185: see
186: .IR term (9.1).
187: .br
188: (2) Remote execution needs a transparent connection.
189: If logged in elsewhere make the connection to the serving machine by doing, for example,
190: .L "ndcon alice
191: or
192: .LR "nrx alice apnews"
193: (after downloading an emulator, if
194: necessary);
195: see
196: .IR dcon (1).
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.