Skip to content

Conversation

@pscheit
Copy link
Contributor

@pscheit pscheit commented Jun 25, 2025

Copy link
Member

@aik099 aik099 left a comment

Choose a reason for hiding this comment

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

This note applies to all PRs.

Please also use the php generator/run.php to regenerate auto-generated files so they could be included in PR.

P.S.
I've created #37 for updating contributor instructions to include that command at least.


/**
* Does array size satisfy a given matcher?
* Creates a matcher that matches any examined object whose toString method returns a value equalTo the specified string.
Copy link
Member

Choose a reason for hiding this comment

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

Please use text from the relevant java file to preserve formatting.

In this case only the <code>...</code> text was lost, but I'm not sure if PhpDoc supports it at all.


/**
* Matches if array size satisfies a nested matcher.
* Matches an examined object whose toString method returns a value that satisfies the specified matcher.
Copy link
Member

Choose a reason for hiding this comment

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

Please use text from the relevant java file to preserve formatting.

The above-proposed text doesn't the matching Java file text.

P.S.
The previous text looks like a copy/paste from the https://github.com/hamcrest/JavaHamcrest/blob/master/hamcrest/src/main/java/org/hamcrest/collection/IsArrayWithSize.java file.

@pscheit pscheit force-pushed the fix-has-to-string-description branch from 72b4c99 to d4a1be8 Compare June 26, 2025 13:33
@pscheit pscheit requested a review from aik099 June 26, 2025 13:34
@aik099
Copy link
Member

aik099 commented Jun 27, 2025

Have you checked that using <code>...</code> is PhpDoc works the same way as in Java?

@pscheit
Copy link
Contributor Author

pscheit commented Jun 27, 2025

Which software is used to render this as html?

@aik099
Copy link
Member

aik099 commented Jun 27, 2025

Which software is used to render this as html?

I have no idea. The https://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.example.pkg.html page says that is correct syntax.

@aik099 aik099 merged commit 2f2740a into hamcrest:master Jun 27, 2025
6 checks passed
@aik099
Copy link
Member

aik099 commented Jun 27, 2025

Merging, thank you @pscheit .

I've created #95 to address other similar issues.

@pscheit
Copy link
Contributor Author

pscheit commented Jun 27, 2025

:) yeah, unless its really rendered and looks odd, I wouldn't care too much about it. DocBlocks are like markdown, a defactor standard but it's all pretty wild.

Guess this is entirely different for java.

Since I don't see the generated api docs on the page, I wouldn't sweat it. This wrong docblock was probably there for ages :)

@pscheit pscheit deleted the fix-has-to-string-description branch June 27, 2025 11:29
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.

2 participants