コマンド M-x list-packages を実行すると、パッケージメニュー が表示されます。これは、Emacs が認識しているすべてのパッケージを1行に1つずつ、以下の情報とともに一覧表示するバッファです。
list-packagesコマンドはネットワークにアクセスし、パッケージアーカイブサーバーから利用可能なパッケージの一覧を取得します。ネットワークが利用できない場合は、直近に取得した一覧が使用されます。
package list バッファで使用する主要なコマンドは x コマンドです。ポイント位置にあるパッケージがまだインストールされていない場合、このコマンドでインストールされます。ポイント位置にあるパッケージが既にインストールされている場合、このコマンドで削除されます。
パッケージメニューでは、以下のコマンドが利用可能です。
パッケージメニュー(package-menu-quick-help)の使い方を要約した短いメッセージを出力してください。
C-h P コマンドで表示されるヘルプウィンドウと同様に、現在の行にパッケージのヘルプバッファを表示します
(package-menu-describe-package) (Emacs Lisp Packages を参照)。
パッケージを現在の行にマークしてインストールします (package-menu-mark-install)。パッケージのステータスが ‘available’ の場合、行の先頭に ‘I’ 文字が追加されます。x
と入力すると(後述)、パッケージがダウンロードされ、インストールされます。
現在の行にあるパッケージに削除用のマーク(package-menu-mark-delete)を付けます。パッケージのステータスが‘installed’の場合、行の先頭に‘D’という文字が追加されます。x(後述)と入力すると、そのパッケージが削除されます。パッケージの削除によって何が行われるかについては、パッケージファイルとディレクトリ構成を参照してください。
ブラウザの現在の行でパッケージのウェブサイトを開きます (package-browse-url)。ブラウザを開くには browse-url を使用します。
削除対象の廃止済みパッケージをすべてマークします (package-menu-mark-obsolete-for-deletion)。これにより、ステータスが
‘obsolete’
であるすべてのパッケージが削除対象としてマークされます。
i または d
コマンドによって現在の行に以前に追加されたインストールまたは削除マークを削除します (package-menu-mark-unmark)。
アップグレード可能な新しいバージョンがあるすべてのパッケージに、マークを付けます (package-menu-mark-upgrades)。これにより、利用可能な新しいバージョンにはインストールマークが、既にインストールされている古いバージョン(ステータス
‘obsolete’
でマークされたもの)には削除マークが付与されます。デフォルトでは、新しいバージョンが存在する組み込みパッケージにはマークが付与されませんが、package-install-upgrade-built-in
をカスタマイズすることでこれを変更できます。パッケージのインストールを参照してください。package-install-upgrade-built-in を nil 以外の値にカスタマイズする場合は、上書きしたくない組み込みパッケージを更新しないよう、U コマンドがマークするすべての組み込みパッケージを必ず確認してください。
i
とマークされたすべてのパッケージとその依存関係をダウンロードしてインストールしてください。また、d
(package-menu-execute)
とマークされたすべてのパッケージを削除してください。これにより、マークも解除されます。マークされたパッケージがない場合、このコマンドはポイント配下のパッケージをインストール(未インストールの場合)、またはポイント配下のパッケージを削除(インストール済みの場合)します。
パッケージリストを更新します (revert-buffer)。これにより、利用可能なパッケージの一覧がパッケージアーカイブから再度取得され、パッケージリストが再表示されます。
名前が正規表現(package-menu-hide-package)に一致するパッケージを非表示にします。正規表現の入力を求め、一致する名前のパッケージを非表示にします。正規表現のデフォルト値では、ポイントにある名前のパッケージのみが非表示になるため、RET を押して入力プロンプトを表示するだけで、現在のパッケージが非表示になります。
パッケージの旧バージョン、および優先度の低いアーカイブのバージョン(package-menu-toggle-hiding)の表示/非表示を切り替えます。
アーカイブ(package-menu-filter-by-archive)でパッケージリストをフィルタリングします。パッケージアーカイブ(例:‘gnu’)の入力を求め、そのアーカイブに含まれるパッケージのみを表示します。複数のアーカイブを指定する場合は、名前をカンマ区切りで入力してください。
パッケージ一覧を説明(package-menu-filter-by-description)でフィルタリングします。正規表現の入力を求め、その正規表現に一致する説明を持つパッケージのみを表示します。
キーワード(package-menu-filter-by-keyword)でパッケージリストをフィルタリングします。キーワード(例:‘games’)の入力を求め、そのキーワードを含むパッケージのみを表示します。複数のキーワードを指定する場合は、カンマ区切りで入力してください。
パッケージリストを名称または説明(package-menu-filter-by-name-or-description)でフィルタリングします。正規表現の入力を求め、その正規表現に一致する名称または説明を持つパッケージのみを表示します。
パッケージリストを名前(package-menu-filter-by-name)でフィルタリングします。正規表現の入力を求め、その正規表現に一致する名前のパッケージのみを表示します。
ステータス(package-menu-filter-by-status)でパッケージリストをフィルタリングします。1つ以上のステータス(例:‘available’、パッケージステータスを参照)の入力を求め、一致するステータスを持つパッケージのみを表示します。複数のステータス値をカンマ区切りで入力して指定できます。
パッケージリストをバージョン (package-menu-filter-by-version)
でフィルタリングします。まず、比較記号 ‘<’、‘>’、‘=’
のいずれかとバージョン文字列の入力を求め、その後、入力したバージョンよりも対応する形で低い、等しい、または高いバージョンを持つパッケージを表示します。
空でないマーク (package-menu-filter-marked)
でパッケージリストをフィルタリングします。これにより、インストールまたは削除対象としてマークされたパッケージのみが表示されます。
パッケージリストをフィルタリングし、利用可能なアップグレードがあるパッケージのみを表示します (package-menu-filter-upgradable)。デフォルトでは、このフィルタはより新しいバージョンが存在する組み込みパッケージを除外しますが、package-install-upgrade-built-in
をカスタマイズすることでこれを変更できます。パッケージのインストールを参照してください。
パッケージリストに現在適用されているフィルターをクリアします (package-menu-filter-clear)。
例えば、そのパッケージが記載されている行に i と入力し、続けて x と入力することで、パッケージをインストールできます。