Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

php-show-arglist for built-in PHP functions

オープン
#142 コメント 2 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
25/100
issue の種類
機能追加
明瞭さ
説明が足りない
活発さ
停滞
技術スタック
emacs, emacs-lisp, php
領域
tooling

調査の方向性

まず php-show-arglist を追跡し、php-completion-file、show-arg-file、php-manual-path とどのように関係しているかを確認します。組み込み関数のプロトタイプを公開できるかどうかを判断する前に、既存の etags と PHP ドキュメントに関する前提を確認します。完了とするには、許容できないパフォーマンスコストなしに、組み込み PHP TAG ソースを作成または利用するための明確なアプローチが必要です。

索引モデルが issue の本文から書いたものです。

説明

This could be seen as a documentation issue :
when using (php-show-arglist) on a PHP core function I'd expect to see it's prototype (what could be quicker than C-C C-F to browse www.php.net and often useful given the sometimes so strange order of PHP function's arguments).

But doing so bring up a "Visit tags table" prompt from what I deduce that the "php-completion-file" isn't used for (show-arg-file) since :

  1. this file is a shell-generated output which does not contains the PHP functions' arguments
  2. it's "not a valid tag file" (just plain-text)
    (php-show-arglist) does not seem to directly use "php-manual-path" neither.

Finally after looking at the code I went to think that (php-show-arglist) only applies to project-code for which a TAG file has been generated.

Thus my question is :

  • am I right when I think it's not currently possible or did I overlooked something ?
  • why no one has been interested in this up to now ?
  • has there been any attempt into converting the php-doc to etags parsable code in order to create a "built-in PHP TAG file" which could then be used by php-mode (php-show-arglist) ?

I don't know enough about etags to imagine and provide a PoF of the best/efficient way to do that (though I think it's feasible) neither I know if there is a huge performance penalty risk.

anyway, long-life php-mode !

主要言語
Emacs Lisp
スター
602
フォーク
117
平均マージ
12時間 54分
マージ済み PR(30日)
3

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

emacs-php/php-mode のほかの issue

emacs-php/php-mode の issue をすべて見る

似ている issue

DevTools の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。