From owner-freebsd-current@freebsd.org  Sun Oct 29 20:53:20 2017
Return-Path: <owner-freebsd-current@freebsd.org>
Delivered-To: freebsd-current@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id B6265E4C463
 for <freebsd-current@mailman.ysv.freebsd.org>;
 Sun, 29 Oct 2017 20:53:20 +0000 (UTC)
 (envelope-from freebsd-rwg@pdx.rh.CN85.dnsmgr.net)
Received: from pdx.rh.CN85.dnsmgr.net (br1.CN84in.dnsmgr.net [69.59.192.140])
 (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
 (Client did not present a certificate)
 by mx1.freebsd.org (Postfix) with ESMTPS id 854D066859;
 Sun, 29 Oct 2017 20:53:19 +0000 (UTC)
 (envelope-from freebsd-rwg@pdx.rh.CN85.dnsmgr.net)
Received: from pdx.rh.CN85.dnsmgr.net (localhost [127.0.0.1])
 by pdx.rh.CN85.dnsmgr.net (8.13.3/8.13.3) with ESMTP id v9TKrC5w072017;
 Sun, 29 Oct 2017 13:53:12 -0700 (PDT)
 (envelope-from freebsd-rwg@pdx.rh.CN85.dnsmgr.net)
Received: (from freebsd-rwg@localhost)
 by pdx.rh.CN85.dnsmgr.net (8.13.3/8.13.3/Submit) id v9TKrCuZ072016;
 Sun, 29 Oct 2017 13:53:12 -0700 (PDT) (envelope-from freebsd-rwg)
From: "Rodney W. Grimes" <freebsd-rwg@pdx.rh.CN85.dnsmgr.net>
Message-Id: <201710292053.v9TKrCuZ072016@pdx.rh.CN85.dnsmgr.net>
Subject: Re: FreeBSD Documentation
In-Reply-To: <f5415cb5-939c-70d2-907e-37293f93bdd5@freebsd.org>
To: Allan Jude <allanjude@freebsd.org>
Date: Sun, 29 Oct 2017 13:53:12 -0700 (PDT)
CC: freebsd-current@freebsd.org
X-Mailer: ELM [version 2.4ME+ PL121h (25)]
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset=US-ASCII
X-Mailman-Approved-At: Sun, 29 Oct 2017 23:50:59 +0000
X-BeenThere: freebsd-current@freebsd.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: Discussions about the use of FreeBSD-current
 <freebsd-current.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-current>, 
 <mailto:freebsd-current-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-current/>
List-Post: <mailto:freebsd-current@freebsd.org>
List-Help: <mailto:freebsd-current-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-current>, 
 <mailto:freebsd-current-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 29 Oct 2017 20:53:20 -0000

-- Start of PGP signed section.
[ Charset UTF-8 unsupported, converting... ]
> On 2017-10-29 11:00, Kurt Jaeger wrote:
> > Hi!
> > 
> >> How can we suggest edits for the docs?
> > 
> > Checkout the docs repo:
> > 
> >   svn checkout https://svnweb.freebsd.org/doc/head/ .
> > 
> > Change the relevant files, create a new problem report on
> > 
> >   https://bugs.freebsd.org/
> > 
> > and attach the svn diff to that problem report.
> > 
> 
> Since the document in question is a man page, it actually lives in the
> src tree.
> 
> svn checkout https://svn.freebsd.org/base/head/ .
> 
> cd usr.sbin/jail
> 
> vi jail.8
> 
> svn diff > jail_manpage.patch
> 
> And then attach that patch to a bugzilla, or upload it to
> reviews.freebsd.org

Lets make this MUCH easier on a user.....
cp /usr/share/man/man8/jail.8.gz /tmp
cd /tmp
gzip -d jail.8.gz
cp -p jail.8 jail.8.orig
vi jail.8
diff -u jail.8.orig jail.8 >jail.8.patch

And then attach that patch to a bugzilla....

More commands, but much shorter amount of time.

(Of cource broken if your system is not -current or close to it)
-- 
Rod Grimes                                                 rgrimes@freebsd.org