Join GitHub today
GitHub is home to over 31 million developers working together to host and review code, manage projects, and build software together.Sign up
Set.diff not documented properly #7868
Original bug ID: 7868
The docs say Set.diff is "set difference".
As I pointed out years ago (why isn't this fixed!!) there are TWO operations called set difference. Both should be provided IMHO but at least the one that is provided should be properly specified.
Is this (a) the symmetric difference, equal to the union with the intersection removed, OR is it (b) the asymmetric difference, the elements of the first set with those of the second which are in it removed?
Steps to reproduce
Just read the docs.
Comment author: @nojb
It is the second type ("asymmetric"). It hasn't been fixed because nobody has had the time or inclination to do it until now.
Would you like to propose a patch for the docs? You can even do it directly via github's interface, no need to make a branch, etc.
Comment author: @alainfrisch
I think that the "set difference" terminology is much more common than "asymmetric difference" (people referring to the "symmetric difference" always mention "symmetric" explicitly), and so there should be no risk of confusion. But I wouldn't be opposed to make things more explicit, if you or someone else want to propose a PR to improve the documentation.