From owner-freebsd-doc@FreeBSD.ORG  Sat Jul  6 21:19:14 2013
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 by hub.freebsd.org (Postfix) with ESMTP id 4B737340;
 Sat,  6 Jul 2013 21:19:14 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 by mx1.freebsd.org (Postfix) with ESMTP id 0753C1641;
 Sat,  6 Jul 2013 21:19:13 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.7/8.14.7) with ESMTP id r66LJ9v4043919;
 Sat, 6 Jul 2013 15:19:09 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r66LJ9B3043916;
 Sat, 6 Jul 2013 15:19:09 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Sat, 6 Jul 2013 15:19:09 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Frank Leonhardt <freebsd-doc@fjl.co.uk>
Subject: Re: Fixing the man page for renice
In-Reply-To: <51D845F6.1040402@fjl.co.uk>
Message-ID: <alpine.BSF.2.00.1307061509150.43809@wonkity.com>
References: <51D7FE78.8050006@fjl.co.uk>
 <20130706152811.GJ20631@glenbarber.us> <51D845F6.1040402@fjl.co.uk>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Sat, 06 Jul 2013 15:19:09 -0600 (MDT)
Cc: Glen Barber <gjb@FreeBSD.org>, freebsd-doc@FreeBSD.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 06 Jul 2013 21:19:14 -0000

On Sat, 6 Jul 2013, Frank Leonhardt wrote:
> On 06/07/2013 16:28, Glen Barber wrote:
>
> Thanks Glen - the "patch" business is what's putting me off! I'm sure once 
> I've done it, nothing will stop me. Is there a page or *really simple* guide 
> to doing it, that assumes nothing?

Assuming the source in is /usr/src:
   cd /usr/src/usr.bin/renice
   cp renice.8 renice.8.orig

Edit the new version as desired.  When done,
   cd /usr/src
   diff -u usr.bin/renice/renice.8.orig usr.bin/renice/renice.8 > ~/renice.diff

This is a bit easier if you use Subversion to check out the source.

> I'm tempted to re-write the whole lot, but I'm successfully resisting.

The use of asides, "the affected processes will run only when nothing 
else in the system wants to", and "administrative fiats" make me 
twitchy.  It seems more complicated than necessary and could stand with 
some clarity improvements.