Originally Posted by bomfunk
I still don't see how it's wrong, though. The statement "X or Y" is true if either X of Y is true, and it's true if all X are true even if no Y are true. You're in effect saying that "X or Y" is wrong because Y can not be inferred from the description of the switch -a alone; but this is irrelevant since X is still true and as such the whole statement is true. "Ball A is round OR the moon is made of cheese" is true as long as A indeed is round, regardless of the scientific community's opinion on the composition of moon. I suppose you could argue that X cannot be assumed to be true from that line alone, but X certainly is true.
Now I do agree that when reading a manpage turns into an exercise in propositional calculus, the writing could probably be improved somewhat, but I don't see how it's *wrong* per se...
If that's true, then at best, the description of the -a switch is misleading. But if we use this example, then would you really, honestly still say the following description of -a is correct?
-a The program displays or deletes all of the current ARP entries or makes you breakfast
The issue is that the -a switch does not do any deleting, ever. It SELECTS, as another member previously stated, which can be used to choose all of the entries for -d to perform the deletion. The -a switch does not delete as its description says it does.
Originally Posted by Plan9
The point enorbet2 raises is that sometimes when you're at the beginning stages of understanding something, you an have very strong views about how things should read or work. Sometimes those views will be right, but sometimes they'll be wrong; and you need to be prepared to listen to others and accept their advice at times otherwise you hamper your own ability to learn.
I already said several times that "ok, now I understand that things can be what they're not said to be" in the man pages. Lesson learned. If you're still trying to talk down to me and put me in that beginner's square over that fact, I'll accept that. However, I'm not a beginner to the English language, and when something doesn't do what's written, there is a problem. I mean look, bomfunk above just admitted that there is room for improvement, and you're continuing to defend this practice of "As long as I'm the one who understands it, it's ok for it to not be written correctly." So you tell me who's the immovable object.