hash2 icon indicating copy to clipboard operation
hash2 copied to clipboard

Missing "otherwise" in `hash_append` reference docs

Open Lastique opened this issue 1 year ago • 1 comments

In this section, each item in Effects seems to be an alternative rather than a step in the sequence. I think, in such cases each item should end with "; otherwise". Or better yet, the Effects should start with a preamble like "Performs one of the following actions".

Lastique avatar Dec 09 '24 01:12 Lastique

"Otherwise" implies that they are tried in order, and the first match wins, which isn't currently the case (for the same reason I haven't made tag_invoke "win" over the rest.)

I've found that ambiguities are generally better reported, than arbitrarily settled.

pdimov avatar Dec 09 '24 01:12 pdimov