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

1.1       root        1: .TH TEL 7
                      2: .CT 1 inst_info
                      3: .SH NAME
                      4: tel, telno, dq \- phone books
                      5: .SH SYNOPSIS
                      6: .B tel
                      7: .I key
                      8: .PP
                      9: .B telno
                     10: .I key ...
                     11: .PP
                     12: .B dq
                     13: .SH DESCRIPTION
                     14: .I Tel
                     15: looks up
                     16: .I key
                     17: in a private telephone book,
                     18: .FR $HOME/lib/tel ,
                     19: if it exists,
                     20: and in a local book
                     21: .FR /usr/lib/tel .
                     22: .PP
                     23: .I Tel
                     24: is simply a script for
                     25: .IR grep 
                     26: (see
                     27: .IR gre (1)),
                     28: so lookup may be by any part of a name or number.
                     29: Customarily the local telephone book contains names, userids,
                     30: home numbers, and office numbers of users.
                     31: It also contains a directory of area codes and miscellaneous
                     32: people of some general interest.
                     33: .PP
                     34: .I Telno
                     35: and
                     36: .I dq
                     37: retrieve information from a central, current database
                     38: of AT&T personnel.
                     39: The former is a simple one-line interface to the latter.
                     40: .PP
                     41: For
                     42: .I telno,
                     43: a
                     44: .I key
                     45: is typically a name.
                     46: Other fields in the database may be matched by using tabs 
                     47: within the key (the key
                     48: must be quoted to protect spaces and tabs from the shell).
                     49: The fields are, in order:
                     50: .IP
                     51: .nf
                     52: name (last; last,first; first last; or payroll account no.)
                     53: organization (e.g. att or bl)
                     54: area code and exchange
                     55: extension
                     56: location
                     57: room
                     58: department
                     59: electronic mail address
                     60: .fi
                     61: .LP
                     62: Only a prefix of a first name need by given.
                     63: In some positions
                     64: .L *
                     65: (or
                     66: .BR ... )
                     67: and
                     68: .L ?
                     69: may be used as a wild cards as in 
                     70: .IR sh (1).
                     71: Case is unimportant.
                     72: .PP
                     73: .I Dq
                     74: provides interactive access to the central database.
                     75: Under
                     76: .IR mux (9.1)
                     77: it is best run
                     78: in a terminal-simulator layer, either
                     79: .L "term 5620
                     80: or
                     81: .LR "term 2621" ;
                     82: see
                     83: .IR term (9.1).
                     84: It displays a form with the same fields as
                     85: .I telno.
                     86: Fill in one or more fields, using tabs to move (circularly) between them,
                     87: backspace to erase, and space
                     88: to delete a field.
                     89: Upon carriage return a group of answers is displayed.
                     90: Type
                     91: .L ?
                     92: instead of a name to get more instructions.
                     93: .SH EXAMPLES
                     94: In these examples,
                     95: .L \et
                     96: represents a literal tab.
                     97: .TP
                     98: .L
                     99: telno emlin
                    100: Anyone named Emlin.
                    101: .TP
                    102: .L
                    103: telno '\et\et\et3744'
                    104: Anyone whose phone extension is 3744.
                    105: .TP
                    106: .L
                    107: telno 'e*\et\et\et\et\et\et\etresearch!*'
                    108: Anyone whose last name begins with E and
                    109: who gets electronic mail on machine
                    110: .LR research .
                    111: .SH FILES
                    112: .FR $HOME/lib/tel
                    113: .br
                    114: .F /usr/lib/tel
                    115: .SH SEE ALSO
                    116: .I bellcat
                    117: in
                    118: .IR library (7),
                    119: .IR pq (7)
                    120: .SH BUGS
                    121: The algorithm used by
                    122: .I dq
                    123: (and hence
                    124: .IR telno )
                    125: to match each field is distinct and unknown to us.
                    126: .br
                    127: Not all entries have electronic mail addresses.

unix.superglobalmegacorp.com

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