[Bug 187142] [handbook] [patch] The Handbook (chapter 15.4) does not mention /etc/jail.conf

bugzilla-noreply at freebsd.org bugzilla-noreply at freebsd.org
Tue Feb 27 16:02:53 UTC 2018


https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=187142

joeb1 at a1poweruser.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |joeb1 at a1poweruser.com

--- Comment #5 from joeb1 at a1poweruser.com ---
I also think removing all the old configuration documentation is the best
solution. To this all the ezjail documentation should also be removed because
ezjail uses the rc.conf configuration. 

Documenting how to use a port does not belong in the handbook, it belongs in
the port's manual. This had been the original policy of the handbook, but as
younger personal replaced the original handbook administration this policy was
violated with the addition of the ezjail section. 

A second issue is that readers of the jail section of the handbook see the
ezjail section and believe that tool is the recommended tool to use just
because its in the handbook. This is unfair to the other jail tools which use
jail.conf. 

For inspiration on a new jail section check out the jail-primer port.

-- 
You are receiving this mail because:
You are the assignee for the bug.


More information about the freebsd-doc mailing list