Annotation of researchv10dc/man/man1/tdc.1, revision 1.1.1.1

1.1       root        1: .TH TDC 1
                      2: .SH NAME
                      3: tdc \- fill out TDC form
                      4: .SH SYNOPSIS
                      5: .B tdc
                      6: .PP
                      7: .B tdc
                      8: [
                      9: .B -b
                     10: ]
                     11: .PP
                     12: .B tdc
                     13: .I bill-info
                     14: [
                     15: .I card-info
                     16: ]
                     17: .SH DESCRIPTION
                     18: This command will prepare a PostScript job that will produce
                     19: a standard Telephone Discount Concession form (ATT363) when printed.
                     20: With no arguments it simply gives usage information on the standard
                     21: error output.  Option
                     22: .B -b
                     23: causes PostScript for a blank form to be generated.  To have the
                     24: form filled in,
                     25: .I bill-info
                     26: and, optionally,
                     27: .I card-info
                     28: should be supplied.  Each of these consists of five arguments, with
                     29: the first set corresponding to the telephone bill and the second set
                     30: corresponding to AT&T Universal Card calls.  The five arguments are
                     31: as follows, and must appear in the order shown:
                     32: .TP
                     33: .I month
                     34: Billing month for the bill.  This can be a month abbreviation or
                     35: a month number.  There is not room on the form for the full month
                     36: name.
                     37: .TP
                     38: .I day 
                     39: Billing day for the bill.
                     40: .TP
                     41: .I year
                     42: Billing year for the bill.
                     43: .TP
                     44: .I amount
                     45: Total Inter-LATA Toll Charges, including taxes (note that this is
                     46: not quite the same as section 1 of the form\(emit's just the total
                     47: amount as it appears on the bill).
                     48: .TP
                     49: .I exclusions
                     50: Total non-eligible charges as defined in section 2 of the form.  The
                     51: simplest way to compute this is to add the actual charges for all
                     52: ineligible calls.
                     53: .PP
                     54: By default, the information for filling in the form is gleaned from 
                     55: the file
                     56: .B $HOME/.tdc.
                     57: If this file does not exist,
                     58: .B tdc
                     59: will prompt you for the name of an alternate
                     60: .B tdc
                     61: profile residing in your $HOME directory.
                     62: This profile should consist of a number of lines, each giving one
                     63: piece of information for the form.  The format of the lines is
                     64: an item name followed by the information.  The names and the
                     65: expected information are:
                     66: .TP
                     67: .B firstname
                     68: Your first name.
                     69: .TP
                     70: .B homephone
                     71: Your home phone number (the one for which you are vouchering
                     72: the calls).  The format is three numbers, giving area code,
                     73: exchange and line number, with no extra characters like parenthesis
                     74: or dashes.
                     75: .TP
                     76: .B last8cardno
                     77: The last 8 digits of your AT&T Universal Card number.
                     78: .TP
                     79: .B lastname
                     80: Your last name.
                     81: .TP
                     82: .B middleinitial
                     83: Your middle initial.
                     84: .TP
                     85: .B officephone
                     86: Your office phone number; see the description of
                     87: .B homephone
                     88: for the format of this entry.
                     89: .TP
                     90: .B payment
                     91: How you are paid.  This can be
                     92: .B weekly,
                     93: .B bi-weekly,
                     94: or
                     95: .B monthly
                     96: (the default).
                     97: .TP
                     98: .B program
                     99: The program you are in (see item 6 of the form).  The possibilities are
                    100: .B management
                    101: (the default),
                    102: .B occupational1,
                    103: or
                    104: .B occupational2.
                    105: .TP
                    106: .B ssnumber
                    107: Your Social Security number, with internal dashes,
                    108: .B xxx-xx-xxxx .
                    109: .TP
                    110: .B title
                    111: Your title.  The default is
                    112: .B MTS.
                    113: .PP
                    114: Some of these have default values, as indicated.  The others will
                    115: not appear on the form if you don't specify them.  In addition to
                    116: these values there are five others that are location-specific whose
                    117: default values are built into
                    118: .B tdc
                    119: but which may be overridden in
                    120: .B $HOME/.tdc.
                    121: These values are:
                    122: .TP
                    123: .B location1
                    124: .TP
                    125: .B location2
                    126: .TP
                    127: .B location3
                    128: Three lines of address information for your BL location.
                    129: .TP
                    130: .B paycode
                    131: Your Payroll Unit Code Number.
                    132: .TP
                    133: .B tax
                    134: The tax rate (as a percentage) used on your phone bill.  In New Jersey
                    135: this is 9 (for 9%).
                    136: .SH EXAMPLES
                    137: If you prepare TDC forms for more than one person, you should 
                    138: keep each person's data in separate 
                    139: .B .tdc
                    140: files.
                    141: For example, one file might be called 
                    142: .B $HOME/.tdcSmith,
                    143: and another might be called 
                    144: .B $HOME/.tdcJones.
                    145: Then, if
                    146: .B tdc
                    147: cannot find 
                    148: .B $HOME/.tdc,
                    149: it will prompt for the profile to be used:
                    150: .IP
                    151: .EX
                    152: Enter profile suffix: Smith
                    153: .EE
                    154: .PP
                    155: A typical
                    156: .B .tdc
                    157: file might look like this:
                    158: .IP
                    159: .EX
                    160: firstname Joe
                    161: middleinitial Q.
                    162: lastname Schlabotnik
                    163: ssnumber 123-45-6789
                    164: officephone 908 582 0000
                    165: homephone 908 999 0000
                    166: .EE
                    167: .PP
                    168: If you are paid weekly and are in the second occupational category of
                    169: part 6 of the form, you would add these two lines:
                    170: .IP
                    171: .EX
                    172: payment weekly
                    173: program occupational2
                    174: .EE
                    175: .PP
                    176: A typical usage of
                    177: .B tdc
                    178: might be:
                    179: .IP
                    180: .EX
                    181: tdc Dec 26 1992 134.28 15.44 | lp
                    182: .EE
                    183: .SH FILES
                    184: .B $HOME/.tdc*         tdc data profiles

unix.superglobalmegacorp.com

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