シェルパッケージガイドライン

提供: ArchWiki
2022年2月22日 (火) 22:44時点におけるKgx (トーク | 投稿記録)による版 (→‎Shell completions: 翻訳)
ナビゲーションに移動 検索に移動

関連記事

インストール方法

ユーザが シェルの変更 を行うには、シェルを /etc/shells に記述する必要があります。ほとんどのシェルパッケージには以下のようなインストールスクリプトがあります。

shellname.install
post_install() {
    grep -Fqx /bin/shellname /etc/shells || echo /bin/shellname >>/etc/shells
    grep -Fqx /usr/bin/shellname /etc/shells || echo /usr/bin/shellname >>/etc/shells
}

post_upgrade() {
    post_install
}

post_remove() {
    sed -i -r '/^(\/usr)?\/bin\/shellname$/d' etc/shells
}

シェルの補完機能

ほとんどのシェルは、いくつかの一般的なコマンドの補完セットを内蔵しており、同時に他のパッケージによって提供されるかもしれない関数のために少なくとも1つのシステムディレクトリをスキャンします。次の表は、パッケージが補完ファイルを置く場所と、そのファイル名をまとめたものです。

シェル ディレクトリ ファイル
Bash /usr/share/bash-completion/completions binary_name
fish /usr/share/fish/vendor_completions.d binary_name.fish
Zsh /usr/share/zsh/site-functions _binary_name

その他のシェル

  • Elvish はいくつかのデフォルトの補完を提供しますが、補完を提供するシステム全体のディレクトリはまだ [[1] ありません。Elvish シェル補完関数を生成するパッケージの場合、一つの解決策は /usr/share/elvish/completions/binary_name.elv をパッケージ化して post_install() 関数を使用して、ユーザーが $XDG_CONFIG_HOME/elvish/lib/ ディレクトリにシンボリックリンクできるように tip を表示することでしょう。
ヒント: 一般的なルールとして、パッケージはシェルに dependoptdepends を持つべきではありません。たまたまそのための補完を提供したからといって、パッケージの依存関係を示唆するものではありません。補完機能はデフォルトのシェルパッケージには存在しませんが、補足の収集パッケージ bash-completionzsh-completions によって 提供 されます。これらのパッケージに補完ファイルが存在する場合、それらを optdepends に追加してください。