From owner-freebsd-doc@FreeBSD.ORG Mon May 19 14:25:24 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 16E1F37B401; Mon, 19 May 2003 14:25:24 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id D244443F75; Mon, 19 May 2003 14:25:22 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4JLPLka012488; Mon, 19 May 2003 17:25:21 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Mon, 19 May 2003 17:18:04 -0400 From: Tom Rhodes To: Marc Fonvieille Message-Id: <20030519171804.25e00041.trhodes@FreeBSD.org> In-Reply-To: <20030519195925.GC571@nosferatu.blackend.org> References: <20030519192255.GB74434@submonkey.net> <20030519153048.51f20a06.trhodes@FreeBSD.org> <20030519195925.GC571@nosferatu.blackend.org> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: ceri@FreeBSD.org cc: doc@FreeBSD.org Subject: Re: Application and command names in elements X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/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: Mon, 19 May 2003 21:25:24 -0000 On Mon, 19 May 2003 21:59:25 +0200 Marc Fonvieille <blackend@FreeBSD.org> wrote: > On Mon, May 19, 2003 at 03:30:48PM -0400, Tom Rhodes wrote: > > > > > There seems to be mixed usage of the command and manual page entities. > [...] > > When we have the choice between <command></command> and manual page for > a command name (just the name, not a command with parameters) > the manual page entity should be used. > > Marc > After reading the different replies to this, I like the way murray and ceri put it. Use the manual page entity first, and use command if the utility is mentioned again within proximity. I'll do this from now on. Thanks everyone. -- Tom Rhodes