Re^2: Sort::Key::Natural sorting discrepancy

[1nickt]

Hi salva,

Thanks for clarifying. Now that I know from your follow-up what the truth is, I can discern it in the docs. However, I humbly submit that the doc could be clearer.

I misread the existing doc and concluded (encouraged in the wrong conclusion by the OP's code) that the string was split only on the underscores etc. (i.e.: 'boundaries' == 'underscores, etc.'). That's mostly my fault, for only seeing what I thought I was looking for, but here's a suggestion: place next to each other the descriptions of the two ways in which the string could be split, and highlight that alpha words and numbers are different, not a group:

"Under natural sorting, strings are split at word and number boundaries, and the resulting ... "

Possibly better as:

"Under natural sorting, strings are split at boundaries between words and numbers and at non-alphanumeric characters (see below), and the resulting ..."

Let me know if a patch / PR would be helpful, if you think this would be an improvement.

Thanks for all you do for Perl!

[salva]

Following your advice, I have changed the description on the development version of the module.