> what do you want here, really? in my opinion, readers of section one > pages should not be pointed to code. yes, yes, yes, other people > disagree. but no one using sleep(1) will care. > > so you propose to remove the Xr to alarm(). that's a function mandated > by posix. why make people less aware of that interface? really?
I would like to propose a diff which modified the csh manual page, so it has an Xr to every function in libc which csh uses... It's a stupid model. Unless there is great benefit, there should be no Xr. With sleep, there is ABSOLUTELY ZERO BENEFIT to link to any section 2 manual pages. > second, why replace, in sleep(3), the reference to usleep with setitimer? > usleep(3) says it is obsoleted by nanosleep(2), not setitimer(2). and > additionally the posix page for sleep() lists getitimer, not setitimer. > that's the name of our page, too. That again is irrelevant. Ingo, you should delete them all. They serve no point. > my advice is to remove all 2/3 refs in sleep(1), and just zap the > usleep ref in sleep(3). since people who never previously cared about > this will now start caring, ask yourself whether it's worth it. I agree completely. If the benefit is low, kill them, or leave the files alone. There are more important battles. Please do not churn up mud from the bottom by making pointless pick & choose decisions.
