From owner-freebsd-doc@FreeBSD.ORG  Sun Jul  7 08:55:18 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 380CD751;
 Sun,  7 Jul 2013 08:55:18 +0000 (UTC)
 (envelope-from freebsd-doc@fjl.co.uk)
Received: from bs1.fjl.org.uk (bs1.fjl.org.uk [84.45.41.196])
 by mx1.freebsd.org (Postfix) with ESMTP id C29EE1B0D;
 Sun,  7 Jul 2013 08:55:17 +0000 (UTC)
Received: from [192.168.1.35] (mux.fjl.org.uk [62.3.120.246])
 (authenticated bits=0)
 by bs1.fjl.org.uk (8.14.4/8.14.4) with ESMTP id r678tEAE052367
 (version=TLSv1/SSLv3 cipher=DHE-DSS-CAMELLIA256-SHA bits=256 verify=NO);
 Sun, 7 Jul 2013 09:55:15 +0100 (BST)
 (envelope-from freebsd-doc@fjl.co.uk)
Message-ID: <51D92CE8.5050504@fjl.co.uk>
Date: Sun, 07 Jul 2013 09:55:04 +0100
From: Frank Leonhardt <freebsd-doc@fjl.co.uk>
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64;
 rv:17.0) Gecko/20130620 Thunderbird/17.0.7
MIME-Version: 1.0
To: Warren Block <wblock@wonkity.com>
Subject: Re: Fixing the man page for renice
References: <51D7FE78.8050006@fjl.co.uk>
 <20130706152811.GJ20631@glenbarber.us> <51D845F6.1040402@fjl.co.uk>
 <alpine.BSF.2.00.1307061509150.43809@wonkity.com>
In-Reply-To: <alpine.BSF.2.00.1307061509150.43809@wonkity.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-Content-Filtered-By: Mailman/MimeDel 2.1.14
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: Sun, 07 Jul 2013 08:55:18 -0000

On 06/07/2013 22:19, Warren Block wrote:
> 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.

Thank you so much for the "idiot's guide". It's exactly what I needed 
for the first time around.

As to the language style, I was also worrying about things like "...can 
only monotonically increase...", but perhaps my memories of calculus are 
sub-par and it'd be as clear as day to the rest of the world. I'm 
inclined to do a radical rewrite and a tweak and post them both here for 
the list to decide.

Regards, Frank.