blob: 1ba490898cfcb1a404efe908477efb94ddd85593 (
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
|
[+: -*- Mode: nroff -*-
AutoGen5 template man
## agman-cmd.tpl -- Template for command line man pages
##
## Time-stamp: "2011-11-18 07:48:17 bkorb"
##
## This file is part of AutoOpts, a companion to AutoGen.
## AutoOpts is free software.
## Copyright (c) 1992-2012 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
# Produce a man page for section 1, 5 or 8 commands.
# Which is selected via: -DMAN_SECTION=n
# passed to the autogen invocation. "n" may have a suffix, if desired.
#
:+][+:
(define head-line (lambda()
(sprintf ".TH %s %s \"%s\" \"%s\" \"%s\"\n.\\\"\n"
(get "prog-name") man-sect
(shell "date '+%d %b %Y'") package-text section-name) ))
(define man-page #t)
:+][+:
INCLUDE "cmd-doc.tlib"
:+]
.\"
.SH NAME
[+: prog-name :+] \- [+: prog-title :+]
[+:
(out-push-new) :+][+:
INVOKE build-doc :+][+:
(shell (string-append
"fn='" (find-file "mdoc2man") "'\n"
"test -f ${fn} || die mdoc2man not found from $PWD\n"
"${fn} <<\\_EndOfMdoc_ || die ${fn} failed in $PWD\n"
(out-pop #t)
"\n_EndOfMdoc_" ))
:+][+:
(out-move (string-append (get "prog-name") "."
man-sect)) :+][+: #
.\" = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
.\" S Y N O P S I S
.\" = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = :+][+:
DEFINE mk-synopsis :+][+:
(out-push-new file-name) \:+]
.SH SYNOPSIS
.B [+: prog-name :+][+:
IF (. use-flags) :+][+:
IF (exist? "long-opts") :+]
.\" Mixture of short (flag) options and long options
.RB [ \-\fIflag\fP " [\fIvalue\fP]]... [" \-\-\fIopt\-name\fP[+:#
:+] " [[=| ]\fIvalue\fP]]..."[+:
ELSE no long options: :+]
.\" Short (flag) options only
.RB [ \-\fIflag\fP " [\fIvalue\fP]]..."[+:
ENDIF
:+][+:
ELIF (exist? "long-opts")
:+]
.\" Long options only
.RB [ \-\-\fIopt\-name\fP [ = "| ] \fIvalue\fP]]..."[+:
ELIF (not (exist? "argument")) :+]
.RI [ opt\-name "[\fB=\fP" value ]]...
.PP
All arguments are named options.[+:
ENDIF :+][+:
IF (exist? "argument")
:+] [+: argument :+][+:
IF (exist? "reorder-args") :+]
.PP
Operands and options may be intermixed. They will be reordered.
[+: ENDIF :+][+:
ELIF (or (exist? "long-opts") use-flags)
:+]
.PP
All arguments must be options.[+:
ENDIF :+][+:
(if (exist? "explain")
(string-append "\n.PP\n"
(join "\n.PP\n" (stack "explain"))) ) :+][+:
(out-pop) :+][+:
ENDDEF mk-synopsis
agman-cmd.tpl ends here :+]
|