Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 07 Jul 2013 09:55:04 +0100
From:      Frank Leonhardt <freebsd-doc@fjl.co.uk>
To:        Warren Block <wblock@wonkity.com>
Cc:        Glen Barber <gjb@FreeBSD.org>, freebsd-doc@FreeBSD.org
Subject:   Re: Fixing the man page for renice
Message-ID:  <51D92CE8.5050504@fjl.co.uk>
In-Reply-To: <alpine.BSF.2.00.1307061509150.43809@wonkity.com>
References:  <51D7FE78.8050006@fjl.co.uk> <20130706152811.GJ20631@glenbarber.us> <51D845F6.1040402@fjl.co.uk> <alpine.BSF.2.00.1307061509150.43809@wonkity.com>

next in thread | previous in thread | raw e-mail | index | archive | help
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.




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?51D92CE8.5050504>