|
|
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.