pfSense

Jim Pingle wrote in #note-1:

If you hit the help link on the page (The "(?)" icon in the breadcrumb bar) the items in question are documented in the pfSense online docs now (https://docs.netgate.com/pfsense/en/latest/services/dns/resolver-config.html), so it's best to remove the man page reference and link to that instead.

That said, FreeBSD man pages are all available on the web via https://www.freebsd.org/cgi/man.cgi so there little need to host extra copies of them locally since the web copies are more recently up-to-date. We could change the link to point there, perhaps, but since it's documented in the pfSense docs now it makes more sense to link there. At the time the man page reference was added that content was not in the pfSense docs.

Thanks Jim,

I'm aware the man pages and other documentation bits are available online and was able to find the information before opening this issue. However when you're offline working on something, having the documentation offline with you is valuable. Maybe I'm the exception but it's not uncommon for me to find myself working in a situation where I have no cellular signal and there's not a computer with a web browser available. Running back and forth outside or up several flights of stairs to look things up is inconvenient at best.

The larger debate over offline docs/man pages isn't relevant to this case, though. I believe there is already an open Redmine issue for that. In the past we didn't include such things because of space constraints but in most cases those are no longer a concern these days, though again that isn't relevant to this specific reference as it's a much larger architectural topic.

You can always grab a PDF or ePub copy of the docs (linked at the top of https://docs.netgate.com/pfsense/en/latest/ ) and keep it nearby on a tablet, phone, laptop, etc.