k keita1209xtool

2026/10/15 16:18

解説文と画像の表現に食い違いがあることは問題かと思います。 ＞-c の説明は公式マニュアルの記述通りで、現状の説明に誤りはなさそう これは問題の解説文についてはそうですが、私が指摘している画像については食い違いが発生します。 「解説文が正しいから画像の誤りは放置してよい」は、有償で教材を提供している以上は通用しないと思われます。

k kawaTchi084

2026/10/18 06:47

自分が勘違いしていたら申し訳ないですが、「以下は主なオプションです。」の下の画像ですよね？ もしかして、-n の説明には「デフォルト以外の設定を表示」とあるから、-c の説明も「指定した設定ファイルの内容を表示」とするべきだ、ということですか？ -n についてもマニュアルを抜粋しますが、こちらは明確に「表示」とされており、-c とは説明が使い分けられてます。 -> Show only settings with non-default values. 最終的に、判断するのは運営の方ですが、個人的には、マニュアルに記載されたオプションの役割に沿った説明を維持してほしいですし、 自分としては、今の「設定ファイルを指定」、または man の「指定された設定ファイルを読み込む」程度の説明が適切ではと考えます。

k keita1209xtool

2026/10/19 14:50

私が冒頭で記載のとおり、そのオプションをつけて実行した結果を記載すべきと考えています。よって「指定した設定ファイルの内容を表示」がよいと思います。 -cの「設定ファイルを指定」という記載はコマンドの実行結果ではなく前提条件です。 -nの「デフォルト以外の設定を表示」という記載はコマンドの実行結果です。 ＞マニュアルに記載されたオプションの役割に沿った説明を維持してほしい 賛成です。マニュアルに記載されたオプションはコマンドの実行結果を記載しています。 Show only settings with non-default values. →コマンドを実行した結果を説明している Read configuration from the given config-file →コマンドを実行した結果を説明している また、「読み込む」という言葉は何らかの設定反映・更新が行われると誤解させる可能性があると思います。直後のdoveadm reloadの説明でも「設定を読み込んで反映する」の意味で「読み込む」という語が使われています。doveconf -cコマンドの実行結果を誤解無く表現する「表示する」が良いかと思います。

a arashi1977

2026/10/19 15:26

横から失礼します。 > doveconf -cコマンドの実行結果を誤解無く表現する「表示する」が良いかと思います。 doveconf コマンド自体が「表示する」コマンドですので、「-c で指定したファイルを表示する」だと、コマンドが表示するのか -c オプションによって表示するのかが曖昧になりませんか？コマンドラインとしては - doveconf コマンドが、設定情報を表示する - doveconf コマンドの -c オプションによって、表示する情報の元ネタファイルを指定する ので、「-c: 指定した設定ファイルの内容を表示」だとオプションの意味を正しく伝えられないと思います。もし今の説明を変えるとしたら「表示される設定内容を読み込むファイルを指定」ぐらいじゃないでしょうか？

k keita1209xtool

2026/10/19 17:02

- doveconf コマンドが、設定情報を表示する - doveconf コマンドの -c オプションによって、表示する情報の元ネタファイルを指定する この点についてはよく分かります。 ただ「表示される設定内容を読み込むファイルを指定」は日本語としてかなりわかりにくいと感じました。 任意のパスの設定ファイルをコマンドに渡したいときのオプションである という、使用目的が伝わる表現であるといいのかなと思います。