an 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648
  1. .\"
  2. .\" tmac.an - macros for manual pages
  3. .\"
  4. .\" Sccsid @(#)an 2.11 (gritter) 3/18/07
  5. .\"
  6. .\" from Unix 7th Edition /usr/lib/tmac/tmac.an
  7. .\"
  8. .\" Changes by Gunnar Ritter, Freiburg i. Br., Germany, August 2002
  9. .\"
  10. .\" Changes by Carsten Kunze, 2015-2016
  11. .\"
  12. .\" Copyright(C) Caldera International Inc. 2001-2002. All rights reserved.
  13. .\"
  14. .\" Redistribution and use in source and binary forms, with or without
  15. .\" modification, are permitted provided that the following conditions
  16. .\" are met:
  17. .\" Redistributions of source code and documentation must retain the
  18. .\" above copyright notice, this list of conditions and the following
  19. .\" disclaimer.
  20. .\" Redistributions in binary form must reproduce the above copyright
  21. .\" notice, this list of conditions and the following disclaimer in the
  22. .\" documentation and/or other materials provided with the distribution.
  23. .\" All advertising materials mentioning features or use of this software
  24. .\" must display the following acknowledgement:
  25. .\" This product includes software developed or owned by Caldera
  26. .\" International, Inc.
  27. .\" Neither the name of Caldera International, Inc. nor the names of
  28. .\" other contributors may be used to endorse or promote products
  29. .\" derived from this software without specific prior written permission.
  30. .\"
  31. .\" USE OF THE SOFTWARE PROVIDED FOR UNDER THIS LICENSE BY CALDERA
  32. .\" INTERNATIONAL, INC. AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR
  33. .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  34. .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  35. .\" ARE DISCLAIMED. IN NO EVENT SHALL CALDERA INTERNATIONAL, INC. BE
  36. .\" LIABLE FOR ANY DIRECT, INDIRECT INCIDENTAL, SPECIAL, EXEMPLARY, OR
  37. .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  38. .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
  39. .\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  40. .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
  41. .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
  42. .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  43. .do xflag 3
  44. .als am1 am
  45. .als de1 de
  46. .als as1 as
  47. .als ds1 ds
  48. .escoff ; @
  49. .ie n \{\
  50. . nr cR 1
  51. . utf8conv -
  52. . char ' \N39
  53. . char ` \N96
  54. . sentchar .?!
  55. . ns
  56. . nh
  57. . rm hy
  58. . ad l
  59. . rm ad
  60. . nr )I.def 7n
  61. .\}
  62. .el \{\
  63. . ie \*(.Thtml \{\
  64. . nr cR 1
  65. . nh
  66. . rm hy
  67. . \}
  68. . el \{\
  69. . hy 14
  70. . \}
  71. . so /usr/heirloom/lib/doctools/tmac/tmac.gchar
  72. . nr )I.def .5i
  73. .\}
  74. .nr .g 1
  75. .ds la \(la
  76. .ds ra \(ra
  77. .ds lq \(lq
  78. .ds rq \(rq
  79. .ds Tm \(tm
  80. . \" reset the basic page layout
  81. .de }E
  82. . }f
  83. . ad b
  84. . in \\n()Ru+\\n(INu
  85. . ll \\n(LLu
  86. ..
  87. . \" default tabs
  88. .de DT
  89. . ta T .5i
  90. ..
  91. . \" set type font and size
  92. .de }f
  93. . ps \\nS
  94. . ft 1
  95. ..
  96. . \" handle the head of the page
  97. .de }H
  98. . ev 1
  99. . sp .5i
  100. . ft 1
  101. . ps \\nS
  102. . lt \\n(LLu
  103. . lnr longName 0
  104. . ie \w\\*(]H+2n*2+\w\\*(]D>\\n[.lt] \
  105. . tl \\*(]H\\*(]D
  106. . el .tl \\*(]H\\*(]D\\*(]H
  107. . sp .5i
  108. . ev
  109. . ns
  110. ..
  111. . \" handle the foot of the page
  112. .de }F
  113. . ie \n(cR \{\
  114. . pl +5
  115. . fl
  116. . sp 3
  117. . lt \\n(LLu
  118. . tl \\*(]W\\*(]L\\*(]H
  119. . pl \\n(nlu
  120. . \}
  121. . el \{\
  122. . ev 1
  123. . ft 1
  124. . ps \\nS
  125. ' sp .5i
  126. . lt \\n(LLu
  127. . tl \\*(]W\\*(]L%
  128. ' bp
  129. . ev
  130. . \}
  131. ..
  132. .de }M
  133. . }N
  134. . ll \\n(LLu
  135. ..
  136. . \" no runout unless there was a .TH
  137. .de }K
  138. . }N
  139. . pl 1
  140. . ll \\n(LLu
  141. ..
  142. .em }K
  143. . \" set title and heading
  144. .ds TH.DefCatName.1 General Commands Manual
  145. .ds TH.DefCatName.2 System Calls Manual
  146. .ds TH.DefCatName.3 Library Functions Manual
  147. .ds TH.DefCatName.3p Perl Programmers Reference Guide
  148. .ds TH.DefCatName.4 Kernel Interfaces Manual
  149. .ds TH.DefCatName.5 File Formats Manual
  150. .ds TH.DefCatName.6 Games Manual
  151. .ds TH.DefCatName.7 Miscellaneous Information Manual
  152. .ds TH.DefCatName.8 System Manager's Manual
  153. .ds TH.DefCatName.9 Kernel Developer's Manual
  154. .de TH
  155. . PD
  156. . if !(\\nS>0) .nr S 10
  157. . ie (\\nS>10) .vs \\nSp+3p
  158. . el .vs \\nSp+2p
  159. . ie n .nr IN 7n
  160. . el .nr IN .5i
  161. . ie n .nr LL 78n
  162. . el .nr LL \\n(.l
  163. . ds ]H \\$1\|(\|\\$2\|)
  164. . ds ]L \\$3
  165. . ds ]W \\$4
  166. . ie !\\$5 .ds ]D \\$5
  167. . el .if d TH.DefCatName.\\$2 .ds ]D \\*[TH.DefCatName.\\$2]
  168. . ie \n(cR .}H
  169. . el .wh 0 }H
  170. . ie t .wh -1i }F
  171. . el .if !\n(cR .wh -1.167i }F
  172. . ie !\n(cR .em }M
  173. . el \{\
  174. . als bp br
  175. . pl 2000000000u \" pl is signed int
  176. . em }F
  177. . \}
  178. . \" Work around for \{ bug in Pod::Man
  179. . if \n(cR=0&\\n(nl .}H
  180. . }E
  181. . DT
  182. . nr )I \\n[)I.def]
  183. . nr )R 0
  184. . if n .na
  185. . if t .if !\\*[Toc] \{\
  186. . nr Toc 1
  187. . SH CONTENTS
  188. . nr Toc +1
  189. . nf
  190. . so \\*[Toc]
  191. . fi
  192. . \}
  193. ..
  194. . \" section heading
  195. .de SH
  196. . if !\\n(.z .di
  197. . }X 0
  198. . nr )E 2
  199. . lds T \&\\$1
  200. . lds A \\$1
  201. . shift
  202. . while \\n(.$ \{\
  203. . as T " \|\\$1
  204. . as A " \\$1
  205. . shift
  206. . \}
  207. . ie \\n[Toc] \{\
  208. \XPDFMark: BookmarkClosed 0 \\*A\A\\*A\\*T
  209. . if \\n[Toc]>1 \{\
  210. . ie \\*(.Thtml \{\
  211. . tm Toc:\T\\*A\\*T\T
  212. . \}
  213. . el \{\
  214. . lnr Tab \\n(.l-\\n(.i
  215. . tm Toc:.ta \\n[Tab]uR
  216. . tm Toc:\T\\*A\\*T\T\a\\n%
  217. . \}
  218. . \}
  219. . \}
  220. . el \\*T
  221. . \" HP-UX compatibility macros
  222. . if \\$1NAME \{\
  223. . if !\\*()H \{\
  224. . ie \\n(.g==1 \{\
  225. . ds }c C
  226. . \}
  227. . el \{\
  228. . ds }c 1
  229. . \}
  230. . \" constant width
  231. . de C
  232. . ft C
  233. . it 1 }N
  234. . if !\\\\$* \&\\\\$1 \\\\$2 \\\\$3 \\\\$4 \\\\$5 \\\\$6 \\\\$7 \\\\$8 \\\\$9
  235. \\..
  236. . \" combinations with constant width
  237. . de CR
  238. . }S \\*(}c 1 \& "\\\\$1" "\\\\$2" "\\\\$3" "\\\\$4" "\\\\$5" "\\\\$6" "\\\\$7" "\\\\$8" "\\\\$9"
  239. \\..
  240. . de RC
  241. . }S 1 \\*(}c \& "\\\\$1" "\\\\$2" "\\\\$3" "\\\\$4" "\\\\$5" "\\\\$6" "\\\\$7" "\\\\$8" "\\\\$9"
  242. \\..
  243. . de CI
  244. . }S \\*(}c 2 \& "\\\\$1" "\\\\$2" "\\\\$3" "\\\\$4" "\\\\$5" "\\\\$6" "\\\\$7" "\\\\$8" "\\\\$9"
  245. \\..
  246. . de IC
  247. . }S 2 \\*(}c \& "\\\\$1" "\\\\$2" "\\\\$3" "\\\\$4" "\\\\$5" "\\\\$6" "\\\\$7" "\\\\$8" "\\\\$9"
  248. \\..
  249. . de CB
  250. . }S \\*(}c 3 \& "\\\\$1" "\\\\$2" "\\\\$3" "\\\\$4" "\\\\$5" "\\\\$6" "\\\\$7" "\\\\$8" "\\\\$9"
  251. \\..
  252. . de BC
  253. . }S 3 \\*(}c \& "\\\\$1" "\\\\$2" "\\\\$3" "\\\\$4" "\\\\$5" "\\\\$6" "\\\\$7" "\\\\$8" "\\\\$9"
  254. \\..
  255. . \" various stuff
  256. . de CD
  257. . CR "\\\\$1" "\\\\$2"
  258. \\..
  259. . de CT
  260. . IR "\\\\$1" "\\\\$2"
  261. \\..
  262. . de EM
  263. . IR "\\\\$1" "\\\\$2"
  264. \\..
  265. . de ER
  266. . nop [\\\\$1]\\\\$2
  267. \\..
  268. . de EV
  269. . CR "\\\\$1" "\\\\$2"
  270. \\..
  271. . de GT
  272. . BR "\\\\$1" "\\\\$2"
  273. \\..
  274. . de KC
  275. . BR "\\\\$1" "\\\\$2"
  276. \\..
  277. . de RV
  278. . CR "\\\\$1" "\\\\$2"
  279. \\..
  280. . de SC
  281. . CR "\\\\$1" "\\\\$2"
  282. \\..
  283. . de S3
  284. . sp \\n()Pu
  285. . ne 2
  286. . nop \&\\\\$1 \|\\\\$2 \|\\\\$3 \|\\\\$4 \|\\\\$5 \|\\\\$6 \|\\\\$7 \|\\\\$8 \|\\\\$9
  287. . br
  288. \\..
  289. . de P
  290. . PP
  291. \\..
  292. . \}
  293. . \}
  294. ..
  295. . \" sub section heading
  296. .de SS
  297. . if !\\n(.z \{\
  298. . br
  299. . di
  300. . \\n(.z
  301. . \}
  302. . ie n .}X 3n
  303. . el .}X .25i
  304. . nr )E 2
  305. . if \\n(.$ \{\
  306. . lds T \&\\$1
  307. . lds A \\$1
  308. . shift
  309. . while \\n(.$ \{\
  310. . as T " \|\\$1
  311. . as A " \\$1
  312. . shift
  313. . \}
  314. . ie \\n[Toc] \{\
  315. \XPDFMark: BookmarkClosed 1 \\*A\A\\*A\\*T
  316. . ie \\*(.Thtml \{\
  317. . tm Toc:.ta 3n
  318. . tm Toc:\t\T\\*A\\*T\T
  319. . \}
  320. . el \{\
  321. . lnr Tab \\n(.l-\\n(.i
  322. . tm Toc:.ta 3n \\n[Tab]uR
  323. . tm Toc:\t\T\\*A\\*T\T\a\\n%
  324. . \}
  325. . \}
  326. . el \\*T
  327. . br
  328. . \}
  329. ..
  330. . \" subroutine for section heading
  331. .de }X
  332. . }E
  333. . ti \\$1
  334. . sp \\n()Pu
  335. . ne 2
  336. . nr )R 0
  337. . fi
  338. . it 1 }N
  339. . SM
  340. . B
  341. ..
  342. . \" end of SH (cf }X above and }N below)
  343. .de }2
  344. . nr )E 0
  345. . }E
  346. . nr )I \\n[)I.def]
  347. . ns
  348. ..
  349. . \" italic
  350. .de I
  351. . ft 2
  352. . ie !\\n(.$ .it 1 }N
  353. . el \&\\$*\fR
  354. ..
  355. . \" bold
  356. .de B
  357. . ft 3
  358. . ie !\\n(.$ .it 1 }N
  359. . el \&\\$*\fR
  360. ..
  361. . \" small
  362. .de SM
  363. . ps \\nS-1
  364. . ie !\\n(.$ .it 1 }N
  365. . el \&\\$*\s\\nS
  366. ..
  367. . \" small and bold
  368. .de SB
  369. . ps \\nS-1
  370. . ft B
  371. . ie !\\n(.$ .it 1 }N
  372. . el \&\\$*\fR\s\\nS
  373. ..
  374. . \" combinations of Roman, italic, bold
  375. .de RI
  376. . lds Text \&
  377. . lnr State 0
  378. . while \\n(.$ \{\
  379. . ie \\n[State] \{\
  380. . as Text \fI\\$1
  381. . nr State 0
  382. . \}
  383. . el \{\
  384. . as Text \fR\\$1
  385. . nr State 1
  386. . \}
  387. . shift
  388. . \}
  389. . nop \\*[Text]
  390. . }f
  391. ..
  392. .de RB
  393. . lds Text \&
  394. . lnr State 0
  395. . while \\n(.$ \{\
  396. . ie \\n[State] \{\
  397. . as Text \fB\\$1
  398. . nr State 0
  399. . \}
  400. . el \{\
  401. . as Text \fR\\$1
  402. . nr State 1
  403. . \}
  404. . shift
  405. . \}
  406. . nop \\*[Text]
  407. . }f
  408. ..
  409. .de IR
  410. . lds Text \&
  411. . lnr State 0
  412. . while \\n(.$ \{\
  413. . ie \\n[State] \{\
  414. . as Text \fR\\$1
  415. . nr State 0
  416. . \}
  417. . el \{\
  418. . as Text \fI\\$1
  419. . nr State 1
  420. . \}
  421. . shift
  422. . \}
  423. . nop \\*[Text]
  424. . }f
  425. ..
  426. .de IB
  427. . lds Text \&
  428. . lnr State 0
  429. . while \\n(.$ \{\
  430. . ie \\n[State] \{\
  431. . as Text \fB\\$1
  432. . nr State 0
  433. . \}
  434. . el \{\
  435. . as Text \fI\\$1
  436. . nr State 1
  437. . \}
  438. . shift
  439. . \}
  440. . nop \\*[Text]
  441. . }f
  442. ..
  443. .de BR
  444. . lds Text \&
  445. . lnr State 0
  446. . while \\n(.$ \{\
  447. . ie \\n[State] \{\
  448. . as Text \fR\\$1
  449. . nr State 0
  450. . \}
  451. . el \{\
  452. . as Text \fB\\$1
  453. . nr State 1
  454. . \}
  455. . shift
  456. . \}
  457. . nop \\*[Text]
  458. . }f
  459. ..
  460. .de BI
  461. . lds Text \&
  462. . lnr State 0
  463. . while \\n(.$ \{\
  464. . ie \\n[State] \{\
  465. . as Text \fI\\$1
  466. . nr State 0
  467. . \}
  468. . el \{\
  469. . as Text \fB\\$1
  470. . nr State 1
  471. . \}
  472. . shift
  473. . \}
  474. . nop \\*[Text]
  475. . }f
  476. ..
  477. . \" make special case of shift out of italic
  478. .de }S
  479. . ds ]F
  480. . if \\$12 .if !\\$5 .ds ]F \^
  481. . ie !\\$4 \{\
  482. . do ds }$1 "\\$1
  483. . do ds }$2 "\\$2
  484. . do ds }$3 "\\$3
  485. . do ds }$4 "\\$4
  486. . do shift 4
  487. . if \\n(.X<2 \{\
  488. . nr )X \\n(.X
  489. . do xflag 3
  490. . \}
  491. . }S \\*[}$2] \\*[}$1] "\\*[}$3]\f\\*[}$1]\\*[}$4]\\*(]F" \\$@
  492. . if \\n()X .do xflag \\n()X
  493. . \}
  494. . el \\$3
  495. . }f
  496. ..
  497. . \" paragraph
  498. .de LP
  499. . PP
  500. ..
  501. .de PP
  502. . sp \\n()Pu
  503. . ne 2
  504. . }E
  505. . nr )I \\n[)I.def]
  506. . ns
  507. ..
  508. .de P
  509. . PP
  510. ..
  511. . \" paragraph distance
  512. .de PD
  513. . if t .nr )P .4v
  514. . if n .nr )P 1v
  515. . if !\\$1 .nr )P \\$1v
  516. ..
  517. . \" hanging indent
  518. .de HP
  519. . sp \\n()Pu
  520. . ne 2
  521. . if !\\$1 .nr )I \\$1n
  522. . ll \\n(LLu
  523. . in \\n()Ru+\\n(INu+\\n()Iu
  524. . ti \\n()Ru+\\n(INu
  525. . }f
  526. ..
  527. . \" indented paragraph
  528. .de IP
  529. . TP \\$2
  530. \&\\$1
  531. ..
  532. . \" hanging label
  533. .de TP
  534. . if \\n()E .return
  535. . if !\\$1 .nr )I \\$1n
  536. . sp \\n()Pu
  537. . in \\n()Ru
  538. . nr )E 1
  539. . ns
  540. . it 1 }N
  541. . nf
  542. . di ]B
  543. ..
  544. . \" end of TP (cf }N below)
  545. .de }0
  546. . fi
  547. . }1
  548. ..
  549. .de }1
  550. . ds ]X \&\\*(]B\\
  551. . nr )E 0
  552. . if !\\$1 .nr )I \\$1n
  553. . }f
  554. . ll \\n(LLu
  555. . in \\n()Ru+\\n(INu+\\n()Iu
  556. . ti \\n(INu
  557. . ie !\\n()Iu+\\n()Ru-\w\\*(]Xu-3p \{\
  558. . nop \\*(]X
  559. . br
  560. . \}
  561. . el \{\
  562. . nop \\*(]X\h|\\n()Iu+\\n()Ru\c
  563. . if \\n(.X \{\
  564. . do nop \k[}pos]
  565. . do vpt 0
  566. . sp -1
  567. . do vpt 1
  568. . do nop \h\\n[}pos]u\c
  569. . \}
  570. . \}
  571. . }f
  572. ..
  573. . \" handle end of 1-line features
  574. .de }N
  575. . if \\n()E .br
  576. . di
  577. . ie !\\n()E .}f
  578. . el .ie \\n()E=1 .}0
  579. . el .if \\n()E=2 .}2
  580. . nr )E 0
  581. ..
  582. .als an-trap }N
  583. . \" increase relative indent
  584. .de RS
  585. . nr ]\\n+()p \\n()I
  586. . nr )\\n()p \\n()R
  587. . ie !\\$1 .nr )R +\\$1n
  588. . el .nr )R +\\n()I
  589. . nr )I \\n[)I.def]
  590. . }E
  591. ..
  592. . \" decrease relative indent
  593. .de RE
  594. . ie !\\$1 \{\
  595. . ie \\$10 .nr )p 1 1
  596. . el .nr )p \\$1 1
  597. . \}
  598. . el .if !\\n()p \{\
  599. . tm \\n(.F \\n(.c: .RE without .RS ignored
  600. . return
  601. . \}
  602. . ds ]i \\*(]I\\n()p
  603. . ds ]r \\*(]R\\n()p
  604. . nr )I \\*(]i
  605. . nr )R \\*(]r
  606. . if \\n()p .nr )p -1
  607. . }E
  608. ..
  609. .nr )p 0 1
  610. .ds ]I \\\\n(]
  611. .ds ]R \\\\n()
  612. .ds R \(rg
  613. .ds S \s10
  614. . \" For Tru64 UNIX manpages. Use of this is discouraged.
  615. .de LI
  616. . ie !\\$1 \{\
  617. . TP
  618. \\$1
  619. . \}
  620. . el \{
  621. . PP
  622. . \}
  623. ..
  624. .so /usr/heirloom/lib/doctools/tmac/an-ext
  625. .\" For groff_www.7
  626. .de URL
  627. . nop \\$2 \(la\\$1\(ra\\$3
  628. ..
  629. .als MTO URL
  630. .als FTP URL
  631. .de AT
  632. . ie \\$14 .ds ]W System III
  633. . el .ie \\$15 \{\
  634. . ds ]W System V
  635. . if !\\$2 .as ]W " Release \\$2
  636. . \}
  637. . el .ds ]W 7th Edition
  638. ..
  639. .de UC
  640. . ie \\$14 .ds ]W 4th
  641. . el .ie \\$15 .ds ]W 4.2
  642. . el .ie \\$16 .ds ]W 4.3
  643. . el .ie \\$17 .ds ]W 4.4
  644. . el .ds ]W 3rd
  645. . as ]W " Berkeley Distribution
  646. ..
  647. .\" vim:set filetype=groff: