From owner-freebsd-doc Sat May 11 19:50: 8 2002 Delivered-To: freebsd-doc@hub.freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 246D337B407 for ; Sat, 11 May 2002 19:50:04 -0700 (PDT) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g4C2o4U94839; Sat, 11 May 2002 19:50:04 -0700 (PDT) (envelope-from gnats) Date: Sat, 11 May 2002 19:50:04 -0700 (PDT) Message-Id: <200205120250.g4C2o4U94839@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org Cc: From: Giorgos Keramidas Subject: Re: docs/26943: [patch] description of :C modifier is misplaced in make.1 Reply-To: Giorgos Keramidas Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The following reply was made to PR docs/26943; it has been noted by GNATS. From: Giorgos Keramidas To: Alex Kapranoff Cc: bug-followup@freebsd.org Subject: Re: docs/26943: [patch] description of :C modifier is misplaced in make.1 Date: Sun, 12 May 2002 05:44:56 +0300 On 2001-04-29 10:55, Alex Kapranoff wrote: > make.1 manpage describes :C modifier in comparison to :S, but > before :S. That brings some inconvenience for first-time > readers. The first patch moves :C section just below :S (cut-n-paste > only, no semantic changes) and the second adds some > insignificant markup to the section. > Responsible-Changed-From-To: freebsd-bugs->freebsd-doc > Responsible-Changed-By: cjc > Responsible-Changed-When: Wed Feb 20 08:42:11 PST 2002 > Responsible-Changed-Why: > The docs guys can take care of this, please? I think that the idea behind this was that a lot of the stuff that is relevant to :C is already described in the section of :S, but since :C came second the text was left at :S. The modifiers are sorted alphabetically, so it makes more sense to keep :C in the proper place than move it under :S just to save a few page-down keys. Of course this is MHO. The second diff, that is part of this PR which adds .Ar macros in a couple of places, looks fine to me. I'd like this (the second diff only) to be committed if nobody objects. Comments, anyone else? - Giorgos To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message