Add appendix to documentation that contains smb.conf manpage for version of Samba shipping with FreeNAS
The smb.conf manpage on Samba's website is crazy out of date. Default parameters (and even what parameters actually do) can vary between samba versions. See "smb encrypt". The manpage included with samba is (I hope) always the correct version for the version of Samba with which it is packaged. It would be nice to have the correct version of the smb.conf manpage somewhere in the docs as an appendix / reference.
Example of crappy out-of-date manpage - https://www.samba.org/samba/docs/man/manpages/smb.conf.5.html
#4 Updated by an odos about 3 years ago
Warren Block wrote:
If there is an online source, we can link to that. We can't link to a local file because it won't necessarily exist. For now, changing links from the poorly-rendered sloop version to the Samba site version.
This isn't a very good solution. In addition to being poorly rendered, the sloop version is also out of date / incorrect.
You're better off just linking to the relevant samba project github page if you're going that route: https://github.com/samba-team/samba/blob/v4-3-stable/docs-xml/manpages/smb.conf.5.xml