Skip to content

Conversation

@TysonAndre
Copy link
Contributor

Mentioned in discussion of
https://github.com/Microsoft/tolerant-php-parser/pull/136/files
(Couldn't find the code style guidelines referred to, if any. Is that just referring to the current state?)

Many IDEs and tools don't expect whitespace, and don't handle this.
So, they may act as if only the first type.

@msftclas
Copy link

@TysonAndre,
Thanks for your contribution.
To ensure that the project team has proper rights to use your work, please complete the Contribution License Agreement at https://cla.microsoft.com.

It will cover your contributions to all Microsoft-managed open source projects.
Thanks,
Microsoft Pull Request Bot

@roblourens
Copy link
Member

Thanks! I don't think the test files supposed to be changed?

Mentioned in discussion of
https://github.com/Microsoft/tolerant-php-parser/pull/136/files

Many IDEs and tools don't expect whitespace, and don't handle this.
So, they may act as if only the first type.

- https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc.md#appendix-a-types
  is a proposal, and is vague about how whitespace is handled
  outside `<>`
- https://github.com/phpDocumentor/phpDocumentor2/blob/develop/docs/references/phpdoc/tags/var.rst
  is vague
- https://github.com/phpDocumentor/ReflectionDocBlock/blob/master/src/DocBlock/Tags/Var_.php
  doesn't expect any whitespace after `@var`

Remove extra space between `@param` and `@return` union types

Fix DiagnosticsProvider phpdoc
@TysonAndre
Copy link
Contributor Author

TysonAndre commented Sep 13, 2017

Reverted the test files. I'm not sure when those changed, must have modified them somehow or checked out a stale version by accident.

After this was approved, @param and @return were also modified, and DiagnosticsProvider.php had phpdoc added and reordered.

See https://github.com/Microsoft/tolerant-php-parser/pull/174/files?w=1

@msftclas
Copy link

@TysonAndre, thanks for signing the contribution license agreement. We will now validate the agreement and then the pull request.

Thanks, Microsoft Pull Request Bot

Copy link
Member

@roblourens roblourens left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Excellent, thanks!

@roblourens roblourens merged commit 5bfa8bb into microsoft:master Sep 13, 2017
@TysonAndre TysonAndre deleted the normalize-space branch June 19, 2018 02:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants