{"action":"created","issue":{"url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/86","labels_url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/86/labels{/name}","comments_url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/86/comments","events_url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/86/events","html_url":"https://github.com/phpDocumentor/fig-standards/issues/86","id":100753913,"number":86,"title":"Variable arguments (rest params)","user":{"login":"mindplay-dk","id":103348,"avatar_url":"https://avatars.githubusercontent.com/u/103348?v=3","gravatar_id":"","url":"https://api.github.com/users/mindplay-dk","html_url":"https://github.com/mindplay-dk","followers_url":"https://api.github.com/users/mindplay-dk/followers","following_url":"https://api.github.com/users/mindplay-dk/following{/other_user}","gists_url":"https://api.github.com/users/mindplay-dk/gists{/gist_id}","starred_url":"https://api.github.com/users/mindplay-dk/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mindplay-dk/subscriptions","organizations_url":"https://api.github.com/users/mindplay-dk/orgs","repos_url":"https://api.github.com/users/mindplay-dk/repos","events_url":"https://api.github.com/users/mindplay-dk/events{/privacy}","received_events_url":"https://api.github.com/users/mindplay-dk/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":9,"created_at":"2015-08-13T12:09:32Z","updated_at":"2015-08-15T14:28:44Z","closed_at":"2015-08-14T07:31:50Z","body":"It seems the `...` syntax for `@param` was omitted from the current spec.\r\n\r\nThe legacy [php-doc description](http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.param.pkg.html) prescribes a syntax like:\r\n\r\n    @param string $names,...\r\n\r\nI guess maybe we'd have to preserve the legacy syntax for backwards compatibility?\r\n\r\nThere are several problems with the legacy syntax, mainly the type-hint is singular which is inconsistent with other languages, and creates a problem when the collection type is anything other than an array (e.g. generic types under the new spec) and the syntax as such is also inconsistent with e.g. [ECMA6](http://ariya.ofilabs.com/2013/03/es6-and-rest-parameter.html), Typescript, Dart, and others.\r\n\r\nI would propose:\r\n\r\n    @param ...string[] $names\r\n\r\nThis is consistent with other languages, and permits the use of other collection types, e.g.:\r\n\r\n    @param ...ArrayObject $names\r\n\r\nThoughts?\r\n"},"comment":{"url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/comments/131387356","html_url":"https://github.com/phpDocumentor/fig-standards/issues/86#issuecomment-131387356","issue_url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/86","id":131387356,"user":{"login":"mindplay-dk","id":103348,"avatar_url":"https://avatars.githubusercontent.com/u/103348?v=3","gravatar_id":"","url":"https://api.github.com/users/mindplay-dk","html_url":"https://github.com/mindplay-dk","followers_url":"https://api.github.com/users/mindplay-dk/followers","following_url":"https://api.github.com/users/mindplay-dk/following{/other_user}","gists_url":"https://api.github.com/users/mindplay-dk/gists{/gist_id}","starred_url":"https://api.github.com/users/mindplay-dk/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mindplay-dk/subscriptions","organizations_url":"https://api.github.com/users/mindplay-dk/orgs","repos_url":"https://api.github.com/users/mindplay-dk/repos","events_url":"https://api.github.com/users/mindplay-dk/events{/privacy}","received_events_url":"https://api.github.com/users/mindplay-dk/received_events","type":"User","site_admin":false},"created_at":"2015-08-15T14:28:44Z","updated_at":"2015-08-15T14:28:44Z","body":"> you'd have to go out and check all existing tools\r\n\r\nNo, php-documentor defines the de-facto standard - we need to document differences from it, in order to help and guide people towards the new PSR, to help them change old habits and adopt new features. I don't think anyone expects us to compare with every non-standard feature invented or supported by other tools."}}