[解決済み】コマンドライン/シェルヘルプのテキストに「標準」フォーマットはありますか?
2022-04-18 09:16:01
質問
ない場合、デファクトスタンダードはあるのでしょうか?基本的に私は、コマンドラインのヘルプテキストをこのように書いています。
usage: app_name [options] required_input required_input2
options:
-a, --argument Does something
-b required Does something with "required"
-c, --command required Something else
-d [optlistitem1 optlistitem 2 ... ] Something with list
基本的にいろいろなツールのヘルプテキストを読むだけで作ったのですが、ガイドラインの一覧とかあるんでしょうか?例えば、角括弧と括弧のどちらを使えばいいのか?スペーシングはどうするか?引数がリストの場合はどうすればいいのか?ありがとうございました。
どのように解決するのですか?
一般的に、ヘルプの出力には以下の内容が含まれます。
- アプリが何をするのかの説明
-
使用法の構文、どの。
-
使用方法
[options]
は、オプションがどこに行くかを示すために -
arg_name
必須、単数形のアーギュメントです。 -
[arg_name]
オプションの単数引数 -
arg_name...
多数存在する可能性のある必須のアーギュメント(これはまれです)。 -
[arg_name...]
任意の数を指定できる引数 -
注
arg_name
は、説明的で短い名前でなければなりません。
-
使用方法
-
きれいに整形されたオプションのリスト、それぞれ。
- 短い説明文
- デフォルト値がある場合、その値を表示する
- 可能な値がある場合は、その値を表示します。
-
オプションが短い形式を受け入れることができる場合(例えば
-l
) または長い形式 (例.--list
のように、同じ行にまとめて記述します。
-
コマンドライン引数のソースとなりうる設定ファイルや環境変数の場所を示す簡単なインジケータ。
GREP_OPTS
- man ページがある場合はそのように示し、そうでない場合は、より詳細なヘルプを見つけることができる場所を簡単に示します。
さらに、以下の両方の形式を受け入れるのが良い方法であることに注意してください。
-h
と
--help
をクリックすると、このメッセージが表示されます。
と
ユーザがコマンドラインの構文を間違えた場合、例えば必須の引数を省略した場合などにこのメッセージを表示する必要があることを示します。
関連
-
[解決済み] Node.jsのプログラムにコマンドライン引数を渡すにはどうしたらいいですか?
-
[解決済み] Windowsのコマンドラインに'which'に相当するものはありますか?
-
[解決済み] MySQLでコマンドラインを使用してSQLファイルをインポートするにはどうすればよいですか?
-
[解決済み] Bashでコマンドライン引数を解析するには?
-
[解決済み] LinuxのシェルスクリプトでYes/No/Cancelの入力を促すにはどうしたらいいですか?
-
[解決済み] シェルスクリプトでYYYY-MM-DD形式の日付にする
-
[解決済み] シェルコマンドの実行と出力のキャプチャ
-
[解決済み] コマンドラインから .bash_profile を再読み込みする方法は?
-
[解決済み] 整数の合計を1行に1つずつ表示するシェルコマンド?
-
[解決済み】rakeタスクにコマンドライン引数を渡す方法
最新
-
nginxです。[emerg] 0.0.0.0:80 への bind() に失敗しました (98: アドレスは既に使用中です)
-
htmlページでギリシャ文字を使うには
-
ピュアhtml+cssでの要素読み込み効果
-
純粋なhtml + cssで五輪を実現するサンプルコード
-
ナビゲーションバー・ドロップダウンメニューのHTML+CSSサンプルコード
-
タイピング効果を実現するピュアhtml+css
-
htmlの選択ボックスのプレースホルダー作成に関する質問
-
html css3 伸縮しない 画像表示効果
-
トップナビゲーションバーメニュー作成用HTML+CSS
-
html+css 実装 サイバーパンク風ボタン
おすすめ
-
文字列 null with space エラー: 二項演算子が期待されています。
-
[解決済み] シェルスクリプトで NULL 値と文字列を比較する際に単項演算子が期待される
-
[解決済み] .zshrcファイルをどのように見つけるのですか?
-
[解決済み] Ansibleを使ってリモートサーバーでシェルスクリプトを実行するには?
-
[解決済み] Unixシェルスクリプトは、スクリプトファイルが存在するディレクトリを見つけることができますか?
-
[解決済み】ある名前に一致するプロセスをすべて終了させる方法は?
-
[解決済み】Curlでレスポンスと一緒にhttpステータスコードも返すようにした
-
[解決済み】コマンドライン/シェルヘルプのテキストに「標準」フォーマットはありますか?
-
[解決済み] POSIX shで文字列が他の文字列を含んでいるかどうかを判断するにはどうすればよいですか?
-
[解決済み] カットで列を並べ替える