Opened 20 months ago
Closed 6 months ago
#790 closed enhancement (duplicate)
Add Link to Online FreeBSD Man Pages to Help Button
| Reported by: | dlavigne | Owned by: | |
|---|---|---|---|
| Priority: | minor | Milestone: | |
| Component: | GUI | Version: | 8.0.1-RC1 |
| Keywords: | Cc: |
Description
The docs reference many FreeBSD manpages but these are stripped out of NanoBSD. Adding a hyperlink pointing to http://www.freebsd.org/cgi/man.cgi in the Help button would make manpage access easier for users without access to a FreeBSD system.
Change History (3)
comment:1 Changed 20 months ago by gcooper
comment:2 Changed 20 months ago by dlavigne
I could, but that would be a lot of hyperlinks to change whenever a new version of FreeBSD is released. Having one link in the Help button would allow the user to search themselves for any version and a "Conventions Used" section at the beginning of the documentation could instruct users to use the online search whenever they see a command/filename followed by a (#).
For example, I could hyperlink nologin(8) to http://www.freebsd.org/cgi/man.cgi?query=nologin&apropos=0&sektion=0&manpath=FreeBSD+8.2-RELEASE&arch=default&format=html (the search result) but would have to change it when FreeNAS bumps up to FreeBSD 9.0.
comment:3 Changed 6 months ago by william
- Resolution set to duplicate
- Status changed from new to closed
Duplicated of #1920 (supersede this)

Or maybe the docs should just reference the manpages directly? Not all of the docs are available with the base system, which what freebsd.org advertises -- unless you go to a Linux distro and happen to punch in the right info, in which case you might get a manpage that's out of sync with the software on the system.
Eventually we sort of need to get away from providing direct/unpolished shell access to beginning / intermediate end-users (advanced users should understand what they're doing by default).