NaN and Inf are not integers
That's true - for completeness, the documentation should probably specify that
int($x) returns $x, as evaluated in numeric context, if $x (as evaluated in numeric context) is either NaN or +Inf or -Inf or has no fractional part.
What does 'integer portion' actually mean? It's not defined, so one could read that to mean that the integer portion of eee5 is 5.
Maybe it should be specified that EXPR is first evaluated in numeric context, and the integer portion of that derived value is returned.
But then, neither the sin() nor cos() nor log() nor exp() nor sqrt() documentations specify that EXPR is to be evaluated in numeric context.
Do those docs need to make the same clarification ?
One might argue that it's somehow already clear that those math functions will evaluate their args in numeric context, but that it's not immediately apparent that int() will do the same.
I don't think I'd agree with that argument ... nor would I necessarily disagree with it ... dunno ;-)
You should present you point of view at
https://github.com/Perl/perl5/pull/22227.
Cheers,
Rob