Bug 29088

Summary: jail(8) man page has innacurate instructions.
Product: Documentation Reporter: Philip Hallstrom <philip>
Component: Books & ArticlesAssignee: Poul-Henning Kamp <phk>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Philip Hallstrom 2001-07-19 22:00:00 UTC
In the "Setting up a Jail Directory Tree" of the man page jail(8) it gives some instructions for setting up a jail.  It fails to mention that you need to create the jail directory first.  I figured the "make buildworld" or one of the following commands would create it, but it does not.   "make buildworld" eventually fails on an "mtree" command.

Fix: 

Either change the manpage or change the build process to create the directory if it doesn't already exist.
Comment 1 FUJISHIMA Satsuki freebsd_committer freebsd_triage 2001-07-21 19:05:52 UTC
Responsible Changed
From-To: freebsd-bugs->phk

Over to the author.
Comment 2 FUJISHIMA Satsuki freebsd_committer freebsd_triage 2001-07-21 19:07:44 UTC
I think the originator requests a line of enhancement like this.

Index: src/usr.sbin/jail/jail.8
===================================================================
RCS file: /home/ncvs/src/usr.sbin/jail/jail.8,v
retrieving revision 1.28
diff -u -r1.28 jail.8
--- src/usr.sbin/jail/jail.8	2001/07/15 08:02:00	1.28
+++ src/usr.sbin/jail/jail.8	2001/07/21 10:59:36
@@ -59,6 +59,7 @@
 This shows how to setup a jail directory tree:
 .Bd -literal
 D=/here/is/the/jail
+mkdir -p $D
 cd /usr/src
 make world DESTDIR=$D
 cd etc
Comment 3 Johan Karlsson freebsd_committer freebsd_triage 2002-04-24 01:17:35 UTC
State Changed
From-To: open->patched

Fixed in rev 1.33. 

MFC reminder.
Comment 4 Poul-Henning Kamp freebsd_committer freebsd_triage 2002-05-11 07:27:34 UTC
State Changed
From-To: patched->closed

Fixed by Johan K and jedgar, thanks guys!