From owner-freebsd-doc@FreeBSD.ORG Sun Jul 7 13:15:55 2013 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id D78B7FD0; Sun, 7 Jul 2013 13:15:55 +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 772FA1469; Sun, 7 Jul 2013 13:15:55 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id r67CtPh0049329; Sun, 7 Jul 2013 06:55:25 -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 r67CtOXl049326; Sun, 7 Jul 2013 06:55:25 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Sun, 7 Jul 2013 06:55:24 -0600 (MDT) From: Warren Block To: Frank Leonhardt Subject: Re: Fixing the man page for renice In-Reply-To: <51D92CE8.5050504@fjl.co.uk> Message-ID: References: <51D7FE78.8050006@fjl.co.uk> <20130706152811.GJ20631@glenbarber.us> <51D845F6.1040402@fjl.co.uk> <51D92CE8.5050504@fjl.co.uk> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: MULTIPART/MIXED; BOUNDARY="3512871622-2040356913-1373201725=:49310" X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Sun, 07 Jul 2013 06:55:25 -0600 (MDT) Cc: Glen Barber , freebsd-doc@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 07 Jul 2013 13:15:55 -0000 This message is in MIME format. The first part should be readable text, while the remaining parts are likely unreadable without MIME-aware tools. --3512871622-2040356913-1373201725=:49310 Content-Type: TEXT/PLAIN; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 8BIT On Sun, 7 Jul 2013, Frank Leonhardt wrote: > 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. I should have mentioned that the one to edit is renice.8, but maybe it was clear. If Subversion was used to check out the source, just edit that file. When done, produce a patch with cd /usr/src svn diff usr.bin/renice/renice.8 > ~/renice.8.diff Also, mdoc(7) is the reference for the mdoc macros. Sadly, we don't have anything about it in the FDP Primer. > 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. That would be great! Thanks! --3512871622-2040356913-1373201725=:49310--