Haddockは、UTF-8でエンコードされたソースファイルのドキュメントで非ASCII文字を間違って再エンコードしているようです。私はしばしばドキュメントに数式を含める必要があり、集計(Σ)などの一般的な数学記号を使用できる場合は、はるかに読みやすくなります。Haddockのドキュメントでのユニコード文字の使用
ただし、haddockでファイルを実行した後、これらの記号は空白の四角になります。 Haddockにはオプション--use-unicode
がありますが、実際のドキュメントを破ったまま、関数シグネチャなどの関数矢印をUnicode文字に変換するだけです。
cabal haddock
からこれを制御することができます。
私はHaddockバージョン2.9.4を使用しています。
ASCII以外の記号には「ς」などを使用できます。 –
OKですが、ソースが判読できなくなる... –
true、しかしhaddockがUTF-8を自動的に処理していない場合は、その内部を知ることができません。 –