マニュアルページでは、mダッシュ(—)などのUnicode文字を使用しないでください。私はほとんどのマニュアルページがスローガンにハイフン/マイナス記号を使用していることを知っており、実際のダッシュが印刷上より正確になると信じています。ダッシュシェルのマニュアルページは、名前に合わせて正しいm-ダッシュを使用します。
一時プルリクエストを次の場所に送信しました。https://github.com/rtomayko/ronn/pull/94この問題を修正(?)しましたronn
。
コメント?
ベストアンサー1
Unixのマニュアルページ(manマクロを使用)では、NAMEセクションに単一のハイフンを使用して説明と名前を区別します。
.SH NAME
sh \- command language
Unixのドキュメントとドキュメントでは、適切な場合はemダッシュ\(em
を使用することがよくあります。
最新のマニュアルページは以下に基づいています。文書マクロを使用し、.Nd
マクロを使用してダッシュ全体を出力します。たとえば、dashのマニュアルページには次のものがあります。
.Sh NAME
.Nm dash
.Nd command interpreter (shell)
定義.Nd
は
.de Nd
.nop \[em] \$*
..
\(em
あるいは、マクロを使用するのが最善ですが、.Nd
UTF-8でエンコードされたダッシュを使用するのは問題ありません。