Bug 219421

Summary: [patch] handbook jail chapter removing ezjail section
Product: Documentation Reporter: Joe Barbish <qjail1>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed Not Accepted    
Severity: Affects Many People CC: brd, linimon
Priority: --- Keywords: patch
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
handbook jail chapter diff file none

Description Joe Barbish 2017-05-20 17:57:32 UTC
Created attachment 182757 [details]
handbook jail chapter diff file

In the comments for PR # 218849 people voiced concerns that it is inappropriate for the handbook to devote a section on how to use a port. That information belongs in the ports own documentation. Ezjail uses the /etc/rc.d/jail script to auto convert to the new jail.conf method which has been available since 10.0. Ezjail has not used the last 2 years to change over to using the jail.conf method.

PR # 218849 deals with removing the auto conversion code from the /etc/rc.d/jail script. The ezjail maintainer has been provided a very simple patch to solve this problem. 

This handbook patch removes all ezjail documentation from the handbook jail chapter and adds an political correct entry which is fair to all the jail management utilities in the port system as seen below. 


14.4.2. High-Level Administrative Tools in the FreeBSD Ports Collection

Manually creating and managing jails can quickly become tedious and error-prone. The ports collection contains some utilities designed to simplify jail management. Their listing here doesn't imply an recommendation or endorsement. Nothing more than a list of the different names of jail utilities in the ports sysutils category that you may want to review.

bsdploy, cbsd, ezjail, iocage, iocell, jail-primer, jailadmin, qjail, warden


Take note: This patch was made using the textproc/docproj package.
Comment 1 Mark Linimon freebsd_committer freebsd_triage 2017-05-20 21:34:21 UTC
I strongly object to this patch.  I do not wish to see information removed from the handbook for political reasons.
Comment 2 Brad Davis freebsd_committer freebsd_triage 2017-05-24 21:26:06 UTC
Yeah, we are not just going to commit a patch that removes a bunch of useful information and replaces it with nothing.

If you really want to see this seriously considered, please submit with documentation on using the replacement method.