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
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
|
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.2.
.TH HELP2MAN "1" "2022年4月" "GNU help2man 1.49.2" "ユーザーコマンド"
.SH 名前
help2man \- 簡易マニュアルページの生成
.SH 書式
.B help2man
[\fI\,OPTION\/\fR]... \fI\,EXECUTABLE\/\fR
.SH 説明
`help2man' は `\-\-help' および `\-\-version' の出力を元にマニュアルページを生成する。
.PP
引数 EXECUTABLE には、マニュアル作成の対象とするコマンドを指定する。
.TP
\fB\-n\fR, \fB\-\-name\fR=\fI\,STRING\/\fR
「名前」セクションで使うコマンドの短い説明
.TP
\fB\-s\fR, \fB\-\-section\fR=\fI\,SECTION\/\fR
マニュアルページが所属するセクションの番号 (1, 6, 8)
.TP
\fB\-m\fR, \fB\-\-manual\fR=\fI\,TEXT\/\fR
マニュアルの種類 (ユーザコマンド, ...)
.TP
\fB\-S\fR, \fB\-\-source\fR=\fI\,TEXT\/\fR
プログラムの出自 (FSF, Debian, ...)
.TP
\fB\-L\fR, \fB\-\-locale\fR=\fI\,STRING\/\fR
ロケールを選択する (デフォルトは "C")
.TP
\fB\-i\fR, \fB\-\-include\fR=\fI\,FILE\/\fR
`FILE' から原稿を取り込む
.TP
\fB\-I\fR, \fB\-\-opt\-include\fR=\fI\,FILE\/\fR
`FILE' が存在した場合 `FILE' から原稿を取り込む
.TP
\fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR
`FILE' へ出力を送る
.TP
\fB\-p\fR, \fB\-\-info\-page\fR=\fI\,TEXT\/\fR
Texinfo マニュアルの名前
.TP
\fB\-N\fR, \fB\-\-no\-info\fR
Texinfo マニュアルの紹介を省略する
.TP
\fB\-l\fR, \fB\-\-libtool\fR
プログラム名から `lt\-' を取り除く
.TP
\fB\-\-help\fR
簡単な使い方を表示し終了する
.TP
\fB\-\-version\fR
バージョン番号を表示し終了する
.PP
マニュアル作成の対象になるコマンドは、\-\-help や \fB\-\-version\fR というオプションを受け入れて、
標準出力にメッセージを表示するようになっているべきである。
もっとも、以下のオプションを使えば、\-\-help や \fB\-\-version\fR に相当する別のオプションを指定することが可能だ。
.TP
\fB\-h\fR, \fB\-\-help\-option\fR=\fI\,STRING\/\fR
ヘルプ表示オプションの文字列
.TP
\fB\-v\fR, \fB\-\-version\-option\fR=\fI\,STRING\/\fR
バージョン表示オプションの文字列
.TP
\fB\-\-version\-string\fR=\fI\,STRING\/\fR
バージョンとして表示する文字列
.TP
\fB\-\-no\-discard\-stderr\fR
オプションの出力を解析するときに標準エラー出力を含める
.SH インクルードファイル
.B \-\-include
や
.B \-\-opt\-include
オプションを使用すると、生成する出力に追加の原稿を取り込むことができる。ファイルの書式は単純である。
[セクション]
本文
/パターン/
本文
本文は *roff のテキストであり、出力中の、指定された
.BI [ セクション ]
(大文字・小文字は区別されない) の先頭部分や
.BI / パターン /\fR.
にマッチするパラグラフの直後に、そのままの形で挿入される。
パターンには Perl の正規表現の文法を使用する。修飾子の
.IR i
,
.I s
,
.I m
を後に付けることもできる (
.BR perlre (1) を参照)。
最初のセクションやパターンより前にある行で、'\-' で始まっている行は、
オプションとして処理される。それ以外は、何もせずに無視されるのでコメントや
RCS のキーワードなどに使用することができる。
セクションの出力順序:
名前
書式
説明
オプション
\fIその他\fR
環境変数
ファイル
例
作者
バグの報告
著作権
関連項目
インクルードファイルに
.B [名前]
や
.B [書式]
というセクションがあれば、そこに記述した内容が、自動的に生成される内容のかわりに出力される。
(もっとも、どうしても必要ならば、前者については、
.B \-\-name
オプションを使って、さらに置き換えることができるが。)
それ以外のセクションについては、上記の標準的なセクションのために
自動的に生成される出力の前に挿入されるか、あるいは、(上記の)
.I その他
の位置に、インクルードファイル中で見つかった順番で取り込まれる。
デフォルトの出力の代わりに、
.RI [< section ]、
.RI [= section ]
あるいは
.RI [> section ]
という文法を使うことでセクション内での追加の原稿の配置を明示的に要求することができる。
それぞれ追加の原稿を元の文章の前、元の文章の代わりに、
あるいは元の文章の後に配置する。
.SH 入手先
この配布物の最新バージョンは次の場所から入手可能である。
ftp://ftp.gnu.org/gnu/help2man/
.SH 作者
作者は Brendan O'Dea <bod@debian.org> である。
.SH バグの報告
バグを発見した場合は <bug\-help2man@gnu.org> に報告されたい。
.SH 著作権
Copyright \(co 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2009, 2010,
2011, 2012, 2013, 2014, 2015, 2016, 2017, 2020, 2021, 2022 Free Software
Foundation, Inc.
.br
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.SH 関連項目
.B help2man
の完全なマニュアルは Texinfo マニュアルとして整備されている。もし、
.B info
および
.B help2man
のプログラムが正しくインストールされているならば、コマンド
.IP
.B info help2man
.PP
を使用すると完全なマニュアルを読むことができるはずだ。
|
