Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Symlinks for manual page invocation #4548
During an OpenSSL usability study we found out that many participants (more than a quarter) intuitively expected to find manual pages under
This could be easily solved by symlinking the manual pages.
Although this is mostly a thing of the ports to the individual operating systems, the upstream project can probably ease the setting (as suggested by @richsalz).
That's not the traditional man(1) behavior --
Additionally, it's not clear that having symlinks would be helpful for all packagers -- FreeBSD, for example, uses hard links for manual pages, so having upstream OpenSSL ship symlinks would just cause extra work for the FreeBSD packagers.
So, at present, I believe that this issue is best addressed by distro packagers and not in OpenSSL proper. (But I will leave the issue open for a bit in case there is more to say.)
I was describing a developer expectation behavior. We gave tasks to attendees of an international dev conference and over a quarter of the participants (~25/100 people) expected to find the man page under
Though, this is only a suggestion. Feel free to close it, if it's not widely deployable. I opened the issue based on the recommendation from @richsalz to spark the discussion.