Motivation 実行可能なシェルスクリプトを書く際、なるべく -h や --help のような引数でヘルプメッセージを表示できるようにしておきたい派です。 以前はPOD形式1でファイル末尾にドキュメントコメントを書き、 pod2text を実行して表示していたのですが、以下の理由でやり方を変えたいと思いました: どちらかといえばファイルの先頭に書きたい PODで書くと行数が長くなりがち 最近、PODを書く機会がほとんどないので、毎回記法を忘れている pod2text がどの環境でも動くという前提は置かない方がいいかもしれない(?)2 2ヶ月前ぐらいから悩んでいましたが、ようやくこれでよいかなというやり方にたどり着きました。 ヒアドキュメントで十分という人には無用のやり方かもしれませんが、以下で示すようなやり方にしておけば、スクリプトのフォーマットを揃えることができるでしょう。 動作確
![シェルスクリプトの説明をコメントで書いてコマンドラインでヘルプとして表示する - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/645cc6c88add88fd1e6d666a7681610d1172503c/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fcdn.qiita.com%252Fassets%252Fpublic%252Farticle-ogp-background-412672c5f0600ab9a64263b751f1bc81.png%3Fixlib%3Drb-4.0.0%26w%3D1200%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTk3MiZoPTM3OCZ0eHQ9JUUzJTgyJUI3JUUzJTgyJUE3JUUzJTgzJUFCJUUzJTgyJUI5JUUzJTgyJUFGJUUzJTgzJUFBJUUzJTgzJTk3JUUzJTgzJTg4JUUzJTgxJUFFJUU4JUFBJUFDJUU2JTk4JThFJUUzJTgyJTkyJUUzJTgyJUIzJUUzJTgzJUExJUUzJTgzJUIzJUUzJTgzJTg4JUUzJTgxJUE3JUU2JTlCJUI4JUUzJTgxJTg0JUUzJTgxJUE2JUUzJTgyJUIzJUUzJTgzJTlFJUUzJTgzJUIzJUUzJTgzJTg5JUUzJTgzJUE5JUUzJTgyJUE0JUUzJTgzJUIzJUUzJTgxJUE3JUUzJTgzJTk4JUUzJTgzJUFCJUUzJTgzJTk3JUUzJTgxJUE4JUUzJTgxJTk3JUUzJTgxJUE2JUU4JUExJUE4JUU3JUE0JUJBJUUzJTgxJTk5JUUzJTgyJThCJnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnR4dC1jb2xvcj0lMjMyMTIxMjEmdHh0LWZvbnQ9SGlyYWdpbm8lMjBTYW5zJTIwVzYmdHh0LXNpemU9NTYmcz1lMWMwNTk3ZDI2NzZjMjlmYmIzYWI0ZDBkMzRhOThmNg%26mark-x%3D142%26mark-y%3D57%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZoPTc2Jnc9NzcwJnR4dD0lNDBwcm9ncmh5bWUmdHh0LWNvbG9yPSUyMzIxMjEyMSZ0eHQtZm9udD1IaXJhZ2lubyUyMFNhbnMlMjBXNiZ0eHQtc2l6ZT0zNiZ0eHQtYWxpZ249bGVmdCUyQ3RvcCZzPTAxYjFlYmNjOTE4NWQxMDRiYWU5ZGUyNDI5NjFlZTZi%26blend-x%3D142%26blend-y%3D486%26blend-mode%3Dnormal%26s%3D105958b1bd03b759433be761b776fcb5)