Annotation of researchv10dc/man/man7/apnews.7, revision 1.1.1.1

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

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.