diff options
Diffstat (limited to 'static/v10/man7')
43 files changed, 4942 insertions, 0 deletions
diff --git a/static/v10/man7/Makefile b/static/v10/man7/Makefile new file mode 100644 index 00000000..57ec7ecb --- /dev/null +++ b/static/v10/man7/Makefile @@ -0,0 +1,3 @@ +MAN = $(wildcard *.7) + +include ../../mandoc.mk diff --git a/static/v10/man7/apnews.7 b/static/v10/man7/apnews.7 new file mode 100644 index 00000000..52581d6e --- /dev/null +++ b/static/v10/man7/apnews.7 @@ -0,0 +1,196 @@ +.TH APNEWS 7 alice +.CT 1 inst_info +.SH NAME +apnews, ap.keys \- present AP wire stories +.SH SYNOPSIS +.B apnews +[ +.B -f +.I dir +] +[ +.B -r +] +.SH DESCRIPTION +.I Apnews +presents news from the AP wire on a cursor-addressed screen. +The top half of the screen contains 20 +story slugs (two-word labels). +.I Apnews +responds to these commands: +.TP "\w'c file 'u" +.I n +Print story for slug +.IR n ; +page through it by typing newlines. +.TP +.B m +Present more slugs. +.TP +.B \&. +Return to current slug list. +.TP +.B t +Top. Return to first list of slugs +.TP +.BI s " keywords" +Present slugs for stories containing these keywords. +.TP +.B y +Present slugs for stories containing words from the last story read. +.TP +.BI c " file" +Copy. Add story being read to named file or directory. +.TP +.B ? +Print some help. +.PP +To suggest interest, +slugs may be followed by a bracketed number that shows +the average number of pages (up to 5) that readers +have perused. +Option +.B -r +turns this feature off. +.PP +Option +.B -f +directs the attention of +.I apnews +to a specified directory of AP stories, as may be collected by +.FR ap.keys . +.PP +To monitor news automatically, put a file +.F ap.keys +in your home directory. +This file contains instructions marked by +.LR * , +each followed by one or more search lines. +Instructions specify what to capture: +.TP +.B S +whole story +.PD0 +.TP +.B P +first paragraph +.TP +.B H +heading +.PD +.LP +then what to do with it: +.TP +.BI | " command +specifying a command (often mail) to be executed with the +story as standard input +.PD0 +.TP +.BI > " file" +.PD +specifying a file or directory to add the story to; +pathnames are relative to your home directory +.PP +If no instruction is present, the default is +.IP +.L *S | mail yourself +.PP +Search lines may contain: +.IP (1) +a sequence of blank-separated words; these words +must occur in this order +.PD0 +.IP (2) +a sequence of words separated +by commas; these words must appear in the same sentence +.IP (3) +a sequence of words separated by periods; these words may +occur anywhere in the story, but all must appear +.PD +.PP +Combinations +are allowed, e.g.\& +.L " x . y, z" +specifies +.L y +and +.L z +in the same sentence and +.L x +somewhere in the same story. +The character +.L ! +means not, so that +.L !chocolate chip +means +.L chip +not preceded by +.LR chocolate . +Some suffixes are removed; and +capitals are ignored except when entire words are +capitalized. +Thus +.L ERA +and +.L era +are distinguished, but +.L Waters +and +.L waters +are not. +Special `words' specify story types: +.TP +.B #f +flash +.PD0 +.TP +.B #b +bulletin +.TP +.B #u +urgent news +.TP +.B #r +regular news +.TP +.B #d +deferred news +.PD +.SH EXAMPLES +.EX +*S > stuff +bell laboratories +FCC . telephone, regulation +*P | mail joe +#b +AM-NewsDigest +.EE +.SH FILES +.F ap.keys +.br +.F /usr/spool/ap/* +.SH BUGS +.I Apnews +can fail to work well in a +.IR mux (9.1) +window, for two reasons. +.br +(1) The window needs a terminal emulator. +Before invoking +.I apnews, +do +.L "exec term 5620" +(or +.BR 2621 ); +see +.IR term (9.1). +.br +(2) Remote execution needs a transparent connection. +If logged in elsewhere make the connection to the serving machine by doing, for example, +.L "ndcon alice +or +.LR "nrx alice apnews" +(after downloading an emulator, if +necessary); +see +.IR dcon (1). diff --git a/static/v10/man7/ascii.7 b/static/v10/man7/ascii.7 new file mode 100644 index 00000000..ee883958 --- /dev/null +++ b/static/v10/man7/ascii.7 @@ -0,0 +1,37 @@ +.pa 1 +.he 'ASCII (VII)'6/12/72'ASCII (VII)' +.ti 0 +NAME ascii -- map of ASCII character set +.sp +.ti 0 +SYNOPSIS cat___ /usr/pub/ascii______________ +.sp +.ti 0 +DESCRIPTION ascii_____ +is a map of the ASCII character set, to be printed as needed. +It contains: +.in -16 +.nf + +|000 nul|001 soh|002 stx|003 etx|004 eot|005 enq|006 ack|007 bel| +|010 bs |011 ht |012 nl |013 vt |014 np |015 cr |016 so |017 si | +|020 dle|021 dc1|022 dc2|023 dc3|024 dc4|025 nak|026 syn|027 etb| +|030 can|031 em |032 sub|033 esc|034 fs |035 gs |036 rs |037 us | +|040 sp |041 ! |042 " |043 # |044 $ |045 % |046 & |047 ' | +|050 ( |051 ) |052 * |053 + |054 , |055 - |056 . |057 / | +|060 0 |061 1 |062 2 |063 3 |064 4 |065 5 |066 6 |067 7 | +|070 8 |071 9 |072 : |073 ; |074 < |075 = |076 > |077 ? | +|100 @ |101 A |102 B |103 C |104 D |105 E |106 F |107 G | +|110 H |111 I |112 J |113 K |114 L |115 M |116 N |117 O | +|120 P |121 Q |122 R |123 S |124 T |125 U |126 V |127 W | +|130 X |131 Y |132 Z |133 [ |134 \\ |135 ] |136 ^ |137 _ | +|140 ` |141 a |142 b |143 c |144 d |145 e |146 f |147 g | +|150 h |151 i |152 j |153 k |154 l |155 m |156 n |157 o | +|160 p |161 q |162 r |163 s |164 t |165 u |166 v |167 w | +|170 x |171 y |172 z |173 { |174 | |175 } |176 ~ |177 del| + +.fi +.in +16 +.sp +.ti 0 +FILES found in /usr/pub diff --git a/static/v10/man7/av.7 b/static/v10/man7/av.7 new file mode 100644 index 00000000..f3b09855 --- /dev/null +++ b/static/v10/man7/av.7 @@ -0,0 +1,121 @@ +.TH DIST 7 purdy +.CT 1 inst_info +.SH NAME +dist, dme, plan, path, cross \(mi aviation navigation +.SH SYNOPSIS +.B /usr/ken/bin/dist +.I obj obj ... +.PP +.B /usr/ken/bin/dme +.I obj radial dist +.PP +.B /usr/ken/bin/plan +[ +.BI - dist1 +[ +.BI - dist2 +]] +.I obj obj +.PP +.B /usr/ken/bin/path +[ +.BI - dist +] +.I obj obj ... +.PP +.B /usr/ken/bin/cross +[ +.BI - dist +] +.I obj +.SH DESCRIPTION +These routines provide navigation services +using an aviation database. +.I Objects +in the database are of four types: +VORs ending in +.BR .v , +airports ending in +.BR .a , +NDBs ending in +.BR .n , +and intersections ending in +.BR .i . +An ambiguous object specified without +suffix is interpreted in the above order. +.PP +The canonical program in this series, +.IR dist , +prints the magnetic bearing and distance in +nautical miles between a set of two or more specified objects. +The magnetic correction is applied at the first of a pair +of objects, +so the bearing from Morristown to San Diego is +281 degrees while the reverse is 50 degrees. +.I Dist +also prints a frequency for objects. +For VORs and NDBs, +the frequency is obvious. +For airports, +the frequency is sometimes the tower frequency, +sometimes UNICOM and sometimes zero. +Intersections have no frequency. +.PP +.I Dme +prints the latitude and longitude +of a point that is a bearing and distance from an object. +The format printed is the source form of the database of objects. +.I Dme +is used to create new objects for the database \(mi usually intersections. +.PP +.I Plan +finds a shortest distance from one object to another traveling +along a route of VORs. +The optional argument +.I dist1 +is the maximum allowable distance between VORs +en route (default 100 nautical miles) and +.I dist2 +is the maximum allowable distance between the starting +object and the first VOR and the last VOR and terminal object +(default 50). +.PP +.I Path +lists all objects in the database that lie +within +.I dist +(default 10 nautical miles) +of the great circle route between two objects. +If more than two arguments are given, +routes are calculated for each pair of objects. +The list is ordered by distance along the route. +The tangential distance to each object is given +with negative to the left and positive to the right. +.PP +.I Cross +prints all objects in the database +within +.I dist +(default 50 nautical miles) +from the given object. +.SH FILES +.TP /usr/ken/lib/obj +objects +.SH SEE ALSO +.IR avw (7) +.SH BUGS +The database is old and should not be used for navigation purposes. +.br +Frequencies for airports are inconsistent. +.br +.I Plan +uses low power (terminal) VORs when very often these +cannot be tracked from 50 miles. +.br +.I Plan +will cheerfully plan routes through prohibited areas, +over open water and over high mountains. +The only criterion is the distance between objects. +.br +.I Cross +has bugs. diff --git a/static/v10/man7/avw.7 b/static/v10/man7/avw.7 new file mode 100644 index 00000000..f4f3906b --- /dev/null +++ b/static/v10/man7/avw.7 @@ -0,0 +1,127 @@ +.TH AVW 7 purdy +.CT 1 inst_info +.SH NAME +w, fp, ft, fd, rad \(mi aviation weather +.SH SYNOPSIS +.B /usr/ken/bin/w +[ +.I station ... +] +.PP +.B /usr/ken/bin/fp +[ +.I obj ... +] +.PP +.B /usr/ken/bin/ft +[ +.I obj ... +] +.PP +.B /usr/ken/bin/fd +[ +.I obj ... +] +.PP +.B /usr/ken/bin/rad +.SH DESCRIPTION +.I W +looks up each of its arguments in a set of +weather files. +The weather files are constantly maintained by +a daemon that reads the National Weather Service +Wire. +If +.I w +is called with no arguments, +it reads the standard input and looks up each line. +.PP +The active weather files are: +.TP +.B AA +airport name and runway direction and length +.PD0 +.TP +.B NT +NOTAM \(mi Notices to Airmen \(mi special cautions at airports +.TP +.B FT +24-hour terminal forcasts at airports issued three times a day +.TP +.B SA +hourly surface observations taken at airports +.TP +.B FD +daily winds aloft forcasts taken at certain reporting points +.TP +.B FP +daily area forcasts taken at certain reporting points +.TP +.B SD +hourly radar precipitation taken at certain reporting points +.PD +.PP +If +.I w +is given an airport name, +it will print the latest AA, +NT, +FT, +and SA data. +The other files are printed by providing the reporting point name. +In most cases this is a meaningless string of characters that are +supplied by other programs. +.PP +.I Fp +takes a series of navagation stations as arguments; +see +.IR av (A) +for a description of these objects. +If +.I fp +has no argument, +it uses the default +.L here +which specifies Murray Hill, NJ. +If +.I fp +is given one argument, +it will print the name of the nearest +FP (area forecast) station to the argument. +If +.I fp +is given two arguments, +it will print the names of all FP +stations that are nearest to some point +on the great circle route between the objects. +If more than two arguments are given +then the stations are printed for each pair of arguments. +The output of +.I fp +is meant to be piped into +.IR w . +.PP +.I Ft +and +.I fd +behave the same as +.I fp +but print the station names reporting +winds aloft and terminal forcasts respectively. +.PP +.I Rad +creates a radar summary weather map and +prints the map on the laser printer. +.SH FILES +.TF /usr/ken/lib/obj +.TP +.F /usr/weather/* +weather files +.TP +.F /usr/ken/lib/obj +navigation aids +.TP +.F /usr/weather/rd +weather wire daemon +.SH SEE ALSO +.IR av (7) diff --git a/static/v10/man7/cal.7 b/static/v10/man7/cal.7 new file mode 100644 index 00000000..0d154038 --- /dev/null +++ b/static/v10/man7/cal.7 @@ -0,0 +1,33 @@ +.TH CAL 7 +.CT 1 inst_info time_man +.SH NAME +cal \- print calendar +.SH SYNOPSIS +.B cal +[ +.I month +] +.I year +.SH DESCRIPTION +.I Cal +prints a calendar for the specified year. +If a month is also specified, a calendar +just for that month is printed. +.I Year +can be between 1 +and 9999. +The +.I month +is a number between 1 and 12. +The calendar +produced is that for England and her colonies. +.PP +Try September 1752. +.SH BUGS +The year is always considered to start in January even though this +is historically naive. +.br +Beware that +.L "cal 90" +refers to the early Christian era, +not the 20th century. diff --git a/static/v10/man7/dict.7 b/static/v10/man7/dict.7 new file mode 100644 index 00000000..a404e7ad --- /dev/null +++ b/static/v10/man7/dict.7 @@ -0,0 +1,193 @@ +.TH DICT 7 "bowell,murray" +.CT 1 inst_info +.SH NAME +dict \- look up words in English dictionaries +.SH SYNOPSIS +.B dict +[ +.B \-p +] +[ +.I dictionary +[ +.I word +] +] +.SH DESCRIPTION +.I Dict +looks up words in the specified +.I dictionary, +.B webster +by default. +Words are read, one per line from the standard input, and +entries are written on the standard output. +Characters other than letters, digits, and space are ignored. +A single word may be specified in the command. +The options are +.TP +.B \-p +Find all entries of which the specified +.I word +is a prefix. +.TP +.B \-r +Print raw form, including diacriticals, font marks, etc. +Different for each dictionary to which it applies. +.PP +.I Dictionary +is one of +.TF thesaurus +.TP +.B webster +Merriam-Webster Collegiate Dictionary, Seventh Edition, +full text. +No option +.BR -p . +.PD +.TP +.B web7 +Same, words only. +.TP +.BR etym [ ology ] +Inverted index to +.L webster +by root words. +.TP +.B web2 +Merriam-Webster New International Dictionary, Second Edition, +unabridged, words only. +.TP +.B oed +The Oxford New English Dictionary, or OED, +full text. +No option +.BR -p . +.TP +.B oxford +The Oxford Advanced Learner's Dictionary of Contemporary English, +full text. +No +.BR -p . +.TP +.B slang +New Dictionary of American Slang (Harper). +Field identifiers: +.B me +main entry (perhaps flagged +.BR @ ), +.B nu +sense number (also given as +.BI * n *\fR), +.B pr +pronunciation, +.B ps +part of speech, +.B vr +variations +.B la +provenance, +.B df +definition, +.B dx +definition by example, +.B ex +example, +.B ed +editorial note, +.B et +etymology, +.B xr +cross reference, +.B xx +indirect address, +.B sq +sequence number in original text. +.TP +.B names +The Oxford Dictionary of British surnames. +.TP +.B thesaurus +Collins Thesaurus. +.TP +.B thesaurusa +Same, augmented with complete backreferences among words. +.TP +.B places +USGS Gazetteer of populated places in US and possessions, with standard county +code, latitude, longitude, year of listing, altitude (feet), +1980 population, topo sheet code. +For full name search, use thus: +.BR "dict places 'new york, ny'" ; +without state, use prefix search: +.BR "dict -p places 'new york'" . +.TP +towns +A shorter gazetteer (PICADAD) of US populated places with latitude, +longitude, zip code, and population class +(0:0-1000, 1:1000-2500, 2:2500-5000, +3:5000-10,000, 4:10,000-25,000, 5:25,000-50,000, 6:50,000-100,000, +7:100,000-250,000, 8:250,000-500,000, 9:500,000+), and something else. +.TP +.B spell +Word list of +.IR spell (1). +.TP +.BR acro [ nym ] +17000 AT&T acronyms +.TP +anything else +Print list of available dictionaries. +.PP +The dictionaries are copyrighted and must not +be copied without permission, except for +.LR web2 , +.LR spell , +and +.LR acro . +.SH FILES +.TF /usr/spool/town/ustowns* +.TP +.F /usr/dict/* +.RB ( /n/bowell ) +.TP +.F /usr/dict/words +.B spell +or +.BR web7 , +depending on machine +.TP +.F /usr/dict/oed +.RB ( /n/kwee ) +.TP +.F /usr/lib/dict/* +.TP +.F /usr1/maps/usplaces +.RB ( /n/bowell ) +.TP +.F /usr/spool/town/ustowns* +.RB ( /n/alice ) +.SH SEE ALSO +.IR look (1), +.IR town (7) +.SH BUGS +In +.BR webster , +.BR web7 , +and +.BR pron , +diacriticals are done right \- +by overstrikes \- which means they disappear on most screen terminals. +.br +In +.BR towns , +all data are lower case; +missing zip codes look like normal codes ending in `000'. +Latitude and longitude denote the center of population of the +containing political entity; unincorporated places are spotted +at the county center. +.br +In +.BR slang , +some entries contain extra trash; option +.B -p +helps overcome the trouble. diff --git a/static/v10/man7/dkname.7 b/static/v10/man7/dkname.7 new file mode 100644 index 00000000..c4592c1e --- /dev/null +++ b/static/v10/man7/dkname.7 @@ -0,0 +1,16 @@ +.TH DKNAME 7 +.CT 1 comm_mach inst_info +.SH NAME +dkname \(mi map system name to Datakit address +.SH SYNOPSIS +.B dkname +.I sysname ... +.SH DESCRIPTION +.I Dkname +looks up machine names and prints the corresponding full +Datakit address on the standard output. +The addresses are not necessarily printed in the same order as the arguments. +The addresses are obtained by the first possible match in the file +.FR /usr/lib/uucp/Systems.dk . +.SH FILES +.F /usr/lib/uucp/Systems.dk diff --git a/static/v10/man7/dpd.7 b/static/v10/man7/dpd.7 new file mode 100644 index 00000000..41a0f6fb --- /dev/null +++ b/static/v10/man7/dpd.7 @@ -0,0 +1,75 @@ +.pa 1 +.he 'DPD (VII)'3/15/72'DPD (VII)' +.ti 0 +NAME dpd -- spawn data phone daemon +.sp +.ti 0 +SYNOPSIS /etc/dpd________ +.sp +.ti 0 +DESCRIPTION dpd___ +is the 201 data phone daemon. +It is designed to submit jobs to +the Honeywell 6070 computer via the gerts +interface. +.sp +dpd___ uses the directory /usr/dpd________. +The file lock____ in that directory is used +to prevent two daemons from becoming active. +After the daemon has successfully set the lock, +it forks and the main path exits, thus +spawning the daemon. +/usr/dpd________ is scanned for any file +beginning with df__. +Each such file is submitted as a job. +Each line of a job file must begin with a key +character to specify what to do with the remainder +of the line +.sp +.in +3 +S_ directs dpd to generate a unique snumb card. +This card is generated by incrementing the first +word of the file /usr/dpd/snumb______________ +and converting that to decimal concatenated with +the station ID. +.sp +L_ specifies that the remainder of the line is to +be sent as a literal. +.sp +B_ specifies that the rest of the line +is a file name. That file is to +be sent as binary cards. +.sp +F_ is the same as B_ except a form feed is prepended to the file. +.sp +U_ specifies that the rest of the line +is a file name. +After the job has been transmitted, +the file is unlinked. +.sp +.in -3 +Any error encountered will cause the daemon to +drop the call, wait up to 20 minutes and start over. +This means that an improperly constructed +df__ file may cause the same job to be submitted +every 20 minutes. +.sp +While waiting, the +daemon checks to +see that the lock____ file still exists. +If the lock____ is gone, the +daemon will exit. +.sp +.ti 0 +FILES /dev/dn0, +/dev/dp0, +/usr/dpd/* +.sp +.ti 0 +SEE ALSO opr(I) +.sp +.ti 0 +DIAGNOSTICS -- +.sp +.ti 0 +BUGS -- diff --git a/static/v10/man7/getty.7 b/static/v10/man7/getty.7 new file mode 100644 index 00000000..358aad5e --- /dev/null +++ b/static/v10/man7/getty.7 @@ -0,0 +1,75 @@ +.pa 1 +.he '12/11/72''GETTY (VII)' +.tr | +.ti 0 +.nf +NAME getty -- set typewriter mode and get user's name +.fi +.sp +.ti 0 +SYNOPSIS /etc/getty +.sp +.ti 0 +DESCRIPTION +.br +.in 8 +getty_____ +is invoked +by init (VII) +immediately after a typewriter is opened +following a dial-in. +The user's login name is read and the login(I) command +is called with this name as an argument. +While reading this name getty_____ +attempts to adapt the system to the speed and type of terminal +being used. +.sp +getty_____ initially sets the speed of the interface to 150 baud, +specifies that raw mode is to be used (break on every character), +that echo is to be suppressed, and either parity +allowed. +It types the "login:" message +(which includes the characters which put the 37 Teletype +terminal into full-duplex and unlock its keyboard). +Then the user's name is read, a character at a time. +If a null character is received, it is assumed to be the result +of the user pushing the "break" ("interrupt") key. +The speed is then +changed to 300 baud and the "login:" is typed again, +this time with the appropriate +sequence which puts a GE TermiNet 300 into full-duplex. +This sequence is acceptable to other 300 baud terminals also. +If a subsequent null character is received, +the speed is changed again. +The general approach is to cycle through a set of speeds in +response to null characters caused by breaks. +The sequence at this installation is 150, 300, and 134.5 baud. +.sp +Detection of IBM|2741s is accomplished while the speed is +set to 150 baud. +The user sends a 2741 style "eot" +character by pushing the attention key or by typing return; +at 150 baud, this character looks like the ascii "~" (174988). +Upon receipt of the "eot", the system is set to operate 2741s +and a "login: " message is typed. + +The user's name is terminated by a new-line or +carriage-return character. +The latter results in the system being set to +to treat carriage returns appropriately (see stty(II)). + +The user's name is scanned to see if +it contains any lower-case alphabetic characters; if not, +and if the name is nonempty, the +system is told to map any future upper-case characters +into the corresponding lower-case characters. +Thus UNIX is usable from upper-case-only terminals. + +Finally, login is called with the user's name as argument. +.sp +.in 16 +.ti 0 +FILES -- +.sp +.ti 0 +SEE ALSO init(VII), login(I), stty(II) diff --git a/static/v10/man7/glob.7 b/static/v10/man7/glob.7 new file mode 100644 index 00000000..b1583557 --- /dev/null +++ b/static/v10/man7/glob.7 @@ -0,0 +1,36 @@ +.pa 1 +.he 'GLOB (VII)'6/15/72'GLOB (VII)' +.ti 0 +NAME glob -- generate command arguments +.sp +.ti 0 +SYNOPSIS /etc/glob +.sp +.ti 0 +DESCRIPTION glob____ +is used to expand arguments to the shell containing "*", '[', or +"?". It is passed the argument list +containing the metacharacters; glob____ +expands the list and calls the command itself. +The actions of glob____ are detailed in +the Shell writeup. +.sp +.ti 0 +FILES found in /etc/glob +.sp +.ti 0 +SEE ALSO sh(I) +.sp +.ti 0 +DIAGNOSTICS "No match", "No command", "No directory" +.sp +.ti 0 +BUGS If any of +'*', '[', or '?' occurs both quoted and unquoted in the +original command line, +even the quoted metacharacters are expanded. + +glob____ gives the "No match" diagnostic only if +no arguments at all result. +This is never the case if there is any +argument without a metacharacter. diff --git a/static/v10/man7/greek.7 b/static/v10/man7/greek.7 new file mode 100644 index 00000000..cd409018 --- /dev/null +++ b/static/v10/man7/greek.7 @@ -0,0 +1,42 @@ +.pa 1 +.he 'GREEK (VII)'10/31/72'GREEK (VII)' +.ti 0 +NAME greek -- graphics for extended ascii type box +.sp +.ti 0 +SYNOPSIS cat___ /usr/pub/greek______________ +.sp +.ti 0 +DESCRIPTION greek_____ +gives the mapping +from ascii +to the "shift out" graphics in effect between SO and SI +on model 37 teletypes +with a 128-character type box. +It contains: + +.nf +alpha A A | beta B B | gamma \\ \\ +GAMMA G G | delta D D | DELTA W W +epsilon S S | zeta Q Q | eta N N +theta T T | THETA O O | lambda L L +LAMBDA E E | mu M M | nu @ @ +xi X X | pi J J | PI P P +rho K K | sigma Y Y | SIGMA R R +tau I I | phi U U | PHI F F +psi V V | PSI H H | omega C C +OMEGA Z Z | nabla [ [ | not _ _ +partial ] ] | integral ^ ^ | +.fi +.sp +.ti 0 +FILES -- +.sp +.ti 0 +SEE ALSO ascii (VII) +.sp +.ti 0 +DIAGNOSTICS -- +.sp +.ti 0 +BUGS -- diff --git a/static/v10/man7/hier.7 b/static/v10/man7/hier.7 new file mode 100644 index 00000000..063a83d0 --- /dev/null +++ b/static/v10/man7/hier.7 @@ -0,0 +1,517 @@ +.TH HIER 7 +.SH NAME +hier \- file system hierarchy +.SH DESCRIPTION +The following outline gives a quick tour through +a representative directory hierarchy. +.na +.nh +.IP / +root +.PD 0 +.IP /vmunix +the kernel binary (UNIX itself) +.IP /lost+found +directory for connecting detached files for +.IR fsck (8) +.IP /dev/ +devices (4) +.RS +.IP console +main console, +.IR ttyld (4) +.IP tty* +terminals, +.IR ttyld (4) +.IP ra* +disks, +.IR ra (4) +.IP rra* +raw disks, +.IR ra (4) +.IP ... +.RE +.IP /bin/ +utility programs, cf /usr/bin/ (1) +.RS +.IP as +assembler +.IP cc +C compiler executive, +cf /lib/ccom, /lib/cpp, /lib/c2 +.IP csh +C shell +.IP ... +.RE +.IP /lib/ +object libraries and other stuff, cf /usr/lib/ +.RS +.IP libc.a +system calls, standard I/O, etc. (2,3,3S) +.IP ... +.IP ccom +C compiler proper +.IP cpp +C preprocessor +.IP c2 +C code improver +.IP ... +.RE +.IP /etc/ +essential data and maintenance utilities; +sect (8) +.RS +.IP dump +dump program +.IR dump (8) +.IP passwd +password file, +.IR passwd (5) +.IP group +group file, +.IR group (5) +.IP motd +message of the day, +.IR login (8) +.IP whoami +system name, +.IR uname (3) +.IP termcap +description of terminal capabilities, +.IR termcap (5) +.IP ttytype +table of what kind of terminal is on each port, +.IR ttytype (5) +.IP mtab +mounted file table, +.IR mtab (5) +.IP dumpdates +dump history, +.IR dump (8) +.IP fstab +file system configurtion table +.IR fstab (5) +.IP ttys +properties of terminals, +.IR ttys (5) +.IP getty +part of +.IR login , +.IR getty (8) +.IP init +the parent of all processes, +.IR init (8) +.IP rc +shell program to bring the system up +.IP cron +the clock daemon, +.IR cron (8) +.IP mount +.IR mount (8) +.IP wall +.IR wall (1) +.IP ... +.RE +.IP /tmp/ +temporary files, usually on a fast device, cf /usr/tmp/ +.RS +.IP e* +used by +.IR ed (1) +.IP ctm* +used by +.IR cc (1) +.IP ... +.RE +.IP /usr/ +general-pupose directory, usually a mounted file system +.RS +.IP adm/ +administrative information +.RS +.IP wtmp +login history, +.IR utmp (5) +.IP messages +hardware error messages +.IP tracct +phototypesetter accounting, +.IR troff (1) +.IP lpacct +line printer accounting +.IR lpr (1) +.RE +.RE +.IP /usr\t/bin +.RS +utility programs, to keep /bin/ small +.IP tmp/ +temporaries, to keep /tmp/ small +.RS +.IP stm* +used by +.IR sort (1) +.IP raster +used by +.IR plot (1) +.RE +.IP dict/ +word lists, etc. +.RS +.IP words +principal word list, used by +.IR look (1) +.IP spellhist +history file for +.IR spell (1) +.RE +.IP games/ +.RS +.IP hangman +.IP lib/ +library of stuff for the games +.RS +.IP quiz.k/ +what +.IR quiz (6) +knows +.RS +.IP index +category index +.IP africa +countries and capitals +.IP ... +.RE +.IP ... +.RE +.IP ... +.RE +.IP include/ +standard #include files +.RS +.IP a.out.h +object file layout, +.IR a.out (5) +.IP stdio.h +standard I/O, +.IR stdio (3) +.IP math.h +(3M) +.IP ... +.IP sys/ +system-defined layouts, cf /usr/sys/h +.RE +.IP lib/ +object libraries and stuff, to keep /lib/ small +.RS +.IP atrun +scheduler for +.IR at (1) +.IP lint/ +utility files for lint +.RS +.IP lint[12] +subprocesses for +.IR lint (1) +.IP llib-lc +dummy declarations for /lib/libc.a, used by +.IR lint (1) +.IP llib-lm +dummy declarations for /lib/libc.m +.IP ... +.RE +.IP struct/ +passes of +.IR struct (1) +.IP ... +.IP tmac/ +macros for +.IR troff (1) +.RS +.IP tmac.an +macros for +.IR man (7) +.IP tmac.s +macros for +.IR ms (7) +.IP ... +.RE +.IP font/ +fonts for +.IR troff (1) +.RS +.IP ftR +Times Roman +.IP ftB +Times Bold +.IP ... +.RE +.IP uucp/ +programs and data for +.IR uucp (1) +.RS +.IP L.sys +remote system names and numbers +.IP uucico +the real copy program +.IP ... +.RE +.IP units +conversion tables for +.IR units (7) +.IP eign +list of English words to be ignored by +.IR ptx (1) +.RE +.RE +.br +.ne 5 +.IP /usr/\tman/ +.RS +volume 1 of this manual, +.IR man (1) +.RS +.IP man0/ +general +.RS +.IP intro +introduction to volume 1, +.IR ms (7) +format +.IP xx +template for manual page +.RE +.IP man1/ +chapter 1 +.RS +.IP as.1 +.IP mount.1m +.IP ... +.RE +.IP ... +.IP cat1/ +preformatted pages for section 1 +.IP ... +.RE +.IP spool/ +delayed execution files +.RS +.IP at/ +used by +.IR at (1) +.IP lpd/ +used by +.IR lpr (1) +.RS +.IP lock +present when line printer is active +.IP cf* +copy of file to be printed, if necessary +.IP df* +daemon control file, +.IR lpd (8) +.IP tf* +transient control file, while +.I lpr +is working +.RE +.IP uucp/ +work files and staging area for +.IR uucp (1) +.RS +.IP LOGFILE +summary log +.IP LOG.* +log file for one transaction +.RE +.IP mail/ +mailboxes for +.IR mail (1) +.RS +.TP +.I name +mail file for user +.I name +.TP +.IR name .lock +lock file while +.I name +is receiving mail +.RE +.IP secretmail/ +like +.IR mail / +.IP uucp/ +work files and staging area for +.IR uucp (1) +.RS +.IP LOGFILE +summary log +.IP LOG.* +log file for one transaction +.RE +.RE +.TP +.I wd +initial working directory of a user, +typically +.I wd +is the user's login name +.RS +.TP +.BR . profile +set environment for +.IR sh (1), +.IR environ (5) +.TP +calendar +user's datebook for +.IR calendar (1) +.RE +.IP doc/ +papers, mostly in volume 2 of this manual, typically in +.IR ms (7) +format +.RS +.IP as/ +assembler manual +.IP c +C manual +.IP ... +.RE +.RE +.RE +.IP /usr/\tsrc/ +.RS +.IP +source programs for utilities, etc. +.RS +.IP cmd/ +source of commands +.RS +.IP as/ +assembler +.IP ar.c +source for +.IR ar (1) +.IP ... +.IP troff/ +source for +.I nroff +and +.IR troff (1) +.RS +.IP font/ +source for font tables, /usr/lib/font/ +.RS +.IP ftR.c +Roman +.IP ... +.RE +.IP term/ +terminal characteristics tables, /usr/lib/term/ +.RS +.IP tab300.c +DASI 300 +.IP ... +.RE +.IP ... +.RE +.RE +.IP games/ +source for /usr/games +.IP libc/ +source for functions in /lib/libc.a +.RS +.IP crt/ +C runtime support +.IP csu/ +startup and wrapup routines needed with every C program +.RS +.IP crt0.s +regular startup +.IP mcrt0.s +modified startup for +.I cc \-p +.RE +.IP sys/ +system calls (2) +.RS +.IP access.s +.IP alarm.s +.IP ... +.RE +.IP stdio/ +standard I/O functions (3S) +.RS +.IP fgets.c +.IP fopen.c +.IP ... +.RE +.IP gen/ +other functions in (3) +.RS +.IP abs.c +.IP ... +.RE +.RE +.IP local/ +source which isn't normally distributed +.IP new/ +source for new versions of commands and library routines +.IP old/ +source for old versions of commands and library routines +.IP sys/ +system source +.RS +.IP h/ +header (include) files +.RS +.IP acct.h +.IR acct (5) +.IP stat.h +.IR stat (2) +.IP ... +.RE +.IP sys/ +system source proper +.RS +.IP main.c +.IP pipe.c +.IP sysent.c +system entry points +.RE +.RE +.RE +.IP ucb/ +binaries of programs developed at UCB +.RS +.IP ... +.IP edit +editor for beginners +.IP ex +command editor for experienced users +.IP ... +.IP mail +mail reading/sending subsystem +.IP man +on line documentation +.IP ... +.IP pi +Pascal translator +.IP px +Pascal interpreter +.IP ... +.IP vi +visual editor +.RE +.RE +.ad +.SH SEE ALSO +.IR ls (1), +.IR du (1), +.IR icheck (8), +.IR find (1), +.IR grep (1) +.SH BUGS +The position of files is subject to change without notice. diff --git a/static/v10/man7/init.7 b/static/v10/man7/init.7 new file mode 100644 index 00000000..70c6f221 --- /dev/null +++ b/static/v10/man7/init.7 @@ -0,0 +1,75 @@ +.pa 1 +.he 'INIT (VII)'6/15/72'INIT (VII)' +.ti 0 +NAME init -- process control initialization +.sp +.ti 0 +SYNOPSIS /etc/init +.sp +.ti 0 +DESCRIPTION +.in 8 +init____ +is invoked inside UNIX as the last step in the boot procedure. +Generally its role is to create a process for each +typewriter on which a user may log in. + +First, init____ checks +to see if the console switches contain 173030. +(This number is likely to vary between +systems.) +If so, the console typewriter tty___ is opened for reading +and writing and the shell is invoked immediately. +This feature is used to bring up a test system, or one +which does not contain DC-11 communications interfaces. +When the system is brought up in this way, the getty_____ +and login_____ routines mentioned below and described elsewhere are not needed. + +Otherwise, init____ does some housekeeping: the mode of +each DECtape file is changed to 17 (in case the system +crashed during a tap___ command); +directory /usr is mounted +on the RK0 disk; +directory /sys is mounted on the RK1 disk. +Also a data-phone daemon +is spawned to restart any jobs being sent. + +Then init____ forks several times to create a process +for each typewriter mentioned in an internal table. +Each of these processes opens the appropriate typewriter +for reading and writing. These channels thus +receive file descriptors 0 and 1, the standard input and +output. +Opening the typewriter will usually involve a delay, +since the open____ is not completed until someone +is dialled in (and carrier established) on the channel. +Then the process executes the program /etc___/getty_____ +(q.v.). +getty_____ will read the user's name and invoke login_____ (q.v.) +to log in the user and execute the shell. + +Ultimately the shell will terminate +because of an end-of-file either +typed explicitly or generated as a result of hanging up. +The main path of init____, which has been waiting +for such an event, +wakes up and removes the appropriate entry from the +file utmp____, which records current users, and +makes an entry in wtmp____, which maintains a history +of logins and logouts. +Then the appropriate typewriter is reopened and getty_____ +reinvoked. +.sp +.in 16 +.ti 0 +FILES /dev/tap?, +/dev/tty, /dev/tty?, /tmp/utmp, /tmp/wtmp +.sp +.ti 0 +SEE ALSO login(I), login(VII), getty(VII), sh(I), dpd(VII) +.sp +.ti 0 +DIAGNOSTICS none possible +.sp +.ti 0 +BUGS none possible diff --git a/static/v10/man7/kbd.7 b/static/v10/man7/kbd.7 new file mode 100644 index 00000000..5c5b7f7a --- /dev/null +++ b/static/v10/man7/kbd.7 @@ -0,0 +1,44 @@ +.pa 1 +.he '6/15/72''KBD (VII)' +.ti 0 +NAME kbd -- keyboard map +.sp +.ti 0 +SYNOPSIS cat /usr/pub/kbd +.sp +.ti 0 +DESCRIPTION kbd___ +contains a map to the keyboard for model 37 Teletype +terminals with the extended character set feature. +If kbd___ +is printed on such a terminal, the following will appear: + +.nf +.in -2 +<[1234567890-_]^\\ >qwertyuiop@ asdfghjkl;: zxcvbnm,./ + +<[1234567890-_]^\\ > @ ;: ,./ + + +<{!"#$%&'() =_}~| >QWERTYUIOP` ASDFGHJKL+* ZXCVBNM,.? + +<{ !"#$%&'() =_} ~ | >QWERTYUIOP` ASDFGHJKL+* ZXCVBNM,.? + + +.fi +.sp +.in +2 +.ti 0 +FILES -- +.sp +.ti 0 +SEE ALSO -- +.sp +.ti 0 +DIAGNOSTICS -- +.sp +.ti 0 +BUGS -- +.sp +.ti 0 +OWNER jfo diff --git a/static/v10/man7/library.7 b/static/v10/man7/library.7 new file mode 100644 index 00000000..50b37db6 --- /dev/null +++ b/static/v10/man7/library.7 @@ -0,0 +1,126 @@ +.TH LIBRARY 7 +.CT 1 inst_info +.SH NAME +library, bellcat \- bell labs library services +.SH SYNOPSIS +.B library +[ +.I option ... +] [ +.I item ... +] +.PP +.B bellcat +[ +.B -q +] +[ +.I database +] +.SH DESCRIPTION +.I Library +mails orders to the Bell Labs library network for books, technical +reports, etc. +Its use is self-explanatory. +.PP +A long response may be inserted with +.B ~e +or +.B ~r +as in +.IR Mail (A). +Interaction may be forestalled by answering questions on the command line +(see example) and in a personal identity file, named in +environment variable +.B LIBFILE +.RB ( .lib +by default), +which contains one or more lines like these: +.IP +.B ID: +PAN or SSN +.br +.B LIBNAME: +last name +.br +.B LIBLOG: +log file, readable with +.B mail -f +.br +.B LIBCNTL: +concatenated search control codes: +.B a +acknowledge, +.BI m number +max on retrieved items +.br +.B LIBLOCAL: +interaction control code: +.B x +brief prompts +.LP +Most +.B LIBFILE +items may be entered as environment variables by the same names. +.PP +.I Bellcat +places a call to on-line library databases. +Once entered, +.I bellcat +is self-explanatory. +to exit. +Option +.B -q +gets a `quick search', which uses no special terminal features +and does not offer help. +.PP +Some of the databases are +.TP +.B books +(default) +.PD 0 +.TP +.B journals +.TP +.B released +released papers by Bell Labs authors +.TP +.B tech_reports +non-AT&T technical reports +.TP +.I xxx +unknown name causes a list of databases to be printed +.PD +.PP +The databases of +.I Bellcat +and more are available through the LINUS +service of the library network. +You may use the +.I library +command to sign up for LINUS. +.SH EXAMPLES +.TP +.B library -1 123456-851234-56tm +Order a technical memorandum, giving answer 1 for kind of query and +specifying a document number. +.TP +.B library -4 -p waldstein, r k +Consult the people file. +.SH FILES +.F $HOME/.lib +.br +.F /usr/lib/bellcat +.SH BUGS +Except under option +.BR -q , +.I bellcat +requires a native-mode Teletype 5620 or a (possibly simulated) +HP2621 terminal. +Under +.IR mux (9.1) +.I bellcat +invokes a simulator if necessary. +This introduces an extra level of shell, which can +can be avoided thus: +.LR "exec bellcat" . diff --git a/static/v10/man7/login.7 b/static/v10/man7/login.7 new file mode 100644 index 00000000..bb221e5c --- /dev/null +++ b/static/v10/man7/login.7 @@ -0,0 +1,101 @@ +.pa 1 +.he '6/15/72''LOGIN, LOGOUT (VII)' +.ti 0 +NAME logging in and logging out +.sp +.ti 0 +SYNOPSIS -- +.sp +.ti 0 +DESCRIPTION UNIX +must be called from an appropriate terminal. +UNIX supports ASCII terminals typified by the Teletype M37, +the GE Terminet 300, the Memorex 1240, and various +graphical terminals on the one hand, and IBM 2741-type +terminals on the other. + +Not all installations support +all these terminals. +Often the M33/35 Teletype is supported instead +of the 2741. +Depending on the hardware installed, most +terminals operating at 110, 134.5, 150, or 300 baud can +be accommodated. + +To use UNIX, +it is also necessary to have +a valid UNIX user ID and (if desired) password. These +may be obtained, together with the telephone number, from the system administrators. + +The same telephone number +serves terminals operating at all the standard speeds. +The discussion below applies when the standard +speeds of 134.5 (2741's) +150 (TTY 37's) and 300 (Terminet 300's) +are available. + +When a connection is established via a 150-baud terminal +(e.g. TTY 37) UNIX types out "login:"; you respond with +your user name, and, if requested, with a password. +(The printer is turned off while you type the +password.) +If the login was successful, the "@" character +is typed by the Shell to indicate +login is complete and commands may be issued. +A message of the day may be typed if there are any announcements. +Also, if there is a file called "mailbox", you are notified +that someone has sent you mail. +(See the mail____ command.) + +From a 300-baud terminal, the procedure is slightly different. +Such terminals often have a full-duplex switch, which should +be turned on (or conversely, half-duplex should be turned off). +When a connection with UNIX is established, a few garbage +characters are typed (these are the "login:" message at the wrong speed). +You should depress the "break" key; +this is a speed-independent signal to UNIX that a 300-baud +terminal is in use. It will type "login:" (at the correct speed +this time) and from then on the procedure is the same as described +above. + +From a 2741, no message will appear. +After the telephone connection is established, +press the "ATTN" button. +UNIX should type "login:" as described above. +If the greeting does not appear after a few seconds, +hang up and try again; something has gone wrong. +If a password is required, +the printer cannot be turned off, so it will appear on the paper +when you type it. + +For more information, consult +getty(VII), which discusses the login sequence in more +detail, and tty0(IV), which discusses typewriter I/O. + +Logging out is simple by comparison (in fact, sometimes too simple). +Simply generate an end-of-file at Shell level by using +the EOT character; the "login:" message will appear again to +indicate that you may log in again. + +It is also possible to log out simply by hanging up the terminal; +this simulates an end-of-file on the typewriter. +.sp +.ti 0 +FILES /etc/motd +may contain a message-of-the-day. +.sp +.ti 0 +SEE ALSO init(VII), getty(VII), tty0(IV) +.sp +.ti 0 +DIAGNOSTICS -- +.sp +.ti 0 +BUGS Hanging up +on programs which never read +the typewriter or which ignore end-of-files +is very dangerous; in the worst cases, +the programs can only be halted by restarting the system. +.sp +.ti 0 +OWNER ken, dmr diff --git a/static/v10/man7/map.7 b/static/v10/man7/map.7 new file mode 100644 index 00000000..879bfb73 --- /dev/null +++ b/static/v10/man7/map.7 @@ -0,0 +1,451 @@ +.TH MAP 7 +.CT 1 inst_info +.SH NAME +map \- draw maps on various projections +.SH SYNOPSIS +.B map +.I projection +[ +.I param ... +] +[ +.I option ... +] +.PP +.SH DESCRIPTION +.I Map +prepares on the standard output a +map suitable for display by any +plotting filter described in +.IR plot (1). +A menu of projections is produced in response to an unknown +.IR projection . +For the meanings of +.I params +pertinent to particular projections +see +.IR proj (3). +.PP +The default data for +.I map +are world shorelines. +Option +.B -f +accesses the higher-resolution World Data Bank II. +.TP +.BR -f " [ \fIfeature\fR ... ]" +Features are ranked 1 (default) to 4 from major to minor. +Higher-numbered ranks include all lower-numbered ones. +Features are +.RS +.TF country[1-3] +.TP +.BR shore [ 1 - 4 ] +seacoasts, lakes, and islands; in the absence of +.BR -m , +option +.B -f +automatically includes +.B shore1 +.TP +.BR ilake [ 1 - 2 ] +intermittent lakes +.TP +.BR river [ 1 - 4 ] +rivers +.TP +.BR iriver [ 1 - 3 ] +intermittent rivers +.TP +.BR canal [ 1 - 3 ] +.BR 3 =irrigation +canals +.TP +.BR glacier +.TP +.BR iceshelf [ 12 ] +.TP +.BR reef +.TP +.BR saltpan [ 12 ] +.TP +.BR country [ 1 - 3 ] +.BR 2 =disputed +boundaries, +.BR 3 =indefinite +boundaries +.TP +.BR state +states and provinces (US and Canada only) +.PD +.RE +.PP +In other options +coordinates are in degrees, with north latitude +and west longitude counted as positive. +.TP 0 +.BI -l " S N E W" +Set the southern and northern latitude +and the eastern and western longitude limits. +Missing arguments are filled out from the list +\-90, 90, \-180, 180. +.TP +.BI -k " S N E W +Set the scale as if for a map with limits +.B -l +.I "S N E W" +and no +.B -w +option. +.TP +.BI -o " lat lon rot" +Orient the map in a nonstandard position. +Imagine a transparent gridded sphere around the globe. +Turn the overlay about the North Pole +so that the Prime Meridian (longitude 0) +of the overlay coincides with meridian +.I lon +on the globe. +Then tilt the North Pole of the +overlay along its Prime Meridian to latitude +.I lat +on the globe. +Finally again turn the +overlay about its `North Pole' so +that its Prime Meridian coincides with the previous position +of meridian +.IR rot . +Project the map in +the standard form appropriate to the overlay, but presenting +information from the underlying globe. +Missing arguments are filled out from the list +90, 0, 0. +In the absence of +.BR \-o , +the orientation is 90, 0, +.I m, +where +.I m +is the middle of the longitude range. +.TP +.BI -w " S N E W" +Window the map by the specified latitudes +and longitudes in the tilted, rotated coordinate system. +Missing arguments are filled out from the list \-90, 90, \-180, 180. +(It is wise to give an encompassing +.B -l +option with +.BR -w . +Otherwise for small windows computing time +varies inversely with area!) +.TP +.BI -d " n" +For speed, plot only every +.IR n th +point. +.TP +.B -r +Reverse left and right +(good for star charts and inside-out views). +.br +.ns +.TP +.B -s1 +.br +.ns +.TP +.B -s2 +Superpose. Outputs for a +.B -s1 +map (no closing) and a +.B -s2 +map (no opening) may be concatenated. +.TP +.BI -g " dlat dlon res" +Grid spacings are +.I dlat, +.I dlon. +Zero spacing means no grid. +Missing +.I dlat +is taken to be zero. +Missing +.I dlon +is taken the same as +.IR dlat . +Grid lines are drawn to a resolution of +.I res +(2\(de or less by default). +In the absence of +.BR \-g , +grid spacing is 10\(de. +.TP +.BI -p " lat lon extent" +Position the point +.I lat, lon +at the center of a square plotting area. +Scale the map so that a side of the square is +.I extent +times the size of one degree of latitude +at the center. +By default maps are scaled and positioned +to fit within the plotting area. +An +.I extent +overrides option +.BR -k . +.TP +.BI -c " x y rot" +After all other positioning and scaling operations, +rotate the image +.I rot +degrees counterclockwise about the center +and move the center to position +.I x, y, +of the plotting area, whose nominal extent is +.RI \-1 \(<= x \(<= 1, +.RI \-1 \(<= y \(<= 1. +The map is clipped to this area. +Missing arguments are taken to be 0. +.TP +.BR -m " [ \fIfile\fP ... ]" +Use +map data from named files. +If no files are named, omit map data. +Files that cannot be found directly are looked up +a standard directory, which contains, in addition to the +data for +.BR -f , +.RS +.LP +.TF counties +.TP +.B world +World Data Bank I from CIA (default) +.TP +.B states +US map from Census Bureau +.TP +.B counties +US map from Census Bureau +.PD +.RE +.IP +The environment variables +.B MAP +and +.B MAPDIR +change the default +map and default directory. +.TP +.BI -b " \fR[ \fPlat1 lon1 lat2 lon2 \fR... ]" +Suppress the drawing of the normal boundary +(defined by options +.BR -l +and +.BR -w ). +Coordinates, if present, define the vertices of a +polygon to which the map is clipped. +If only two vertices are given, they are taken to be the +diagonal of a rectangle. +To draw the polygon, give its vertices as a +.B -u +track. +.TP +.BI -t " file ..." +The arguments name ASCII files that +contain lists of points, +given as latitude-longitude pairs in degrees. +If the first file is named +.LR - , +the standard input is taken instead. +The points of each list are plotted as connected `tracks'. +.IP +Points in a track file may be followed by label strings. +A label breaks the track. +A label may be prefixed by +\f5"\fR, +.LR : , +or +.L ! +and is terminated by a newline. +An unprefixed string or a string prefixed with +.L +" +is displayed at the designated point. +The first word of a +.L : +or +.L ! +string names a special symbol (see option +.BR -y ). +An optional numerical second word is a scale factor +for the size of the symbol, 1 by default. +A +.L : +symbol is aligned with its top to the north; a +.L ! +symbol is aligned vertically on the page. +.TP +.BI -u " file ..." +Same as +.BR -t , +except the tracks are +unbroken lines. +.RB ( -t +tracks are dot-dash lines.) +.TP +.BI -y " file +The +.I file +contains +.IR plot (5)-style +data for +.L : +or +.L ! +labels in +.B -t +or +.B -u +files. +Each symbol is defined by a comment +.BI : name +then a sequence of +.L m +and +.L v +commands. +Coordinates (0,0) fall on the plotting point. +Default scaling is as if the nominal plotting range were +.LR "ra -1 -1 1 1" ; +.L ra +commands in +.I file +change the scaling. +.SH EXAMPLES +.TP +.L +map perspective 1.025 -o 40.75 74 +A view looking down on New York from 100 miles +(0.025 of the 4000-mile earth radius). +The job can be done faster by limiting the map so as not to `plot' +the invisible part of the world: +.LR "map perspective 1.025 -o 40.75 74 -l 20 60 30 100". +A circular border can be forced by adding option +.LR "-w 77.33" . +(Latitude 77.33\(de falls just inside a polar cap of +opening angle arccos(1/1.025) = 12.6804\(de.) +.TP +.L +map mercator -o 49.25 -106 180 +A map whose `equator' is a great circle pasing east-west +through New York. +The pole of the map is placed 90\(de away (40.75+49.25=90) +on the +other side of the earth. +A 180\(de twist around the pole of the map arranges that the +Prime Meridian of the map runs from the pole of the +map over the North Pole to New York +instead of down the back side of the earth. +The same effect can be had from +.L +map mercator -o 130.75 74 +.TP +.L +map albers 28 45 -l 20 50 60 130 -m states +A customary curved-latitude map of the United States. +.TP +.L +map albers 28 45 -l 20 50 60 130 -y yfile -t tfile +An example of tracks, labels, and symbols. +Arrows at New York and Miami are 8% and 12% +as long as the map is wide. +The contents of +.L yfile +and +.L tfile +are +.nf +.ft L +.ta 3i +ra -50 -50 50 50 25.77 80.20 :arrow 12 +:arrow 25.77 80.20 Miami +m -1 0 25.77 80.20 +v 0 0 35.00 74.02 +v -.6 .3 40.67 74.02 !arrow 8 +m -.6 -.3 40.67 74.02 " New York +v 0 0 34.05 118.25 Los Angeles +.ft +.TP +.L +map harrison 2 30 -l -90 90 120 240 -o 90 0 0 +A fan view covering 60\(de on either +side of the Date Line, as seen from one earth radius +above the North Pole gazing at the +earth's limb, which is 30\(de off vertical. +Option +.B -o +overrides the default +.BR "-o 90 0 180" , +which would rotate +the scene to behind the observer. +.SH FILES +All files in directory $MAPDIR +.TF counties +.TP +.F [1-4]?? +World Data Bank II for option +.B -f +.TP +.BR world , states , counties +default and other maps for option +.B -m +.TP +.F *.x +map indexes +.TP +.F map +the program proper +.SH "SEE ALSO" +.IR map (5), +.IR proj (3), +.IR plot (1) +.SH DIAGNOSTICS +`Map seems to be empty'\(ema coarse survey found +zero extent within the +.B -l +and +.BR -w +bounds; for maps of limited extent +the grid resolution, +.I res, +or the limits may have to be refined. +.SH BUGS +The syntax of range specifications in +.B -y +files differs from that in options. +.br +Windows (option +.BR -w ) +cannot cross the Date Line. +.br +No borders appear along edges arising from +visibility limits. +.br +Segments that cross a border are dropped, not clipped. +.br +Certain very long line segments are dropped on the assumption +that they were intended to go the other way around the world. +.br +Automatic scaling may miss the extreme points of +peculiarly shaped maps; use option +.B -p +to recover. +.br +Although +.I map +draws grid lines dotted and +.B -t +tracks dot-dashed, many plotting filters +cannot cope and make them solid. diff --git a/static/v10/man7/me.7 b/static/v10/man7/me.7 new file mode 100644 index 00000000..61d35ac2 --- /dev/null +++ b/static/v10/man7/me.7 @@ -0,0 +1,270 @@ +.hc % +.TH ME 7 11/16/79 +.UC +.SH NAME +me \- macros for formatting papers +.SH SYNOPSIS +.B "nroff \-me" +[ options ] +file ... +.br +.B "troff \-me" +[ options ] +file ... +.SH DESCRIPTION +This package of +.I nroff +and +.I troff +macro definitions provides a canned formatting +facility for tech%nical papers in various formats. +When producing 2-column output on a terminal, filter +the output through +.IR col (1). +.PP +The macro requests are defined below. +Many +.I nroff +and +.I troff +requests are unsafe in conjunction with +this package, however these requests may be used with +impunity after the first .pp: +.nf +.IP +.ta \w'.sz +n 'u +\&.bp begin new page +\&.br break output line here +\&.sp n insert n spacing lines +\&.ls n (line spacing) n=1 single, n=2 double space +\&.na no alignment of right margin +\&.ce n center next n lines +\&.ul n underline next n lines +\&.sz +n add n to point size +.fi +.PP +Output of the +.I eqn, +.I neqn, +.I refer, +and +.IR tbl (1) +preprocessors +for equations and tables is acceptable as input. +.SH FILES +/usr/lib/tmac/tmac.e +.br +/usr/lib/me/* +.SH "SEE ALSO" +eqn(1), troff(1), refer(1), tbl(1) +.br +\-me Reference Manual, Eric P. Allman +.br +Writing Papers with Nroff Using \-me +.tr &. +.SH REQUESTS +In the following list, +\*(lqinitialization\*(rq +refers to the first .pp, .lp, .ip, .np, .sh, or .uh macro. +This list is incomplete; +see +.I "The \-me Reference Manual" +for interesting details. +.PP +.ta \w'.eh \'x\'y\'z\' 'u +\w'Initial 'u +\w'Cause 'u +.br +.di x + \ka +.br +.di +.in \nau +.ti0 +Request Initial Cause Explanation +.ti0 + Value Break +.br +.in \nau +.ti0 +\&.(c - yes Begin centered block +.ti0 +\&.(d - no Begin delayed text +.ti0 +\&.(f - no Begin footnote +.ti0 +\&.(l - yes Begin list +.ti0 +\&.(q - yes Begin major quote +.ti0 +\&.(x \fIx\fR - no Begin indexed item in index +.I x +.ti0 +\&.(z - no Begin floating keep +.ti0 +\&.)c - yes End centered block +.ti0 +\&.)d - yes End delayed text +.ti0 +\&.)f - yes End footnote +.ti0 +\&.)l - yes End list +.ti0 +\&.)q - yes End major quote +.ti0 +\&.)x - yes End index item +.ti0 +\&.)z - yes End floating keep +.ti 0 +\&.++ \fIm H\fR - no Define paper section. +.I m +defines the part of the paper, and can be +.B C +(chapter), +.B A +(appendix), +.B P +(preliminary, e.g., abstract, table of contents, etc.), +.B B +(bibliography), +.B RC +(chapters renumbered from page one each chapter), +or +.B RA +(appendix renumbered from page one). +.ti 0 +\&.+c \fIT\fR - yes Begin chapter (or appendix, etc., as +set by .++). +.I T +is the chapter title. +.ti0 +\&.1c 1 yes One column format on a new page. +.ti0 +\&.2c 1 yes Two column format. +.ti0 +\&.EN - yes Space after equation +produced by +.I eqn +or +.IR neqn . +.ti0 +\&.EQ \fIx y\fR - yes Precede equation; break out and +add space. +Equation number is +.IR y . +The optional argument \fIx\fR +may be +.I I +to indent equation (default), +.I L +to left-adjust the equation, or +.I C +to center the equation. +.ti0 +\&.TE - yes End table. +.ti0 +\&.TH - yes End heading section of table. +.ti0 +\&.TS \fIx\fR - yes Begin table; if \fIx\fR is +.I H +table has repeated heading. +.ti 0 +\&.ac \fIA N\fR - no Set up for ACM style output. +.I A +is the Author's name(s), +.I N +is the total number of pages. +Must be given before the first initialization. +.ti0 +\&.b \fIx\fR no no Print +.I x +in boldface; if no argument switch to boldface. +.ti 0 +\&.ba \fI+n\fR 0 yes Augments the base indent by +.I n. +This indent is used to set the indent on regular text +(like paragraphs). +.ti0 +\&.bc no yes Begin new column +.ti0 +\&.bi \fIx\fR no no Print +.I x +in bold italics (nofill only) +.ti0 +\&.bx \fIx\fR no no Print \fIx\fR in a box (nofill only). +.ti 0 +\&.ef \fI\'x\'y\'z\'\fR \'\'\'\' no Set even footer to x y z +.ti 0 +\&.eh \fI\'x\'y\'z\'\fR \'\'\'\' no Set even header to x y z +.ti 0 +\&.fo \fI\'x\'y\'z\'\fR \'\'\'\' no Set footer to x y z +.ti 0 +\&.hx - no Supress headers and footers on next page. +.ti0 +\&.he \fI\'x\'y\'z\'\fR \'\'\'\' no Set header to x y z +.ti0 +\&.hl - yes Draw a horizontal line +.ti0 +\&.i \fIx\fR no no Italicize +.I x; +if +.I x +missing, italic text follows. +.ti0 +\&.ip \fIx y\fR no yes Start indented paragraph, +with hanging tag +.IR x . +Indentation is +.I y +ens (default 5). +.ti0 +\&.lp yes yes Start left-blocked paragraph. +.ti 0 +\&.lo - no Read in a file of local macros of the +form +.BI \&.* x. +Must be given before initialization. +.ti0 +\&.np 1 yes Start numbered paragraph. +.ti 0 +\&.of \fI\'x\'y\'z\'\fR \'\'\'\' no Set odd footer to x y z +.ti 0 +\&.oh \fI\'x\'y\'z\'\fR \'\'\'\' no Set odd header to x y z +.ti 0 +\&.pd - yes Print delayed text. +.ti0 +\&.pp no yes Begin paragraph. +First line indented. +.ti0 +\&.r yes no Roman text follows. +.ti 0 +\&.re - no Reset tabs to default values. +.ti 0 +\&.sc no no Read in a file of special characters +and diacritical marks. +Must be given before initialization. +.ti0 +\&.sh \fIn x\fR - yes Section head follows, +font automatically bold. +.I n +is level of section, +.I x +is title of section. +.ti 0 +\&.sk no no Leave the next page blank. +Only one page is remembered ahead. +.ti 0 +\&.sz \fI+n\fR 10p no Augment the point size by +.I n +points. +.ti 0 +\&.th no no Produce the paper in thesis format. +Must be given before initialization. +.ti 0 +\&.tp no yes Begin title page. +.ti0 +\&.u \fIx\fR - no Underline argument (even in \fItroff\fR). +(Nofill only). +.ti0 +\&.uh - yes Like .sh but unnumbered. +.ti0 +\&.xp \fIx\fR - no Print index +.I x. diff --git a/static/v10/man7/msh.7 b/static/v10/man7/msh.7 new file mode 100644 index 00000000..bbf39109 --- /dev/null +++ b/static/v10/man7/msh.7 @@ -0,0 +1,34 @@ +.pa 1 +.he 'MSH (VII)'6/15/72'MSH (VII)' +.ti 0 +NAME msh -- mini-shell +.sp +.ti 0 +SYNOPSIS /etc/msh +.sp +.ti 0 +DESCRIPTION msh___ +is a heavily simplified version of the Shell. +It reads one line from the standard +input file, interprets it as a command, and calls the command. + +The mini-shell supports few of the advanced features +of the Shell; none of the following characters is special: + + > < $ \\ ; & + +However, "*", "[", and "?" are recognized and glob____ is called. +The main use of msh___ is to provide a command-executing +facility for various interactive sub-systems. +.sp +.ti 0 +FILES -- +.sp +.ti 0 +SEE ALSO sh(I), glob(VII) +.sp +.ti 0 +DIAGNOSTICS "?" +.sp +.ti 0 +BUGS -- diff --git a/static/v10/man7/netlib.7 b/static/v10/man7/netlib.7 new file mode 100644 index 00000000..2dbc04b8 --- /dev/null +++ b/static/v10/man7/netlib.7 @@ -0,0 +1,91 @@ +.TH NETLIB 7 +.SH NAME +netlib \- retrieve public-domain software +.SH SYNOPSIS +.B mail research!netlib +.SH DESCRIPTION +.I Netlib +retrieves files by electronic mail from a set of libraries +of public-domain software, mostly mathematical. +Netlib responds to mail messages containing one or more +of the requests described below. +.HP +.B send index +.br +.ns +.HP +.B send +[ +.I option ... +] +.I file ... +[ +.B but not +.I file ... +] +.B from +.I library ... +.br +Retrieve files from specified libraries. +The +.L index +lists all libraries and gives other helpful information. +A file is delivered together with all files +it depends on from its library, unless option +.L only +is present. +Files are retrieved in upper case for requests written +in upper case. +.HP +.B whois +.I names +.br +Retrieve addresses and telephone numbers from a database +of applied mathematicians. +.HP +.B find +.I word ... +[ +.B from +.I library ... +] +.br +Retrieve one-line index descriptions by content from all or +any directories. +.HP +.B mailsize +.I size +.br +Limit the length of mail messages to +.I size. +The size may be given in kilobytes, e.g. +.BR 100k . +.PP +For information about a particular library, retrieve its +.LR index , +which lists routines with one-line descriptions, +or its +.LR directory . +The library +.LR core +contains machine constants and basic linear algebra modules +that are needed with many other libraries. +.SH EXAMPLES +.TP +.B send index from eispack +What's in +.BR eispack ? +.TP +.B send directory from eispack +Get file names and sizes. +.TP +.B send dgeco from linpack +Retrieve a routine and all it depends on. +.TP +.B "send list of dgeco from linpack +How big would that retrieval be? +.TP +.B find cubic spline +What does +.I netlib +have about `cubic' or `spline'? diff --git a/static/v10/man7/netnews.7 b/static/v10/man7/netnews.7 new file mode 100644 index 00000000..0fb0d931 --- /dev/null +++ b/static/v10/man7/netnews.7 @@ -0,0 +1,148 @@ +.TH NETNEWS 7 "local, not alice" +.CT 1 comm_users inst_info +.SH NAME +netnews \(mi send or receive news articles +.SH SYNOPSIS +.B netnews +[ +.I option ... +] +.PP +.B netnews +.B -s +[ +.I newsgroup ... +] +.PP +.B netnews +.B -i +.I title +[ +.B -n +.I newsgroup ... +] +.SH DESCRIPTION +.I Netnews +is an intercomputer news service. +Used now only locally, it has been replaced by +.IR postnews (7) +and +.IR readnews (7) +for outside connections. +When invoked without options it prints recent articles. +Normally the articles printed are restricted to newsgroups +you have signed up for and are +newer than your last use of +.I netnews. +After each article +a command is read from the standard input: +.TP \w'newline\ 'u +newline +Go on to next article. +.PD 0 +.TP +.B p +Print article again. +.TP +.B - +Go back to previous article. +.TP +.B c +Cancel (restricted to contributor and super-user). +.TP +.BI "w " file +Append a copy of the article to the named +.I file. +.TP +.B r +Reply to author (via mail). +.TP +.B q +Exit. +.TP +.B x +Exit without update. +.PD +.PP +The options are: +.TP \w'newline\ 'u +.B -p +Print with no questions asked. +.TP +.B -r +Print in reverse time order. +.TP +.B -l +Print titles only. +.TP +.BI -a " date" +Print articles received after +.IR date ; +no date means the beginning of time. +.TP +.BI -n " newsgroup ..." +Print articles from named newsgroups. +.TP +.BI -t " string ..." +Print only titles containing one of the +.I strings. +.TP +.BI -s " newsgroup ..." +Subscribe to named newsgroups. +If no +.I newsgroups +are given, +list your current subscriptions. +Newsgroup +.L all +receives all articles; +.L net.all +receives all newsgroups that begin with +.LR net. , +etc. +All users subscribe to the newsgroup +.LR general . +.TP +.B -i +Insert an article +(read from standard input) +with title +.I title +to the newsgroups specified by +.B -n +(default +.LR general ). +.PD +.SH FILES +.TF /usr/spool/news/history +.TP +.F $HOME/.newsrc +user's subscription list +.TP +.F /usr/spool/news/sys.nnn +news articles +.TP +.F /usr/spool/news/.bitfile +bit map of users with news +.TP +.F /usr/spool/news/.ngfile +list of legal newsgroups +.TP +.F /usr/spool/news/.uindex +index of netnews users +.TP +.F /usr/spool/news/.nindex +index of news articles +.TP +.F /usr/spool/news/.seq +sequence number of last article +.TP +.F /usr/spool/news/.history +list of all articles ever seen +.TP +.F /usr/spool/news/.sys +system subscription list +.SH SEE ALSO +.IR news (7), +.IR readnews (7), +.IR netnews (5) diff --git a/static/v10/man7/news.7 b/static/v10/man7/news.7 new file mode 100644 index 00000000..54118d17 --- /dev/null +++ b/static/v10/man7/news.7 @@ -0,0 +1,67 @@ +.TH NEWS 7 +.CT 1 comm_users +.SH NAME +news \(mi print news items +.SH SYNOPSIS +.B news +[ +.B -a +] +[ +.B -n +] +[ +.B -s +] +[ +.I item ... +] +.SH DESCRIPTION +When invoked without options, +this simple local news service +prints files that have appeared in +.BR /usr/news +since last reading, most recent first, +with each preceded by an appropriate header. +The time of reading is recorded. +The options are +.TP +.B -a +Print all items, regardless of currency. +The recorded time is not changed. +.TP +.B -n +Report the names of the current items without +printing their contents, and without changing +the recorded time. +.TP +.B -s +Report the number of current items. +.PP +Other arguments +select particular news items. +.PP +If an interrupt +is received during a news item, the +next item is started immediately. +Another interrupt +within a second of the first causes the program to terminate. +.PP +To post a news item, create a file in +.FR /usr/news . +.PP +You may arrange to receive news automatically by +registering your mail address in +.FR /usr/lib/subscribers . +A daemon mails newly posted news items +to all addresses on the list. +.SH FILES +.F /usr/news/* +.br +.F $HOME/news_time +date of last read news +.br +.F /usr/lib/subscribers +.SH SEE ALSO +.IR calendar (1), +.IR readnews (7) diff --git a/static/v10/man7/obproc.7 b/static/v10/man7/obproc.7 new file mode 100644 index 00000000..6855370d --- /dev/null +++ b/static/v10/man7/obproc.7 @@ -0,0 +1,240 @@ +.pa 1 +.he '3/15/72''BOOT PROCEDURES (VII)' +.ti 0 +NAME bos, maki, rom, vcboot, msys, et al +.sp +.ti 0 +SYNOPSIS -- +.sp +.ti 0 +DESCRIPTION On +the RF disk, the highest 16K words are +reserved for stand-alone programs. +These 16K words are allocated as follows: +.sp +bos (1K) +.br +Warm UNIX (7K) +.br +Cold UNIX (8K) +.sp +The UNIX read only memory (ROM) +is home cut with 2 programs of 16 words each. +The first (address 173000) +reads bos___ from the RF disk into core +location 154000 +and transfers to 154000. +The other ROM program +(address 173040) +reads a DECtape sitting in the end-zone +on drive 0 +into core location 0 and transfers to 0. +This latter operation is compatible with +part of DEC's standard ROM. +The disassembled code for the UNIX ROM follows: +.sp +.nf +.in 8 +173000: mov $177472,r0 12700;177472 + mov $3,-(r0) 12740;3 + mov $140000,-(r0) 12740;140000 + mov $154000,-(r0) 12740;154000 + mov $-2000,-(r0) 12740;176000 + mov $5,-(r0) 12740;5 + tstb (r0) 105710 + bge .-2 2376 + jmp *$154000 137;154000 +.sp +173040: mov $177350,r0 12700;177350 + clr -(r0) 5040 + mov r0,-(r0) 10040 + mov $3,-(r0) 12740;3 + tstb (r0) 105710 + bge .-2 2376 + tst *$177350 5737;177350 + bne . 1377 + movb $5,(r0) 112710;5 + tstb (r0) 105710 + bge .-2 2376 + clr pc 5007 +.fi +.in 16 +.sp +The program bos___ (Bootstrap Operating System) +examines the console switchs and executes +one of several internal programs depending on the setting. +The following settings are currently recognized: +.sp +.in +8 +.ti -8 +??? Will read Warm UNIX from +the RF into core location 0 and transfer to 600. +.sp +.ti -8 +1 Will read Cold UNIX from the +RF into core location 0 and transfer to 600. +.sp +.ti -8 +10 Will dump all of memory +from core location 0 onto DECtape drive 7 +and then halt. +.sp +.ti -8 +20 Will read 256 words from RK0 into +core 0 and transfer to zero. +This is the procedure to boot +DOS from an RK. +.sp +.ti -8 +40 This is the same as 10 above, but +instead of halting, UNIX warm is loaded. +.sp +.ti -8 +0 Will load a standard UNIX binary paper tape +into core location 0 and transfer to 0. +.sp +.ti -8 +77500 Will load the standard DEC absolute and binary +loaders and transfer to 77500. +.sp +.in 16 +Thus we come to the UNIX warm boot procedure: +put 173000 into the switches, push +.ul +load address +and then push +.ul +start. +The alternate switch setting of 173030 +that will load warm UNIX is used +as a signal to bring up +a single user system for special +purposes. +See +init(VII). +For systems without a rom, +UNIX (both warm and cold) +have a copy of the disk boot +program at location 602. +This is probably a better warm boot +procedure because +the program at 602 also +attempts to complete outstanding I/O. +.sp +Cold boots can be accomplished with the +Cold UNIX program, but they're not. +Thus the Cold UNIX slot on the RF may have +any program desired. +This slot is, however, used during a cold boot. +Mount the UNIX INIT DECtape on drive +0 positioned in the end-zone. +Put 173040 into the switches. +Push +.ul +load address. +Put 1 into the switches. +Push +.ul +start. +This reads a program called +.ul +vcboot +from the tape into +core location 0 and transfers to it. +vcboot______ then reads 16K words from +the DECtape (blocks 1-32) +and copies the data to the highest 16K words of +the RF. +Thus this initializes the read-only part of the RF. +vcboot______ then reads in bos___ and executes it. +bos___ then reads in Cold UNIX and executes that. +Cold UNIX halts for a last chance before +it completely initializes the RF file system. +Push +.ul +continue, +and Cold UNIX will initialize the RF. +It then sets into execution a user program +that reads the DECtape for initialization files +starting from block 33. +.a +When this is done, the program executes +/etc/init +which should have been on the tape. +.sp +The INIT tape is made by the program maki____ +running under UNIX. +maki____ writes vcboot______ on block 0 of +.ul +/dev/tap7. +It then copies the RF 16K words (using +.ul +/dev/rf0) +onto blocks 1 thru 32. +It has internally a list of files to +be copied from block 33 on. +This list follows: +.sp +.nf +.in +8 +/etc/init +/bin/chmod +/bin/date +/bin/login +/bin/ls +/bin/mkdir +/etc/mount +/bin/sh +/bin/tap +.in -8 +.fi +.sp +Thus this is the set of programs available after a cold boot. +init____ and sh__ are mandatory. +For multi-user UNIX, +getty_____ and login_____ are also necessary. +mkdir_____ is necessary due to a bug in tap___. +tap___ and mount_____ are useful to +bring in new files. +As soon as possible, date____ should be done. +That leaves ls__ and chmod_____ as frosting. +.sp +The last link in this incestuous +daisy chain is the program msys____. +.sp + msys____ char file +.sp +will copy the file file____ onto the +RF read only slot specified by the characacter char____. +Char is taken from the following set: +.sp + b_ bos + u_ Warm UNIX + 1_ Cold UNIX +.sp +Due to their rarity of use, +maki____ and msys____ are maintained off line and +must be reassembled before used. +.sp +.ti 0 +FILES /dev/rf0, +/dev/tap? +.sp +.ti 0 +SEE ALSO init(VII), +tap(I), +sh(I), +mkdir(I) +.sp +.ti 0 +DIAGNOSTICS -- +.sp +.ti 0 +BUGS This +section is very configuration dependent. +Thus, it does not +describe the boot procedure for +any one machine. +.sp +.ti 0 +OWNER ken diff --git a/static/v10/man7/papers.7 b/static/v10/man7/papers.7 new file mode 100644 index 00000000..ac4c4114 --- /dev/null +++ b/static/v10/man7/papers.7 @@ -0,0 +1,85 @@ +.TH PAPERS 7 bowell +.CT 1 inst_info +.SH NAME +findauthor, papers, makepaper \- consult database of locally authored papers +.SH SYNOPSIS +.B findauthor +.IB person +.PP +.B papers +.I person +.PP +.B makepaper +.I papername +.SH DESCRIPTION +.PP +.I Findauthor +produces a shell +.I cd +command to set the current directory to the place where papers by +.I person +(a login name or a last name) are stored. +.PP +.I Papers +lists the names and titles of the papers stored under +.I person. +.PP +.I Makepaper +produces +.IR troff (1) +output for +.I papername. +.PP +The database is stored in file system +.FR /n/bowell/pap . +File +.F /n/bowell/pap/Titles +lists titles, authors and installation date +of papers in the database. +Many papers have been preprocessed for quick presentation +of figures and equations with +.IR reader (9.7). +These papers are stored in directories named +.IB papername .d\fR; +other papers are stored as +single files. +.SH EXAMPLES +.TP +.B `findauthor aho` +Change to directory of Aho's works. +.SH FILES +.TF /n/bowell/pap/Titles +.TP +.F /n/bowell/pap/Titles +titles, authors and installation dates +.TP +.F /n/bowell/pap/*org +membership list +.TP +.BI /n/bowell/pap/ center / department / author\f5/\fIpapername\fR[\f5.d\fR] +.SH SEE ALSO +.IR reader (9.7), +.IR docsubmit (1), +.IR troff (1), +.IR doctype (1) +.SH BUGS +.PP +.I Makepaper +depends on +.IR doctype (1) +to determine what preprocessors to run. +.br +.I Makepaper +does not know the author's original arguments to +.IR refer , +so papers are produced with +.IR refer 's +default arguments. +.br +.I Makepaper +does not work with +.RI non- troff +formatters such as +.IR tex (1) +or +.IR monk (1). diff --git a/static/v10/man7/poly.7 b/static/v10/man7/poly.7 new file mode 100644 index 00000000..daf3d736 --- /dev/null +++ b/static/v10/man7/poly.7 @@ -0,0 +1,98 @@ +.TH POLY 7 bowell +.CT 1 inst_info +.SH NAME +polypic, polypr \- database of polyhedra +.SH SYNOPSIS +.B polypic +[ +.B -phfis +] +.I solid ... +.br +.B polypr +[ +.B -cfhnpsi\f2file +] +.I solid ... +.SH DESCRIPTION +.I Polypic +outputs a picture of the planar nets for the specified solids in +.IR plot (5) +format. +The options are: +.TP +.B -f +Print the face numbers. +.TP +.B -h +Print the hinge numbers. +.TP +.BI -i file +Use +.I file +instead of the normal database. +.TP +.B -s +Produce an orthogonal view of the 3D solid rather than the net. +.TP +.B -p +Produce +.IR pic (1) +output. +.PP +.I Polypr +gives more general access to the data. +By default, all the data is output. +If no solid is specified, all the solids in the database are output. +The options are: +.TP +.B -n +Print only the database index number and the name. +.TP +.B -h +Print only a header line with name and number of faces and hinges. +.TP +.B -f +Print only the data for the flat net. +.TP +.B -s +Print only the data for the 3D solid. +.TP +.BI -i file +Use +.I file +instead of the normal database. +.TP +.B -c +Produce output for Tom Duff's polygon renderer (implies +.BR -s ). +.TP +.B -p +Produce useful parameters for a perspective view; implies +.BR -c . +.PP +For both +.I polypic +and +.IR polypr , +the solid may be specified by either its index number +or by any prefix of the name. +Ambiguities are resolved by database order. +.SH FILES +.F /usr/include/poly.h +.br +.F /usr/lib/polyhedra +.SH SEE ALSO +.IR plot (1), +.IR poly (5) +.br +A. G. Hume, +`Exact Descriptions of Regular and Semi-regular Polyhedra and Their Duals' +.I Computing Science Technical Report 130, +AT&T Bell Laboratories, November, 1986 +.SH BUGS +Not all the polyhedra have valid 3D data. +.br +Option +.B -s +doesn't work yet. diff --git a/static/v10/man7/postnews.7 b/static/v10/man7/postnews.7 new file mode 100644 index 00000000..dcf85d71 --- /dev/null +++ b/static/v10/man7/postnews.7 @@ -0,0 +1,43 @@ +.TH POSTNEWS 7 alice +.CT 1 comm_users +.SH NAME +postnews \(mi submit netnews articles +.SH SYNOPSIS +.B postnews +[ +.I file +] +.SH DESCRIPTION +.I Postnews +submits the +.I file +as a +.IR readnews (7) +article. +It prompts for title, +primary newsgroup, and other newsgroup distribution. +Good manners decree an informative title and accurate, minimal, +distribution. +.PP +The names of newsgroups are relative pathnames +of directories depending from +.FR /usr/spool/news , +with slashes +replaced by dots. +.PP +If no file is specified, +.I postnews +invokes an editor specified by the environment variable +.B EDITOR +(default +.LR vi ). +The editor's buffer is initialized with header information, +which may be changed. +The text of the article may be appended. +.SH "SEE ALSO" +.IR readnews (7) +.br +BSD manual for more sophisticated uses, +such as posting news from a program. +.SH BUGS +The editor default is distinctly nonclassical. diff --git a/static/v10/man7/pq.7 b/static/v10/man7/pq.7 new file mode 100644 index 00000000..fb3e1126 --- /dev/null +++ b/static/v10/man7/pq.7 @@ -0,0 +1,126 @@ +.TH PQ 7 +.SH NAME +pq \- telephonet directory assistance +.SH SYNOPSIS +.B pq +[ +.I option ... +] +.I query +.SH DESCRIPTION +.I Pq +queries `Post' directory assistance computers +for information from the AT&T phone book. A normal +query is a name, in the form +.IB first.middle.middle2.last,suffix, +where only +.I last +is required. +Earlier names may be truncated, even to a null string, +and extra punctuation may be dropped. +Other fields can be specified, in the form +.IB attribute = value, +with fields separated by +.BR / . +The attributes are +.TP +.B pn +.TP +.B name +personal (full) name; for prefix match on last name, append +.B * +or +.BR ... ; +for phonetic search, append or prepend +.B ? +.HP +.BR first , +.BR middle , +.BR middle2 , +.BR last , +.B suffix +.br +parts of name, prefix-matched except for suffix +.HP +.BR pid , +.B ssn +.br +personnel identification number, +social security number +.TP +.B org +organization code +.TP +.B tl +title: abbreviated or prefix-matched; e.g. +.BR tl=dh, +.B tl=dep.he +.TP +.B tel +phone number: (908)582-6050, punctuation optional, parts may be omitted from left +.HP +.BR area , +.BR exch , +.B ext +.br +parts of phone number +.TP +.B loc +location code; for prefix match, append +.B * +.HP +.BR room , +.BR street , +.BR city , +.BR state , +.B zip +.br +parts of address, prefix-matched except for state +.TP +.B ema +email address; for prefix match, append * +.TP +.B multi +which of multiple addresses for one employee; e.g. +.B multi=2 +.PD +.PP +The options are +.TP +.B -l +The query is a location code. +.TP +.BI -o " format +Provide output in the specfied +.I format, +a string like that of +.IR printf (3), +with format codes being attribute names. +.SH EXAMPLES +.PD 0 +.TP +.B pq penzias +.TP +.B pq a.a.penzias +.TP +.B pq ema=research!aap +Three ways to find a person. +.TP +.B pq loc=mh/room=2b519 +Find members of an office. +.TP +.B pq \-l mt +Find information about a location. +.TP +.B +pq \-o "%24pn %10org %6loc %6room %12tel %ema" a.a.penzias +The default output format. +.PD +.SH FILES +.TP 30 +$POST/lib/dispatch +directory configuration file +.SH SEE ALSO +tel (7) + + diff --git a/static/v10/man7/qns.7 b/static/v10/man7/qns.7 new file mode 100644 index 00000000..ecbd3241 --- /dev/null +++ b/static/v10/man7/qns.7 @@ -0,0 +1,189 @@ +.TH QNS 7 +.CT 1 sa_auto +.SH NAME +qns \- query name server +.SH SYNOPSIS +.B qns +[ +.B -n +.I server +] [ +.I request +] +.SH DESCRIPTION +.I Qns +retrieves information from +a database of naming information. +It is used by +.I rsh +and +.I rlogin +(see +.IR dcon (1)) +to translate names to internet addresses and by +.IR mail (1) +to route electronic mail. +.PP +Entries in the database +consist of one or more +.IB value , type +pairs or simple +.I values. +A simple +.I value +declares the name of some entity. +An entry may contain no name +or several, and +different entries containing the same name +need not refer to the same entity. +.PP +These types are used: +.PP +.TF origin +.TP +.B dk +.I Value +is a Datakit address. +.TP +.B in +.I Value +is a numeric IP address. +.TP +.B dom +.I Value +is an internet domain name. +.TP +.B tel +.I Value +is a telephone number, +possibly prefixed by a +.I uucp +.B Dialcodes +name. +.TP +.B org +.I Value +is an organization name. +.TP +.B svc +.I Value +names a service. +.TP +.B origin +.I Value +must be +.BR local , +for sorting by `distance'; +see below. +.PD +.PP +The following entries describe an entity +.B research +with a Datakit address, +an IP address and domain name, +belonging to organization +.BR att , +and offering the +.B uucp +service: +.IP +.EX +192.11.4.55,in research research.astro.nj.att.com.,dom att,org +research nj/astro/research,dk uucp,svc att,org +.EE +.PP +.I Qns +prints database entries that match +.I requests. +If a +.IR request +is supplied on the command line, +.I qns +prints the answer and exits; +otherwise it reads and answers requests from the standard input +until end-of-file. +The possible requests are: +.TP +.BI set " key" ... +Print every entry +matching +all +.IR keys . +.TP +.BI value " tlist key" ... +Examine entries matching +the +.IR keys +until a pair with type +.I tlist +is found; +print the matching value +and stop. +.I Tlist +may be a single type, +or several separated by +.LR | . +.TP +.B reset +Cause the name server +to reinitialize its database. +.TP +.B help +Print a list of requests. +.TP +.B quit +Exit +.IR qns . +.PD +.PP +A +.I key +is a +.IB value , type +pair; +an entry matches if it contains that pair. +If +.BI , type +is omitted, +any pair with the specified +.I value +will do. +A +.B * +at the end of a +.I value +stands for an arbitrary suffix. +.PP +When a database search +returns several entries with +.B dk +or +.B dom +types, and the database contains an entry with the conventional pair +.BR local,origin , +the entries are sorted by increasing `distance' +from the +.B dk +or +.B dom +pairs in the +.B local,origin +entry. +Datakit names in the same exchange are nearer +than names in different exchanges in the same area, +which are nearer than names in different areas. +Domain names matching to four levels of domain hierarchy +are nearer than names matching to only three levels, +and so on. +.PP +.I Qns +expects to reach the name server +.IR ns (8); +option +.B -n +points it at service +.I server +instead. +.SH SEE ALSO +.IR ipc (3), +.IR ns (8) diff --git a/static/v10/man7/readnews.7 b/static/v10/man7/readnews.7 new file mode 100644 index 00000000..502a2804 --- /dev/null +++ b/static/v10/man7/readnews.7 @@ -0,0 +1,400 @@ +.TH READNEWS 7 alice,research +.CT 1 comm_users +.SH NAME +checknews, readnews \- read netnews articles +.SH SYNOPSIS +.B readnews +[ +.B -a +.I date +] +[ +.B -n +.I newsgroup ... +] +[ +.B -t +.I title ... +] +[ +.B -lprxhfuM +] +[ +.B -c +[ +.I command +] +] +.PP +.B readnews -s +.PP +.B checknews +[ +.B ynqve +] [ +.I readnews-options +] +.SH DESCRIPTION +.I Readnews +prints unread articles that have arrived +via the informal, worldwide `netnews' network. +Without arguments it prints unread articles from +newsgroups to which you subscribe. +The options are: +.TF -adate +.TP +.B -M +An interface to +.IR Mail (A). +A +.IR mail (1)-like +interface. +.TP +.BI -c " command +Articles are written to a temporary `mailbox' and the +.I command +(e.g. +.LR "mail -f %" ) is +invoked, with the mailbox in place of +.LR % . +A missing +.I command +gets something like +.IR mail (1). +.TP +.B -p +Articles are sent to the standard output, no questions +asked. +.TP +.B -l +Titles only. +The file +.F .newsrc +will not be updated. +.TP +.B -r +Print articles in reverse order. +.TP +.B -f +No followup articles. +.TP +.B -h +Printed in a briefer format. +.TP +.B -u +Update file +.F .newsrc +every 5 minutes. +.TP +.BI -n " newsgroup ... +Select articles that belong to +.I newsgroups. +.TP +.BI -t " titles +Select articles whose titles contain one of the +.I title +strings. +.TP +.BI -a " date +Select articles that were posted since +.IR date ; +a missing +.I date +means the beginning of time. +.TP +.B -x +Ignore +.FR .newsrc ; +select previously read as well as +unread articles. +.TP +.B -s +Print subscription list. +.PD +.PP +The file +.FR $HOME/.newsrc , +or a file specified +by environment variable +.BR NEWSRC , +tells what topics you are interested in and +what you have read. +If +.F .newsrc +contains a line starting with options (left +justified, continued by trailing +.LR \e ), +or if the environment +variable +.B NEWSOPTS +is present, options are taken from there +as well as the command line. +In case of conflict, an option +on the command line take precedence, followed by +.F .newsrc +and finally +.BR NEWSOPTS . +.PP +.I Readnews +invokes some other programs to perform services. +To reply to a news item it uses +.IR mail (1) +or an alternate in environment parameter +.BR MAILER . +It paginates +with +.IR p (1), +or an alternate in +.BR PAGER . +.BR PAGER +is a +command, perhaps containing +.L % +as in option +.BR -c , +or empty for no pagination. +.PP +The default and +.IR mail +interfaces support the following commands, +and prompt with common alternatives: a newline +accepts the first one. +For example, +.L [ynq] +proposes +yes, no, and quit; newline gets yes. +.TP +.B y +Yes. +Print current article and go on to next. +.PD0 +.TP +.B n +No. +Skip the current article. +(In +.I mail +interface, it means +.BR y .) +.TP +.B q +Quit; update +.FR .newsrc . +.TP +.B c +Cancel the article. +Only the author or the super-user +can do this. +.TP +.B r +Reply. +Reply to article's author via mail. +You are placed in +.IR mail , +or an alternate in +environment parameter +.BR EDITOR , +with a header constructed from the article. +You may change or add headers. +Add your reply after the blank line. +Upon exit the message is mailed. +.TP +.B rd +Reply directly. +You are placed in +.B MAILER +.RI ( mail +by default). +Type the text of the reply and then control-D. +.TP +.BI f " title +Submit a followup article. +If you omit the +title, +.I readnews +generates an appropriate one. +You will be placed in your +.B EDITOR +to compose the followup. +.TP +.B fd +Follow up directly. +This is like +.BR f , +but does not construct headers. +.TP +.BI N " newsgroup +Go to the named +.IR newsgroup , +or the next newsgroup if none is named +.TP +.BI s " file +Save. +Append the article to +.I file. +The default is +.FR Articles . +If +.I file +is not a full pathname, it is taken +relative to +.BR HOME , +overridden by environment parameter +.BR NEWSBOX . +If the first character of +.I file +is +.LR | , +the rest is taken as the name of a program, into which the +article is piped. +.TP +.B # +Report the name and size of the newsgroup. +.TP +.B e +Erase. +Forget that this article was read. +.TP +.B h +Print a more verbose header. +.TP +.B H +Print a very verbose, complete header. +.TP +.B U +Unsubscribe from this newsgroup and go on to the next. +.TP +.B d +Read a digest. +Presents a digest as separate articles. +.TP +.BI D " number +Decrypt a Caesar cipher (usually used to +obscure off-color material in +.LR net.jokes ). +The rotation is normally determined line-by-line from character +frequencies. +If this fails, an explicit +.I number +(usually 13) may be given. +.TP +.B v +Print the current version of the news software. +.TP +.B ! +Shell escape. +.TP +.I number +Go to article +.I number. +.TP +.if t .BI \(+- n +.if n +-n +Skip +.I n +articles, 1 by default. +The articles skipped +are recorded as `unread'. +.TP +.B - +Go back to last article. +This is a toggle, typing it +twice returns you to the original article. +.TP +.B x +Exit. +Like +.B q +except that +.F .newsrc +is not updated. +.TP +.BI X " system +Transmit article to the named system. +.PD +.PP +A +.L - +following +.BR c , +.BR f , +.BR fd , +.BR r , +.BR rd , +.BR e , +.BR h , +.BR H , +or +.BR s +refers to the previous article: +.LR "r -" +is the normal way to reply to a just-read article +when the next one is being offered. +.PP +.I Checknews +reports whether there is news present, with +options: +.TP +.B y +Report only if news is present (default). +.PD0 +.TP +.B n +Report only if news is absent. +.TP +.B q +Turn off reports; nonzero exit status indicates news. +.TP +.B v +Show the name of the first newsgroup containing unread news. +.TP +.B vv +Explain any claim of new news, useful if checknews and +readnews disagree. +.TP +.B e +Execute +.I readnews +if there is news. +.SH EXAMPLES +.TP +.L +readnews +Read all unread articles. +.TP +.L +readnews -n net.langs.c -a last thursday +Print every unread article about C since last Thursday. +.TP +.L +readnews -p >/dev/null & +Discard all unread news: +useful after returning from a long trip. +.TP +.L +readnews -c "ed %" -l +Invoke +.IR ed (1) +on a file containing the titles of all +unread articles. +.SH FILES +.TF /usr/spool/news/newsgroup/number +.TP +.BI /usr/spool/news/ newsgroup / number +News articles +.TP +.F /usr/lib/news/active +Active newsgroups and numbers of articles +.TP +.F /usr/lib/news/help +Help file for default interface +.TP +.F $HOME/.newsrc +.SH SEE ALSO +.IR postnews (7), +.IR Mail (A) +.SH BUGS +.I Readnews +is baroque; many users prefer to browse among +the files in +.FR /usr/spool/news . diff --git a/static/v10/man7/scat.7 b/static/v10/man7/scat.7 new file mode 100644 index 00000000..40b7bee4 --- /dev/null +++ b/static/v10/man7/scat.7 @@ -0,0 +1,81 @@ +.TH SCAT 7 +.CT 1 inst_info +.SH NAME +scat \- sky catalogue +.SH SYNOPSIS +.B scat +.SH DESCRIPTION +.I Scat +looks up items in catalogues of objects +outside the solar system. +Items are read, one per line, from the standard input, and their +descriptions or cross-index listings (suitable for input to +.IR scat ) +are printed on the standard output. +An item is in one of the following formats: +.TP +.B ngc1234 +Number 1234 in the Revised New General Catalogue of +Nonstellar Objects. +The output identifies the type +.RB( eg =galaxy, +.BR pn =planetary +nebula, +.BR gc =globular +cluster, +.BR oc =open +cluster, +.BR dn =diffuse +nebula or +.BR nc =nebular +cluster), +possibly contained within the Large Magellanic Cloud +.RB ( in\ lmc ) +or Small +Magellanic Cloud +.RB ( in\ smc ), +its position in 2000.0 coordinates +and galactic coordinates, and a brief description. +.TP +.B sao12345 +Number 12345 in the Smithsonian Astrophysical Star Catalogue. +Output identifies the visual and photographic magnitudes, +2000.0 coordinates, proper motion, spectral type, multiplicity and variability +class, and HD number. +.TP +.B m4 +Catalog number 4 in Messier's catalog. +The output is the NGC number. +.TP +\f5"alpha umi"\fP +Star names are provided in double quotes. +Known names are the Greek +letter designations, proper names such as Betelgeuse, and bright variable stars. +Constellation names must be the three-letter abbreviations. +The output +is the SAO number. +For non-Greek names, SAO numbers and names are listed for all stars with +names for which the given name is a prefix. +.TP +.B 12h34m -16 +Coordinates in the sky are translated to the nearest `patch', +approximately one square degree of sky. +The output is the coordinates identifying the patch, +the constellations touching the patch, and the NGC and SAO +objects in the patch. +.TP +.B c umi +Gives voluminous output consisting of the patches covering the +named constellation. +.SH FILES +.F /n/kwee/usr/rob/sky2/*.sky +.SH SEE ALSO +.IR sky (7) +.br +.B /n/kwee/usr/rob/sky2/constelnames +for the three-letter abbreviations of the constellation names. +.SH BUGS +The database is fine, but the program is feeble. +.br +Coordinates printed by the program in +the listings for SAO and NGC objects are not understood as input. diff --git a/static/v10/man7/sky.7 b/static/v10/man7/sky.7 new file mode 100644 index 00000000..a6ce9c5b --- /dev/null +++ b/static/v10/man7/sky.7 @@ -0,0 +1,48 @@ +.TH SKY 7 bowell +.CT 1 inst_info +.SH NAME +sky \- astronomical ephemeris +.SH SYNOPSIS +.B sky +[ +.B -l +] +.SH DESCRIPTION +.I Sky +predicts the apparent locations of the sun, moon, visible planets, +and stars brighter than magnitude 2.5. +It reads one line from the standard input to obtain the desired time +expressed as five numbers: year, month, day, hour, and minute in GMT. +An empty line means now. +Each object is printed with astronomical coordinates, azimuth-elevation +coordinates relative to Murray Hill, NJ, and magnitude. +For variable stars the maximum magnitude is printed with +.LR * . +.PP +Option +.B -l +causes +.I sky +to prompt for another viewing location. +.PP +Standard astronomical effects are accounted for: +nutation and precession of the equinox, annual aberration, diurnal parallax, +and proper motion. +Atmospheric effects (extinction and refraction) are not calculated, +nor is perturbation of the earth by other bodies. +.PP +In ephemeris (slighly different from civil) time, the program +yields +positions of sun, moon, and stars good to a few tenths of an +arc-second. +Planets are good to a few seconds. +.SH FILES +.F /usr/lib/startab +.SH SEE ALSO +.IR scat (7) +.br +.I +American Ephemeris and Nautical Almanac +and +.I +Explanatory Supplement to the American Ephemeris and Nautical Almanac diff --git a/static/v10/man7/submit.7 b/static/v10/man7/submit.7 new file mode 100644 index 00000000..87fe1ccb --- /dev/null +++ b/static/v10/man7/submit.7 @@ -0,0 +1,112 @@ +.TH SUBMIT 7 +.CT 1 writing_output +.SH NAME +submit \- install document in database +.SH SYNOPSIS +.B submit +.I name +[ +.I option ... +] +.SH DESCRIPTION +.I Submit +ships a paper to +.FR /n/bowell/pap/spool , +from whence the paper will be installed under the given +.I name +in a database of locally-authored papers. +The paper then becomes available for printing with +.IR makepaper +(see +.IR papers (7)) +or for on-line inspection with +.IR reader (9.7). +.PP +.I Submit +expects to be run from a directory that +contains the files for the paper. +If only the +.I name +argument is given, +.I submit +assumes that the paper is maintained by +.IR make (1) +and follows instructions in the makefile, which must be present. +The options are +.TP +.B -mk +Use +.IR mk (1) +instead of +.I make. +.TP +.BI -M " makefile +Use the given makefile. +.TP +.BI -m " target +Make the given target. +.TP +.BI -s " script arg ..." +Use a shell +.I script +instead of a makefile. +.TP +.BI -i " file ..." +Format the paper with +.IR troff (1) +from the listed files, using macro packages and preprocessors as +determined by +.IR doctype (1). +Do not use a makefile or a shell script. +.TP +.BI -t " file ... +Format the paper with +.IR tex (1) +from the listed files. +Do not use a makefile or a shell script. +Only the basenames of the files need be given. +.TP +.B -tatex +The paper uses +.IR tatex +(see +.IR latex (7)). +This option is used only in conjunction with +.BR -t . +.SH FILES +.F /n/bowell/pap/spool/* +.SH DIAGNOSTICS +.I Submit +complains if it can't find input or if it encounters a +.I troff +.L .sy +command. +.SH "SEE ALSO" +.IR reader (9.7), +.IR troff (1), +.IR papers (7) +.SH BUGS +.I Submit +fails if the +.I troff +preprocessors are run in a `hidden' way +by calling a program (or shell script). +.br +When +.I troff +preprocessor output (i.e. +.IR "pic, grap, tbl, tped, ideal" ) +is included directly in the paper or with +.B .so +commands, +an attempt is made to find the preprocessor input file. +If this attempt fails, +.I submit +refuses to ship the paper. +.br +Automatic installation fails if the system can't find +the author's name or the author is not in the file containing +the center organization. +.br +Doesn't work with +.IR monk (1). diff --git a/static/v10/man7/tabs.7 b/static/v10/man7/tabs.7 new file mode 100644 index 00000000..df398573 --- /dev/null +++ b/static/v10/man7/tabs.7 @@ -0,0 +1,30 @@ +.pa 1 +.he 'TABS (VII)'6/15/72'TABS (VII)' +.ti 0 +NAME tabs -- set tab stops +.sp +.ti 0 +SYNOPSIS cat /usr/pub/tabs +.sp +.ti 0 +DESCRIPTION When +printed on a suitable terminal, this file +will set tab stops every 8 columns. +Suitable terminals include the Teletype model 37 and +the GE TermiNet 300. +.sp +These tab stop settings are +desirable because UNIX assumes them +in calculating delays. +.sp +.ti 0 +FILES -- +.sp +.ti 0 +SEE ALSO -- +.sp +.ti 0 +DIAGNOSTICS -- +.sp +.ti 0 +BUGS -- diff --git a/static/v10/man7/tel.7 b/static/v10/man7/tel.7 new file mode 100644 index 00000000..96202416 --- /dev/null +++ b/static/v10/man7/tel.7 @@ -0,0 +1,127 @@ +.TH TEL 7 +.CT 1 inst_info +.SH NAME +tel, telno, dq \- phone books +.SH SYNOPSIS +.B tel +.I key +.PP +.B telno +.I key ... +.PP +.B dq +.SH DESCRIPTION +.I Tel +looks up +.I key +in a private telephone book, +.FR $HOME/lib/tel , +if it exists, +and in a local book +.FR /usr/lib/tel . +.PP +.I Tel +is simply a script for +.IR grep +(see +.IR gre (1)), +so lookup may be by any part of a name or number. +Customarily the local telephone book contains names, userids, +home numbers, and office numbers of users. +It also contains a directory of area codes and miscellaneous +people of some general interest. +.PP +.I Telno +and +.I dq +retrieve information from a central, current database +of AT&T personnel. +The former is a simple one-line interface to the latter. +.PP +For +.I telno, +a +.I key +is typically a name. +Other fields in the database may be matched by using tabs +within the key (the key +must be quoted to protect spaces and tabs from the shell). +The fields are, in order: +.IP +.nf +name (last; last,first; first last; or payroll account no.) +organization (e.g. att or bl) +area code and exchange +extension +location +room +department +electronic mail address +.fi +.LP +Only a prefix of a first name need by given. +In some positions +.L * +(or +.BR ... ) +and +.L ? +may be used as a wild cards as in +.IR sh (1). +Case is unimportant. +.PP +.I Dq +provides interactive access to the central database. +Under +.IR mux (9.1) +it is best run +in a terminal-simulator layer, either +.L "term 5620 +or +.LR "term 2621" ; +see +.IR term (9.1). +It displays a form with the same fields as +.I telno. +Fill in one or more fields, using tabs to move (circularly) between them, +backspace to erase, and space +to delete a field. +Upon carriage return a group of answers is displayed. +Type +.L ? +instead of a name to get more instructions. +.SH EXAMPLES +In these examples, +.L \et +represents a literal tab. +.TP +.L +telno emlin +Anyone named Emlin. +.TP +.L +telno '\et\et\et3744' +Anyone whose phone extension is 3744. +.TP +.L +telno 'e*\et\et\et\et\et\et\etresearch!*' +Anyone whose last name begins with E and +who gets electronic mail on machine +.LR research . +.SH FILES +.FR $HOME/lib/tel +.br +.F /usr/lib/tel +.SH SEE ALSO +.I bellcat +in +.IR library (7), +.IR pq (7) +.SH BUGS +The algorithm used by +.I dq +(and hence +.IR telno ) +to match each field is distinct and unknown to us. +.br +Not all entries have electronic mail addresses. diff --git a/static/v10/man7/telno.7 b/static/v10/man7/telno.7 new file mode 100644 index 00000000..16d13ef1 --- /dev/null +++ b/static/v10/man7/telno.7 @@ -0,0 +1,43 @@ +.TH TELNO 7 +.SH NAME +telno \- retrieve from bell labs phone book +.SH SYNOPSIS +.B telno +[ +.I datum ... datum +] +.SH DESCRIPTION +.PP +If there are no arguments on the command line, +.I telno +reads its arguments, one to a line, +from the standard input. +Arguments are names, +phone numbers, +or organization numbers, +possibly preceded by a keyword and an equal sign. +The first character of a name must be a letter, +of a phone number or organization number a digit. +Otherwise regular expressions +.I a la +.IR grep (1) +are accepted. +Names are prefixes of last names, or the last name followed +by a comma and one initial. +.PP +Giving a name, a phone number, or an organization number +.I (org=127) +produces +white pages information. +.SH SEE ALSO +.IR tel (7) +.SH DIAGNOSTICS +.I too long +means that the given name has more letters than any +name in the phone book. +(All the names are truncated to 8 characters before the data +arrives on the machine.) +.I None +is printed when there are no matches. +.SH BUGS +The phone book is badly out of date. diff --git a/static/v10/man7/tmheader.7 b/static/v10/man7/tmheader.7 new file mode 100644 index 00000000..c0d92985 --- /dev/null +++ b/static/v10/man7/tmheader.7 @@ -0,0 +1,15 @@ +.th TMHEADER VII 10/20/73 +.sh NAME +tmheader \*- TM cover sheet +.sh SYNOPSIS +.bd "ed /usr/pub/tmheader" +.sh DESCRIPTION +.it /usr/pub/tmheader +contains a prototype for making a +.it troff(I) +formatted cover sheet for a technical memorandum. +Parameters to be filled in by the user are marked by self-explanatory names +beginning with ``---''. +.sh BUGS +God help you on two-page abstracts. +Try to write less. diff --git a/static/v10/man7/town.7 b/static/v10/man7/town.7 new file mode 100644 index 00000000..7cce5cbb --- /dev/null +++ b/static/v10/man7/town.7 @@ -0,0 +1,33 @@ +.TH TOWN 7 alice +.CT 1 inst_info +.SH NAME +town \- gazetteer of US places +.SH SYNOPSIS +.B town +[ +.I place +] +.SH DESCRIPTION +.I Town +produces information about the +.I place, +which is the name of a US town, possibly followed by a comma +and a two-letter state abbreviation. +If no +.I place +is given, place names are read one per line from the +standard input. +.PP +The information produced is latitude, longitude, approximate +population, a forecast from +.IR weather (7), +and a recent item from +.IR apnews (7). +.SH FILES +.F /usr/spool/town/ustown* +gazetteer in +.IR cbt (1) +format +.SH SEE ALSO +.IR av (A), +.IR dict (7) diff --git a/static/v10/man7/units.7 b/static/v10/man7/units.7 new file mode 100644 index 00000000..445c2196 --- /dev/null +++ b/static/v10/man7/units.7 @@ -0,0 +1,140 @@ +.if n .ds / / +.if t .ds / \z/\h'\w'*'u' +.TH UNITS 7 +.CT 1 inst_info +.SH NAME +units \- conversion program +.SH SYNOPSIS +.B units +.SH DESCRIPTION +.I Units +converts quantities expressed +in various standard scales to +their equivalents in other scales. +It works interactively in this fashion: +.PP +.EX +You have: inch +You want: cm +* 2.54 +/ 0.393701 +.EE +.PP +Quantities are specified using the following grammar: +.TP +.IR Unit : +.I Empty +|\| +.I Unit Term +|\| +.IB Unit " / " Term +.TP +.IR Term : +.I Number +|\| +.I Name +|\| +.BI ( " Unit " ) +|\| +.br +.BI square " Term +|\| +.BI sq " Term +|\| +.BI cube " Term +|\| +.BI cu " Term +|\| +.br +.IB Term " ^ " Number +.ig +.PP +\fIUnit\fP: \fIEmpty\fP + \fIUnit\fP \fITerm\fP + \fIUnit\fP \fL/\fP \fITerm\fP +\fITerm\fP: \fINumber\fP + \fIName\fP + \fL(\fP \fIUnit\fP \fL)\fP + \fLsquare\fP \fITerm\fP + \fLsq\fP \fITerm\fP + \fLcube\fP \fITerm\fP + \fLcu\fP \fITerm\fP + \fITerm\fP \fL^\fP \fINumber\fP +.fi +.. +.PP +Numbers are specified in the form expected by +.IR atof (3). +Names are maximal strings of non-numeric, non-punctuation characters. +Powers are indicated by the +.L ^ +operator or by the words +.L square +.RL ( sq ) +and +.L cube +.RL ( cu ). +Parentheses alter grouping. +The empty unit has value 1. +Terms are multiplied together unless connected by +.L / +for inversion, e.g. +.LR "15 pounds force/sq in" . +.PP +Most familiar units, +abbreviations, and metric prefixes are recognized, +together with a generous leavening of exotica +and a few constants of nature including: +.IP +.de fq +\f5\\$1\\fP \\$2 \\$3 \\$4 \\$5 \\$6 +.. +.nf +.fq pi ratio of circumference to diameter +.fq c speed of light +.fq e charge on an electron +.fq g acceleration of gravity +.fq force same as \f5g\fP +.fq mole Avogadro's number +.fq water "pressure head per unit height of water" +.fq au astronomical unit +.fi +.PP +The +.L pound +is a unit of +mass. +Compound names are run together, e.g. +.LR lightyear . +British units that differ from their US counterparts +are prefixed thus: +.LR brgallon . +Currency is denoted +.LR belgiumfranc , +.LR britainpound , +etc. +.PP +A response of +.L ? +to `You want:' displays all known units +conformable with the `You have:' quantity. +.PP +The complete list of units can be found in +.F /usr/lib/Units +and +.FR /n/alice/usr/td/Monetary.units . +.SH FILES +.F /usr/lib/Units +.br +.F /n/alice/usr/td/Monetary.units +.br +.F /usr/lib/Units.bin +.SH BUGS +Since +.I units +does only multiplicative scale changes, +it can convert Kelvin to Rankine, but not Centigrade to +Fahrenheit. +.br +Currency conversions are only as accurate as the most recent report of +foreign exchange prices from the AP wire. diff --git a/static/v10/man7/vs.7 b/static/v10/man7/vs.7 new file mode 100644 index 00000000..daa3b20f --- /dev/null +++ b/static/v10/man7/vs.7 @@ -0,0 +1,58 @@ +.th VS VII 9/4/73 +.sh NAME +vs \*- voice synthesizer code +.sh DESCRIPTION +The octal codes below +are understood by the Votrax\*r voice synthesizer. +Inflection and phonemes +are or-ed together. +The mnemonics in the first column are used by +.it speak +(I); +the upper case mnemonics are used +by the manufacturer. +.sp +.if t .ta 0.3i 0.6i 3.0i 3.3i 3.6i +.if n .ta 5 10 31 35 40 +.if n .ds 2 __ +.if t .ds 2 \\fR +.if n .ds 1 _ +.if t .ds 1 \\fR +.nf +0 300 4\*-strong inflection u0 014 UH\*-b\fBu\*1t +1 200 3 u1 015 UH1\*-\fBu\*1ncle +2 100 2 u2 016 UH2\*-stirr\fBu\*1p +3 000 1\*-weak inflection u3 034 UH3\*-app\*_le ab\*_le + yu 027 U\*-\fBu\*1se +a0 033 AH\*-c\fBo\*1ntact iu 010 U1\*-\fBu\*1nite(,y1,iu,...) +a1 052 AH1\*-c\fBo\*1nnect ju 011 IU\*-n\fBew\*2 +aw 002 AW\*-l\fBaw\*2(,l,u2,aw) b 061 B +au 054 AW1\*-f\fBau\*2lt d 041 D +ae 021 AE\*-c\fBa\*1t f 042 F +ea 020 AE1\*-\fBa\*1ntenna g 043 G +ai 037 A\*-n\fBa\*1me(,n,ai,y0,m) h 044 H +aj 071 A1\*-n\fBa\*1mely k 046 K +e0 004 EH\*-m\fBe\*1t \fBe\*1nter l 047 L +e1 076 EH1\*-s\fBe\*1ven m 063 M +e2 077 EH2\*-sev\fBe\*1n n 062 N +er 005 ER\*-weath\fBer\*2 p 032 P +eu 073 OOH\*-G\fBoe\*2the chev\fBeu\*2x q 075 Q +eh 067 EHH\*-l\fBe\*1 ch\fBe\*1veux r 024 R +y0 023 EE\*-thr\fBee\*2 s 040 S +y1 026 Y\*-sixt\fBy\*1 t 025 T +y2 035 Y1\*-\fBy\*1es v 060 V +ay 036 AY\*-ma\fBy\*1 w 022 W +i0 030 I\*-s\fBi\*1x z 055 Z +i1 064 I1\*-\fBi\*1nept \fBi\*1nside sh 056 SH\*-\fBsh\*2ow \fBsh\*2ip +i2 065 I2\*-stat\fBi\*1c zh 070 ZH\*-plea\fBs\*1ure +iy 066 IY\*-cr\fBy\*1(,k,r,a0,iy) j 045 J\*-edge\fB\*1 +ie 003 IE\*-z\fBe\*1ro ch 057 CH\*-bat\fBch\*2 +ih 072 IH\*-stat\fBi\*1on th 006 TH\*-\fBth\*2in +o0 031 O\*-\fBo\*1nly n\fBo\*1 dh 007 THV\*-\fBth\*2en +o1 012 O1\*-hell\fBo\*1 ng 053 NG\*-lo\fBng\*2 i\fBn\*1k +o2 013 O2\*-n\fBo\*1tice \*-0 017 PA2\*-long pause +ou 051 OO1\*-g\fBoo\*2d sh\fBou\*2ld \*-1 001 PA1 +oo 050 OO\*-l\fBoo\*2k \*-2 074 PA0\*-short pause +.sp +.sh "SEE ALSO" +speak(I), vs(IV) diff --git a/static/v10/man7/vsp.7 b/static/v10/man7/vsp.7 new file mode 100644 index 00000000..57315f4b --- /dev/null +++ b/static/v10/man7/vsp.7 @@ -0,0 +1,61 @@ +.pa 1 +.he 'VSP (VII)'2/2/73'VSP (VII)' +.ti 0 +NAME vsp -- voice synthesizer code +.sp +.ti 0 +SYNOPSIS cat /usr/pub/vsp +.sp +.ti 0 +DESCRIPTION vsp___ +contains a list of phonemes understood by the voice +synthesizer on device vt__. +Phonemes are usually written in the form + +.ce +comma inflection phoneme +.sp +The inflection and the phoneme codes are or-ed together. +The phoneme codes are as follows (numbers in octal). + +.nf +.in 6 +0 = 300 strong inflection p = 32 p_enny p_ound +1 = 200 a0 = 33 co_ntact ca_r +2 = 100 a1 = 52 co_nnect +3 = 000 weak inflection ai = 37 na_me ca_me + aj = 71 na_mely +aw = 02 aw__ful law__ s = 40 s_even s_ix +ie = 03 zer__o d = 41 d_o d_iet +e0 = 04 e_nter me_t f = 42 f_our f_ive +e1 = 76 se_ven g = 43 g_et g_rand +e2 = 77 seve_n h = 44 h_ello h_ow +er = 05 weather__ j = 45 j_udge edg_e +th = 06 th__ree th__ick k = 46 c_ame lock_ +dh = 07 th__is th__en l = 47 hell__o l_ight +yu = 27 u_se you_ oo = 50 loo__k boo__k +iu = 10 u_nite ou = 51 goo__d shou__d +ju = 11 ne_w yo_u ng = 53 ring__ ang__le +o0 = 31 o_nly no_ z = 55 z_ero haz_y +o1 = 12 hello_ sh = 56 sh__ow sh__ip +o2 = 13 no_tice ch = 57 ch__air ch__ime +u0 = 14 bu_t mu_st v = 60 sev_en ev_en +u1 = 15 u_ncle b = 61 b_all b_ed +u2 = 16 stirru_p n = 62 n_in_e seven_ +u3 = 34 app_le ab_le m = 63 m_ile m_en +ae = 21 ca_t sa_t iy = 66 lie__ +ea = 20 a_ntenna zh = 70 az_ure pleas_ure +w = 22 w_on w_ish ih = 72 statio__n conditio__n +ee = 23 three__ ay = 36 may_ lay_ +r = 24 r_adio r_adar_ +t = 25 t_wo t_ime -0 = 35 long space +ey = 26 sixty_ eighty_ -1 = 17 +i0 = 30 si_x mi_x -2 = 01 +i1 = 64 i_nept i_nside -3 = 74 short delay +i2 = 65 crypti_c stati_c +.in 16 +.fi + +.sp +.ti 0 +SEE ALSO speak(I), vt(IV) diff --git a/static/v10/man7/weather.7 b/static/v10/man7/weather.7 new file mode 100644 index 00000000..89a9e930 --- /dev/null +++ b/static/v10/man7/weather.7 @@ -0,0 +1,45 @@ +.TH WEATHER 7 alice +.CT 1 inst_info +.SH NAME +weather \- conditions and forecast by town +.SH SYNOPSIS +.B weather +[ +.B -h +] +[ +.B -m +] +.SH DESCRIPTION +.I Weather +reports current weather conditions and a forecast for towns +in the contiguous United States. +It reads town names from the standard input, one per line. +Each input line should be in the style of +.IP +.L walla walla, wa +.LP +where the state is given as the 2-letter Post Office abbreviation. +.PP +The information provided is the temperature, humidity, whether or not it +is raining or snowing, and an indication of cloudiness and visibility +if it is not. +If the wind is above 10 knots the wind speed and +direction are given. +Up to three forecasts are given (assuming they can be found within +a 4\(mu4 degree latitude-longitude square): a forecast of high +and low temperatures plus probability of precipitation taken from +some numerical model of the atmosphere, a general area forecast +and a marine forecast (if near the coast and if the +.B -m +argument is given). +.PP +The command +.B "weather -h" +is equivalent to +.L weather +followed by a single input +line of +.LR "murray hill, nj" . +.SH SEE ALSO +.IR avw (A) diff --git a/static/v10/man7/wx.7 b/static/v10/man7/wx.7 new file mode 100644 index 00000000..023f0a63 --- /dev/null +++ b/static/v10/man7/wx.7 @@ -0,0 +1,90 @@ +.TH WX 7 +.SH NAME +wx - get weather information +.SH SYNOPSIS +.B wx +[ +.B -cemnoOs +] +[ +.B -a +.I state +] +.SH DESCRIPTION +.I Wx +writes the local (greater New York and Philadelphia) +weather forecast. +.PP +The following options are available: +.TP 15 +.B \-e +Print only the extended forecasts. +.TP 15 +.B \-m +Print the marine weather and forecast, +which gives coastal and offshore information +(winds, tides, wave heights, visibilities, etc.) +for an area from Watch Hill, R.I. to Manasquan, +N.J. +.TP 15 +.B \-c +Print a summary of temperatures and weather +for selected U.S. cities. +.TP 15 +.B \-n +Print the national weather summary. +.TP 15 +.B \-s +Print ski conditions +for New York and New England. +.TP 15 +.B \-oO +Print the previous +.B (-o) +and oldest avalable +.B (-O) +national weather summaries. +.TP 15 +\fB \-a\fI state \fR +(where +.I state +is a two-letter, lower case +state abbreviation) Print (cat) an +area forecast (if available) for any state requested +in the continental U.S.; e.g. +.I +wx -a mi +will print the state forecast for Michigan. +The required 2-letter abbreviation for any +state may be found by typing, +.I +wx -a ?. +.PP +Except for +.I +wx -a, +all information is printed under the +.I +p +command. +For details of +.I p, +refer to the manual page. +.SH FILES +.TP 30 +/usr/lbin/wx +.TP 30 +/usr/pub/weather/* +weather and forecast files, updated daily +.SH BUGS +What comes out is +only as good as +what went in. If the +information you are +requesting was not sent +over the weather line, you +will get no meaningful output. +If information over the line +came in with faulty separator +codes, you will get strange, +often cryptic, output. |