blob: 6837c0020d174f64307a9534e4404dfdbee2e5f3 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
{+ AutoGen5 template -*- nroff -*-
null
## agman3.tpl -- Template for command line man pages
##
## Time-stamp: "2011-02-24 10:39:17 bkorb"
## Author: Bruce Korb <bkorb@gnu.org>
##
## This file is part of AutoOpts, a companion to AutoGen.
## AutoOpts is free software.
## AutoOpts is Copyright (c) 1992-2012 by Bruce Korb - all rights reserved
##
## AutoOpts is available under any one of two licenses. The license
## in use must be one of these two and the choice is under the control
## of the user of the license.
##
## The GNU Lesser General Public License, version 3 or later
## See the files "COPYING.lgplv3" and "COPYING.gplv3"
##
## The Modified Berkeley Software Distribution License
## See the file "COPYING.mbsd"
##
## These files have the following md5sums:
##
## 43b91e8ca915626ed3818ffb1b71248b COPYING.gplv3
## 06a1a2e4760c90ea5e1dad8dfaac4d39 COPYING.lgplv3
## 66a5cedaf62c4b2637025f049f9b826f COPYING.mbsd
+}{+
(define see-also "")
(if (exist? "see-also")
(set! see-also (string-append (get "see-also") " ")) )
+}{+
FOR export-func +}{+
(if (not (exist? "private"))
(set! see-also (string-append see-also
(get "name") "(3) " )) )
+}{+
ENDFOR export-func +}{+
FOR export-func +}{+
IF (not (exist? "private")) +}{+
(out-push-new (string-append
(get "name") ".3" ))
+}.TH {+name+} 3 {+ `date +%Y-%m-%d` +} "" "Programmer's Manual"
{+
;; The following "dne" argument is a string of 5 characters:
;; '.' '\\' '"' and two spaces. It _is_ hard to read. "
;;
(dne ".\\\" ")
+}
.SH NAME
{+name+} - {+what+}
.sp 1
.SH SYNOPSIS
{+IF (exist? "header") +}
#include <\fI{+header+}\fP>
.br{+
ENDIF+}
cc [...] -o outfile infile.c -l\fB{+library+}\fP [...]
.sp 1
{+ ?% ret-type "%s" void
+} \fB{+name+}\fP({+
IF (not (exist? "arg")) +}void{+
ELSE +}{+
FOR arg ", " +}{+arg-type+} \fI{+arg-name+}\fP{+
ENDFOR arg +}{+
ENDIF +});
.sp 1
.SH DESCRIPTION
{+
INCLUDE "agman.tlib"
+}{+
(get "doc") +}{+
IF (exist? "arg") +}{+
FOR arg +}
.TP
.IR {+ arg-name +}
{+ arg-desc +}{+
ENDFOR arg +}{+
ENDIF arg exists +}{+
IF (exist? "ret-type") +}
.sp 1
.SH RETURN VALUE
{+ret-desc+}{+
ENDIF +}{+
IF (exist? "err") +}
.sp 1
.SH ERRORS
{+ err +}{+
ENDIF +}{+
IF (exist? "example") +}
.sp 1
.SH EXAMPLES
.nf
.in +5
{+ example +}
.in -5
.fi{+
ENDIF +}{+
emit-man-text
+}
.SH SEE ALSO
The \fIinfo\fP documentation for the -l\fI{+library+}\fP library.
.br
{+
(define tmp-txt (get "see"))
(if (> (string-length see-also) 0)
(set! tmp-txt (string-append see-also ", " tmp-txt)) )
(shellf "echo '%s' | \
sed 's@%s(3) @@;s/3) $/3)/;s/(3) /(3), /g;s/, *,/,/g;s/^, *//'"
tmp-txt (get "name")) +}
{+
(out-pop) +}{+
ENDIF private +}{+
ENDFOR export-func
+}
|
