マンページレイアウトと正しいダッシュ

マンページレイアウトと正しいダッシュ

マニュアルページでは、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あるいは、マクロを使用するのが最善ですが、.NdUTF-8でエンコードされたダッシュを使用するのは問題ありません。

おすすめ記事