home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / gnu / gawk213b / pass1.out < prev    next >
Encoding:
Text File  |  1993-07-29  |  14.7 KB  |  910 lines
  1. .^x /tmp/awe16087
  2. .^b
  3. .^# 1 <prolog>
  4. .\" Device-dependent but not macro-set-dependent definitions.
  5. .\" --------------------------------
  6. .\" overall formatting initialization
  7. .\" 12 cpi horizontal exploits 80-column terminal well (6.5i@12 = 78)
  8. .^r cpi 12 6
  9. .\" call margin adjustment device-dependent for sake of some unusual cases
  10. .ad
  11. .\" page parameters
  12. .pl 11i
  13. .ll 6.5i
  14. .po 0
  15. .\" --------------------------------
  16. .\" fonts, and their hyphens, last font change doubled to set up \fP
  17. .^f R
  18. .ft R
  19. .^c hy 1 -
  20. .^f I
  21. .ft I
  22. .^c hy 1 -
  23. .^f B
  24. .ft B
  25. .^c hy 1 -\b-\b-
  26. .ft R
  27. .ft R
  28. .\" --------------------------------
  29. .\" definitions of nroff special characters
  30. .\" The character definitions here operate on the "better ugly than invisible"
  31. .\" principle, and try to approximate the character *somehow*.  They were
  32. .\" tuned for a Teletype 40 line printer, but should give vaguely plausible
  33. .\" results on any overprinting ASCII device.
  34. .\"
  35. .\" first, things that nroff considered builtins
  36. .^c \ 1 \\
  37. .^c e 1 \\
  38. .^c ' 1 '
  39. .^c ` 1 `
  40. .^c - 1 -
  41. .\" some things seem to assume that \+ is like \-
  42. .^c + 1 +
  43. .\" we do not do backslash-space here, it can't be done with .^c, but the
  44. .\" other forms of space we can do
  45. .^c 0 1 " 
  46. .^c | 0
  47. .^c ^ 0
  48. .^c & 0
  49. .\"
  50. .\" and more normal characters
  51. .\" note, the hyphenation logic knows about em
  52. .^c em 2 --
  53. .\" hy is a special case, see above
  54. .^c bu 1 +\bo
  55. .^c sq 2 []
  56. .^c ru 1 _
  57. .^c 12 3 1/2
  58. .^c 14 3 1/4
  59. .^c 34 3 3/4
  60. .^c de 1 '\b`
  61. .^c dg 1 -\b!
  62. .^c fm 1 '
  63. .^c ct 1 /\bc
  64. .^c rg 3 (R)
  65. .^c co 3 (c)
  66. .^c pl 1 +
  67. .^c mi 1 -
  68. .^c eq 1 =
  69. .^c ** 1 *
  70. .^c sc 1 j\bf
  71. .^c aa 1 '
  72. .^c ga 1 `
  73. .^c ul 1 _
  74. .^c sl 1 /
  75. .^c *a 1 <\ba
  76. .^c *b 1 ,\bB
  77. .^c *g 1 ,\by
  78. .^c *d 1 S\bo
  79. .^c *e 1 -\bc
  80. .^c *z 1 ,\bL
  81. .^c *y 1 ,\bn
  82. .^c *h 1 -\b0
  83. .^c *i 1 ,\bi
  84. .^c *k 1 <\bK
  85. .^c *l 1 \\\b>
  86. .^c *m 1 ,\bu
  87. .^c *n 1 ,\bv
  88. .^c *c 1 ,\b3
  89. .^c *o 1 o
  90. .^c *p 1 -\bn
  91. .^c *r 1 p
  92. .^c *s 1 -\bo
  93. .^c ts 1 s
  94. .^c *t 1 ~\bt
  95. .^c *u 1 u
  96. .^c *f 1 /\bo
  97. .^c *x 1 /\b\\
  98. .^c *q 1 |\bu
  99. .^c *w 1 u\bw
  100. .^c *G 2 ~\b|~
  101. .^c *D 2 _\b/_\b\\
  102. .^c *H 1 -\bO
  103. .^c *L 2 /\\
  104. .^c *C 1 _\b-\b~
  105. .^c *P 2 ~\b|~\b|
  106. .^c *S 1 ~\b_\b>
  107. .^c *U 1 Y
  108. .^c *F 1 |\bO
  109. .^c *Q 1 |\bU
  110. .^c *W 2 _\b(_\b)
  111. .^c sr 2 \\/
  112. .^c rn 1 ~
  113. .^c >= 1 _\b>
  114. .^c <= 1 _\b<
  115. .^c == 1 _\b=
  116. .^c ~= 1 ~\b=
  117. .^c ap 1 ~
  118. .^c != 1 /\b=
  119. .^c -> 2 ->
  120. .^c <- 2 <-
  121. .^c ua 1 |\b^
  122. .^c da 1 |\bv
  123. .^c mu 1 x
  124. .^c di 1 -\b:
  125. .^c +- 1 _\b+
  126. .^c cu 1 U
  127. .^c ca 3 (^)
  128. .^c sb 2 (_\b~
  129. .^c sp 2 _\b~)
  130. .^c ib 2 (~\b_\b=
  131. .^c ip 2 ~\b_\b=)
  132. .^c if 2 oo
  133. .^c pd 1 3\bo
  134. .^c gr 1 ~\bV
  135. .^c no 1 -
  136. .^c is 1 '\b,\bI
  137. .^c pt 2 oc
  138. .^c es 1 /\bO
  139. .^c mo 1 -\bC
  140. .^c br 1 |
  141. .^c dd 1 I\b|
  142. .^c rh 1 =\b>
  143. .^c lh 1 =\b<
  144. .^c bs 4 (:-)
  145. .^c or 1 |
  146. .^c ci 1 O
  147. .^c lt 1 ~\b(
  148. .^c lb 1 _\b(
  149. .^c rt 1 ~\b)
  150. .^c rb 1 _\b)
  151. .^c lk 1 -\b(
  152. .^c rk 1 -\b)
  153. .^c bv 1 |
  154. .^c lf 1 _\b[
  155. .^c rf 1 _\b]
  156. .^c lc 1 ~\b[
  157. .^c rc 1 ~\b]
  158. .\" Common startup code, fully device-independent.
  159. .\" --------------------------------
  160. .fi
  161. .ce 0
  162. .ta +5 +5 +5 +5 +5 +5 +5 +5 +5 +5 +5 +5 +5 +5 +5 +5 +5 +5 +5 +5 +5 +5 +5 +5 +5
  163. .in 0
  164. .ti 0
  165. .\"-----------------
  166. .^# 171 <prolog>
  167. .\"-----------------
  168. .^# 176 <prolog>
  169. .\"-----------------
  170. .^# 181 <prolog>
  171. .\"-----------------
  172. .^# 185 <prolog>
  173. .\"-----------------
  174. .\" common initialization for headers and paragraphs:  .In need
  175. .^# 197 <prolog>
  176. .\"-----------------
  177. .^# 207 <prolog>
  178. .\"-----------------
  179. .^# 211 <prolog>
  180. .\"-----------------
  181. .^# 215 <prolog>
  182. .\"-----------------
  183. .^# 219 <prolog>
  184. .\"-----------------
  185. .^# 224 <prolog>
  186. .\"-----------------
  187. .^# 232 <prolog>
  188. .\"-----------------
  189. .^# 238 <prolog>
  190. .\"-----------------
  191. .^# 244 <prolog>
  192. .\"-----------------
  193. .^# 250 <prolog>
  194. .\"-----------------
  195. .^# 254 <prolog>
  196. .\"-----------------
  197. .^# 258 <prolog>
  198. .\"-----------------
  199. .^# 262 <prolog>
  200. .\"-----------------
  201. .^# 266 <prolog>
  202. .\"-----------------
  203. .^# 270 <prolog>
  204. .\"-----------------
  205. .^# 274 <prolog>
  206. .\"-----------------
  207. .^# 279 <prolog>
  208. .\"-----------------
  209. .^# 283 <prolog>
  210. .\"-----------------
  211. .^# 287 <prolog>
  212. .\"-----------------
  213. .^# 291 <prolog>
  214. .\"-----------------
  215. .^# 296 <prolog>
  216. .\"-----------------
  217. .\" misc. initialization
  218. .nr tp 5n
  219. .^= 299 <prolog>
  220. .nr PD 0.3v
  221. .^# 300 <prolog>
  222. .ds R \(rg
  223. .ds S "
  224. .ds Tm (TM)
  225. .^# 1 awf.1
  226. .\" Some of the stuff in this file is a bit contorted, because it's also
  227. .\" the regression-test input.
  228. .nr ES 5n
  229. .^# 9 awf.1
  230. .^# 14 awf.1
  231. .^# 20 awf.1
  232. .ds Nr \fInroff\fR
  233. .^= 21 awf.1
  234. .ds LH "AWF(1)
  235. .ds CH "Unix Programmer's Manual
  236. .ds RH "AWF(1)
  237. .ds LF "
  238. .ds CF "13 July 1990
  239. .ds RF "%
  240. .^# 22 awf.1
  241. .^= 22 awf.1
  242. .ds by "U of Toronto
  243. .lF
  244. .^# 23 awf.1
  245. .^= 23 awf.1
  246. .ne 6
  247. .sp \n(PDu
  248. .fi
  249. .in \n(inu
  250. .ti 0
  251. .it
  252. .ft R
  253. .ns
  254. .in 0
  255. .ft B
  256. \&NAME        
  257. .ft R
  258. .nr in 5n
  259. .in \n(inu
  260. .^# 24 awf.1
  261. awf \- amazingly workable (text) formatter
  262. .^= 25 awf.1
  263. .ne 6
  264. .sp \n(PDu
  265. .fi
  266. .in \n(inu
  267. .ti 0
  268. .it
  269. .ft R
  270. .ns
  271. .in 0
  272. .ft B
  273. \&SYNOPSIS        
  274. .ft R
  275. .nr in 5n
  276. .in \n(inu
  277. .^# 26 awf.1
  278. .^= 26 awf.1
  279. .ft B
  280. .it 1 fP
  281. \&awf        
  282. .^# 27 awf.1
  283. .^= 27 awf.1
  284. \&\fB\-m\fIacros\fB\fI\fB\fI\fB\fI\fB\fR
  285. .^# 28 awf.1
  286. [ file ] ...
  287. .^= 29 awf.1
  288. .ne 6
  289. .sp \n(PDu
  290. .fi
  291. .in \n(inu
  292. .ti 0
  293. .it
  294. .ft R
  295. .ns
  296. .in 0
  297. .ft B
  298. \&DESCRIPTION        
  299. .ft R
  300. .nr in 5n
  301. .in \n(inu
  302. .^# 30 awf.1
  303. .^= 30 awf.1
  304. .^# 31 awf.1
  305. .^= 31 awf.1
  306. .ft I
  307. .it 1 fP
  308. \&Awf        
  309. .^# 32 awf.1
  310. formats the text from the input \fIfile\fR(s)
  311. (standard input if none)
  312. in an imitation of
  313. \*(Nr's style with the \fB\-man\fR or \fB\-ms\fR macro packages.
  314. The
  315. .^= 37 awf.1
  316. \&\fB\-m\fIacro\fB\fI\fB\fI\fB\fI\fB\fR
  317. .^# 38 awf.1
  318. option is mandatory and must be `\-man' or `\-ms'.
  319. .^= 39 awf.1
  320. .ne 4
  321. .sp \n(PDu
  322. .fi
  323. .in \n(inu
  324. .ti 0
  325. .it
  326. .ft R
  327. .ns
  328. .^# 40 awf.1
  329. .^= 40 awf.1
  330. .ft I
  331. .it 1 fP
  332. \&Awf        
  333. .^# 41 awf.1
  334. implements the following raw \*(Nr requests:
  335. .^= 42 awf.1
  336. .ne 4
  337. .sp \n(PDu
  338. .fi
  339. .in \n(inu
  340. .ti 0
  341. .it
  342. .ft R
  343. .ns
  344. .^# 43 awf.1
  345.     .\e"    .ce    .fi    .in    .ne    .pl    .sp
  346.     .ad    .de    .ft    .it    .nf    .po    .ta
  347.     .bp    .ds    .ie    .ll    .nr    .ps    .ti
  348.     .br    .el    .if    .na    .ns    .rs    .tm
  349. .^= 47 awf.1
  350. .ne 4
  351. .sp \n(PDu
  352. .fi
  353. .in \n(inu
  354. .ti 0
  355. .it
  356. .ft R
  357. .ns
  358. .^# 48 awf.1
  359. and the following in-text codes:
  360. .^= 49 awf.1
  361. .ne 4
  362. .sp \n(PDu
  363. .fi
  364. .in \n(inu
  365. .ti 0
  366. .it
  367. .ft R
  368. .ns
  369. .in +\n(ESu
  370. .nf
  371. .^# 50 awf.1
  372. \e$    \e%    \e*    \ec    \ef    \en    \es
  373. .^= 51 awf.1
  374. .in -\n(ESu
  375. .fi
  376. .ne 4
  377. .sp \n(PDu
  378. .fi
  379. .in \n(inu
  380. .ti 0
  381. .it
  382. .ft R
  383. .ns
  384. .^# 52 awf.1
  385. plus the full list of \*(Nr/\c
  386. .^= 53 awf.1
  387. .ft I
  388. .it 1 fP
  389. \&troff        
  390. .^# 54 awf.1
  391. special characters in
  392. the original V7 \fItroff\fR manual.
  393. .^= 56 awf.1
  394. .ne 4
  395. .sp \n(PDu
  396. .fi
  397. .in \n(inu
  398. .ti 0
  399. .it
  400. .ft R
  401. .ns
  402. .^# 57 awf.1
  403. Many restrictions are present; the behavior in general is a subset of
  404. \*(Nr's.  Of particular note are the following:
  405. .^= 59 awf.1
  406. .ne 4
  407. .sp \n(PDu
  408. .fi
  409. .in \n(inu
  410. .ti 0
  411. .it
  412. .ft R
  413. .ns
  414. .nr tp 2n
  415. .in \n(inu+\n(tpu
  416. .ti 0-\n(tpu
  417. .it 1 tP
  418. \&\(bu
  419. .^# 60 awf.1
  420. Point sizes do not exist;
  421. .^= 61 awf.1
  422. .ft B
  423. .it 1 fP
  424. \&.ps        
  425. .^# 62 awf.1
  426. and
  427. .^= 63 awf.1
  428. .ft B
  429. .it 1 fP
  430. \&\es        
  431. .^# 64 awf.1
  432. are ignored.
  433. .^= 65 awf.1
  434. .ne 4
  435. .sp \n(PDu
  436. .fi
  437. .in \n(inu
  438. .ti 0
  439. .it
  440. .ft R
  441. .ns
  442. .in \n(inu+\n(tpu
  443. .ti 0-\n(tpu
  444. .it 1 tP
  445. \(bu
  446. .^# 66 awf.1
  447. Conditionals implement only numeric comparisons on
  448. .^= 67 awf.1
  449. \&\fB\en(.$\fR,\fB\fR\fB\fR\fB\fR\fB\fR
  450. .^# 68 awf.1
  451. string com\%par\%isons between a macro parameter and a literal,
  452. and
  453. .^= 70 awf.1
  454. .ft B
  455. .it 1 fP
  456. \&n        
  457. .^# 71 awf.1
  458. (always true)
  459. and
  460. .^= 73 awf.1
  461. \&\fBt\fR\fB\fR\fB\fR\fB\fR\fB\fR
  462. .^# 74 awf.1
  463. (always false).
  464. .^= 75 awf.1
  465. .ne 4
  466. .sp \n(PDu
  467. .fi
  468. .in \n(inu
  469. .ti 0
  470. .it
  471. .ft R
  472. .ns
  473. .in \n(inu+\n(tpu
  474. .ti 0-\n(tpu
  475. .it 1 tP
  476. \(bu
  477. .^# 76 awf.1
  478. The implementation of strings is generally primitive.
  479. .^= 77 awf.1
  480. .ne 4
  481. .sp \n(PDu
  482. .fi
  483. .in \n(inu
  484. .ti 0
  485. .it
  486. .ft R
  487. .ns
  488. .in \n(inu+\n(tpu
  489. .ti 0-\n(tpu
  490. .it 1 tP
  491. \&\(bu
  492. .^# 78 awf.1
  493. Expressions in (e.g.)\&
  494. .^= 79 awf.1
  495. .ft B
  496. .it 1 fP
  497. \&.sp        
  498. .^# 80 awf.1
  499. are fairly general, but the
  500. .^= 81 awf.1
  501. \&\fB|\fR,\fB\fR\fB\fR\fB\fR\fB\fR
  502. .^# 82 awf.1
  503. .^= 82 awf.1
  504. \&\fB&\fR,\fB\fR\fB\fR\fB\fR\fB\fR
  505. .^# 83 awf.1
  506. and
  507. .^= 84 awf.1
  508. \&\fB:\&\fR\fB\fR\fB\fR\fB\fR\fB\fR
  509. .^# 85 awf.1
  510. operators do not exist, and the implementation of
  511. .^= 86 awf.1
  512. .ft B
  513. .it 1 fP
  514. \&\ew        
  515. .^# 87 awf.1
  516. requires that quote (') be used as the delimiter and
  517. simply counts the characters inside (so that, e.g.,
  518. \ew'\e(bu'
  519. equals 4).
  520. .^= 91 awf.1
  521. .ne 4
  522. .sp \n(PDu
  523. .fi
  524. .in \n(inu
  525. .ti 0
  526. .it
  527. .ft R
  528. .ns
  529. .^# 92 awf.1
  530. White space at the beginning of lines,
  531. and imbedded white space within lines, is dealt with properly.
  532. Sentence terminators at ends of lines are understood to imply
  533. extra space afterward in filled lines.
  534. Tabs are im\%plemented crudely and not quite correctly, although
  535. in most cases they work as expected.
  536. Hyphenation is done only at explicit hyphens, em-dashes, and \*(Nr
  537. discretionary hyphens.
  538. .^= 100 awf.1
  539. .ne 6
  540. .sp \n(PDu
  541. .fi
  542. .in \n(inu
  543. .ti 0
  544. .it
  545. .ft R
  546. .ns
  547. .in 0
  548. .ft B
  549. \&MAN MACROS        
  550. .ft R
  551. .nr in 5n
  552. .in \n(inu
  553. .^# 101 awf.1
  554. The
  555. .^= 102 awf.1
  556. .ft B
  557. .it 1 fP
  558. \&\-man        
  559. .^# 103 awf.1
  560. macro set implements the full V7 manual macros,
  561. plus a few semi-random oddballs.
  562. The full list is:
  563. .^= 106 awf.1
  564. .ne 4
  565. .sp \n(PDu
  566. .fi
  567. .in \n(inu
  568. .ti 0
  569. .it
  570. .ft R
  571. .ns
  572. .in +\n(ESu
  573. .nf
  574. .^# 107 awf.1
  575. \&.B    .DT    .IP    .P    .RE    .SM
  576. \&.BI    .HP    .IR    .PD    .RI    .TH
  577. \&.BR    .I    .LP    .PP    .RS    .TP
  578. \&.BY    .IB    .NB    .RB    .SH    .UC
  579. .^= 111 awf.1
  580. .in -\n(ESu
  581. .fi
  582. .ne 4
  583. .sp \n(PDu
  584. .fi
  585. .in \n(inu
  586. .ti 0
  587. .it
  588. .ft R
  589. .ns
  590. .^# 112 awf.1
  591. .^= 112 awf.1
  592. .ft B
  593. .it 1 fP
  594. \&.BY        
  595. .^# 113 awf.1
  596. and
  597. .^= 114 awf.1
  598. .ft B
  599. .it 1 fP
  600. \&.NB        
  601. .^# 115 awf.1
  602. each take a single string argument (respectively, an indi\%cation of
  603. authorship and a note about the status of the manual page) and arrange
  604. to place it in the page footer.
  605. .^= 118 awf.1
  606. .ne 6
  607. .sp \n(PDu
  608. .fi
  609. .in \n(inu
  610. .ti 0
  611. .it
  612. .ft R
  613. .ns
  614. .in 0
  615. .ft B
  616. \&MS MACROS        
  617. .ft R
  618. .nr in 5n
  619. .in \n(inu
  620. .^# 119 awf.1
  621. The
  622. .^= 120 awf.1
  623. .ft B
  624. .it 1 fP
  625. \&\-ms        
  626. .^# 121 awf.1
  627. macro set is a substantial subset of the V7 manuscript macros.
  628. The implemented macros are:
  629. .^= 123 awf.1
  630. .ne 4
  631. .sp \n(PDu
  632. .fi
  633. .in \n(inu
  634. .ti 0
  635. .it
  636. .ft R
  637. .ns
  638. .in +\n(ESu
  639. .nf
  640. .^# 124 awf.1
  641. \&.AB    .CD    .ID    .ND    .QP    .RS    .UL
  642. \&.AE    .DA    .IP    .NH    .QS    .SH    .UX
  643. \&.AI    .DE    .LD    .NL    .R    .SM
  644. \&.AU    .DS    .LG    .PP    .RE    .TL
  645. \&.B    .I    .LP    .QE    .RP    .TP
  646. .^= 129 awf.1
  647. .in -\n(ESu
  648. .fi
  649. .ne 4
  650. .sp \n(PDu
  651. .fi
  652. .in \n(inu
  653. .ti 0
  654. .it
  655. .ft R
  656. .ns
  657. .^# 130 awf.1
  658. Size changes are recognized but ignored, as are
  659. .^= 131 awf.1
  660. .ft B
  661. .it 1 fP
  662. \&.RP        
  663. .^# 132 awf.1
  664. and
  665. .^= 133 awf.1
  666. \&\fB.ND\fR.\fB\fR\fB\fR\fB\fR\fB\fR
  667. .^# 134 awf.1
  668. .^= 134 awf.1
  669. .ft B
  670. .it 1 fP
  671. \&.UL        
  672. .^# 135 awf.1
  673. just prints its argument in italics.
  674. .^= 136 awf.1
  675. \&\fB.DS\fR/\fB.DE\fR\fB\fR\fB\fR\fB\fR
  676. .^# 137 awf.1
  677. does not do a keep,
  678. nor do any of the other macros that normally imply keeps.
  679. .^= 139 awf.1
  680. .ne 4
  681. .sp \n(PDu
  682. .fi
  683. .in \n(inu
  684. .ti 0
  685. .it
  686. .ft R
  687. .ns
  688. .^# 140 awf.1
  689. Assignments to the header/footer string variables are recognized and
  690. implemented, but there is otherwise no control over header/footer
  691. formatting.
  692. The
  693. .^= 144 awf.1
  694. .ft B
  695. .it 1 fP
  696. \&DY        
  697. .^# 145 awf.1
  698. string variable is available.
  699. The
  700. .^= 147 awf.1
  701. \&\fBPD\fR,\fB\fR\fB\fR\fB\fR\fB\fR
  702. .^# 148 awf.1
  703. .^= 148 awf.1
  704. \&\fBPI\fR,\fB\fR\fB\fR\fB\fR\fB\fR
  705. .^# 149 awf.1
  706. and
  707. .^= 150 awf.1
  708. \&\fBLL\fR\fB\fR\fB\fR\fB\fR\fB\fR
  709. .^# 151 awf.1
  710. number registers exist and can be changed.
  711. .^= 152 awf.1
  712. .ne 6
  713. .sp \n(PDu
  714. .fi
  715. .in \n(inu
  716. .ti 0
  717. .it
  718. .ft R
  719. .ns
  720. .in 0
  721. .ft B
  722. \&OUTPUT        
  723. .ft R
  724. .nr in 5n
  725. .in \n(inu
  726. .^# 153 awf.1
  727. The only output format supported by
  728. .^= 154 awf.1
  729. \&\fIawf\fR,\fI\fR\fI\fR\fI\fR\fI\fR
  730. .^# 155 awf.1
  731. in its distributed form,
  732. is that appropriate to a dumb terminal,
  733. using overprinting for italics (via underlining) and bold.
  734. The \*(Nr special characters are printed as some vague approximation
  735. (it's sometimes very vague) to their correct appearance.
  736. .^= 160 awf.1
  737. .ne 4
  738. .sp \n(PDu
  739. .fi
  740. .in \n(inu
  741. .ti 0
  742. .it
  743. .ft R
  744. .ns
  745. .^# 161 awf.1
  746. .^= 161 awf.1
  747. \&\fIAwf\fR's\fI\fR\fI\fR\fI\fR\fI\fR
  748. .^# 162 awf.1
  749. knowledge of the output device is established by a device file,
  750. which is read before the user's input.
  751. It is sought in
  752. .^= 165 awf.1
  753. \&\fIawf\fR's\fI\fR\fI\fR\fI\fR\fI\fR
  754. .^# 166 awf.1
  755. library directory, first as
  756. .^= 167 awf.1
  757. \&\fBdev.\fIterm\fB\fI\fB\fI\fB\fI\fB\fR
  758. .^# 168 awf.1
  759. (where \fIterm\fR is the value of the TERM environment variable)
  760. and, failing that, as
  761. .^= 170 awf.1
  762. \&\fBdev.dumb\fR.\fB\fR\fB\fR\fB\fR\fB\fR
  763. .^# 171 awf.1
  764. The device file
  765. uses special internal commands
  766. to set up resolution, special characters, fonts, etc.,
  767. and more normal \*(Nr commands to set up page length etc.
  768. .^= 175 awf.1
  769. .ne 6
  770. .sp \n(PDu
  771. .fi
  772. .in \n(inu
  773. .ti 0
  774. .it
  775. .ft R
  776. .ns
  777. .in 0
  778. .ft B
  779. \&FILES        
  780. .ft R
  781. .nr in 5n
  782. .in \n(inu
  783. .^# 176 awf.1
  784. All in \fI/usr/lib/awf\fR (this can be overridden by the AWFLIB
  785. environment variable):
  786.  
  787. .ta \w'pass2.base'u+((3n-1n)/2u)
  788. .nf
  789. common    common device-independent initialization
  790. dev.*    device-specific initialization
  791. mac.m*    macro packages
  792. pass1    macro substituter
  793. pass2.base    central formatter
  794. pass2.m*    macro-package-specific bits of formatter
  795. pass3    line and page composer
  796. .^= 188 awf.1
  797. .ne 6
  798. .sp \n(PDu
  799. .fi
  800. .in \n(inu
  801. .ti 0
  802. .it
  803. .ft R
  804. .ns
  805. .in 0
  806. .ft B
  807. \&SEE ALSO       
  808. .ft R
  809. .nr in 5n
  810. .in \n(inu
  811. .^# 189 awf.1
  812. awk(1), nroff(1), man(7), ms(7)
  813. .^= 190 awf.1
  814. .ne 6
  815. .sp \n(PDu
  816. .fi
  817. .in \n(inu
  818. .ti 0
  819. .it
  820. .ft R
  821. .ns
  822. .in 0
  823. .ft B
  824. \&DIAGNOSTICS        
  825. .ft R
  826. .nr in 5n
  827. .in \n(inu
  828. .^# 191 awf.1
  829. .na
  830. Unlike
  831. .^= 193 awf.1
  832. \&\fInroff\fR,\fI\fR\fI\fR\fI\fR\fI\fR
  833. .^# 194 awf.1
  834. .^= 194 awf.1
  835. .ft I
  836. .it 1 fP
  837. \&awf        
  838. .^# 195 awf.1
  839. complains whenever it sees unknown commands and macros.
  840. All diagnostics (these and some internal ones) appear on standard error
  841. at the end of the run.
  842. .ad
  843. .^= 199 awf.1
  844. .ne 6
  845. .sp \n(PDu
  846. .fi
  847. .in \n(inu
  848. .ti 0
  849. .it
  850. .ft R
  851. .ns
  852. .in 0
  853. .ft B
  854. \&HISTORY        
  855. .ft R
  856. .nr in 5n
  857. .in \n(inu
  858. .^# 200 awf.1
  859. Written at University of Toronto by Henry Spencer,
  860. more or less as a supplement to the C News project.
  861. .^= 202 awf.1
  862. .ne 4
  863. .sp \n(PDu
  864. .fi
  865. .in \n(inu
  866. .ti 0
  867. .it
  868. .ft R
  869. .ns
  870. .^# 203 awf.1
  871. .ce 99
  872. \(rh None of the above really want to admit it. \(lh
  873. .ce 0
  874. .^= 206 awf.1
  875. .ne 6
  876. .sp \n(PDu
  877. .fi
  878. .in \n(inu
  879. .ti 0
  880. .it
  881. .ft R
  882. .ns
  883. .in 0
  884. .ft B
  885. \&BUGS        
  886. .ft R
  887. .nr in 5n
  888. .in \n(inu
  889. .^# 207 awf.1
  890. There are plenty, but what do you expect for a text formatter
  891. written entirely in (old) \fIawk\fR?
  892. .^= 209 awf.1
  893. .ne 4
  894. .sp \n(PDu
  895. .fi
  896. .in \n(inu
  897. .ti 0
  898. .it
  899. .ft R
  900. .ns
  901. .^# 210 awf.1
  902. The
  903. .^= 211 awf.1
  904. .ft B
  905. .it 1 fP
  906. \&\-ms        
  907. .^# 212 awf.1
  908. stuff has not been checked out very thoroughly.
  909. .^e
  910.