which(1): Add EXAMPLES section to manpage

[fernape]

Summary

Add EXAMPLES section showing the use of -a and -s flags and how which(1)
treates duplicates.

Test Plan

• mandoc -Tlint clean
• igor clean (a spurious warning for the first line)
• aspell happy
• man ./which.1 renders the page properly

[gbe]

usr.bin/which/which.1

72

Is there a reason, why you use the full path of the executable?

[fernape]

usr.bin/which/which.1

72

Is there a reason, why you use the full path of the executable?

First of all, thanks for reviewing and sorry for my late response. I was AFK for some days :-)

I did it for consistency. The examples that play with $PATH need the full path, or the which command will not be found.

I see a couple of options:

• We can leave this as it is (first and last examples would not need the full path though, and that might be confusing)
• I can use full path only where it is needed (examples 2 and 3) and add a note to indicate why we are using it that way.

Thanks!

[gbe]

usr.bin/which/which.1

72

Oh, I wasn't aware that the full path is needed if a specific PATH variable is set. Then I would leave it as is.

[fernape]

Thanks for reviewing this!