Bug 219421 - [patch] handbook jail chapter removing ezjail section
Summary: [patch] handbook jail chapter removing ezjail section
Status: Closed Not Accepted
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: freebsd-doc (Nobody)
URL:
Keywords: patch
Depends on:
Blocks:
 
Reported: 2017-05-20 17:57 UTC by Joe Barbish
Modified: 2017-05-24 21:26 UTC (History)
2 users (show)

See Also:


Attachments
handbook jail chapter diff file (26.86 KB, patch)
2017-05-20 17:57 UTC, Joe Barbish
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
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.