php - 可変個引数関数、つまり引数の数が定義されていない関数のDoxygenコメントを作成するにはどうすればよいですか？

Question

パラメータの数に制限がない関数のdoxygenブロックコメントを書き込もうとしていますが、適切なタグが見つかりませんでした。提供されるパラメーターはすべて文字列である必要があり、それらは関数内で連結されて新しい文字列を形成します。

doxygenタグの正しい使用法は何ですか？

Answer 1

phpdoc（doxygenが理解できる形式）でよく見かけるパターンは次のとおりです。

/** 
 * Shortdesc.
 * Longdesc.  Longdesc.  Longdesc.  Longdesc.  
 * @param mixed $something Description
 * @param mixed ... Description
 */
    function foo() { ... }

はい、文字通り...変数名として。

Answer 2

実際、phpDocumentorの構文は次のとおりです。$paramname,...

/**
 * Builds a file path with the appropriate directory separator.
 * @param string $segments,... unlimited number of path segments
 * @return string Path
 */
function file_build_path(...$segments) {
    return join(DIRECTORY_SEPARATOR, $segments);
}