From owner-freebsd-doc@FreeBSD.ORG Mon May 19 13:34:54 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 C79CD37B401; Mon, 19 May 2003 13:34:54 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id F010D43FA3; Mon, 19 May 2003 13:34:53 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id D625610BF81; Mon, 19 May 2003 22:34:52 +0200 (CEST) Date: Mon, 19 May 2003 22:34:52 +0200 From: "Simon L. Nielsen" To: Tom Rhodes Message-ID: <20030519203451.GB1120@nitro.dk> References: <20030519192255.GB74434@submonkey.net> <20030519153048.51f20a06.trhodes@FreeBSD.org> <20030519200900.GA1120@nitro.dk> <20030519161700.27143841.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="WYTEVAkct0FjGQmd" Content-Disposition: inline In-Reply-To: <20030519161700.27143841.trhodes@FreeBSD.org> User-Agent: Mutt/1.5.4i cc: freebsd-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 20:34:55 -0000 --WYTEVAkct0FjGQmd Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.05.19 16:17:00 -0400, Tom Rhodes wrote: > On Mon, 19 May 2003 22:09:06 +0200 > "Simon L. Nielsen" <simon@nitro.dk> wrote: >=20 > > On 2003.05.19 15:30:48 -0400, Tom Rhodes wrote: > >=20 > > > I'd like to chime in here if you do not mind. While I was thinking > > > about this just last night, a question arose as to which is more appr= opriate: > > > <command> or manual page entities. > >=20 > > In a patch I used man entities multiple times shortly after each other > > and Murrays changed it in the committed version to only use it the first > > time and use <command> for the other cases. > >=20 > > <comment by Murray from docs/50790 audit trail> > > One thing to note is > > that it doesn't look good to use the man page entities twice in close= =20 > > proximity. So I used &man.dumpon.8; the first time, then just used=20 > > <command>dumpon</command> elsewhere in the paragraph.=20 > > </comment> > >=20 > > I think this is seems like a good way since the man reference is still > > nice to have. >=20 > Ok, I see the logic here. Thanks guys. Perhaps it would be a good idea to add a short note about this to the section about "Applications, commands, options, and cites" in the FDP primer ? I can make a patch if it sounds like a good idea... --=20 Simon L. Nielsen --WYTEVAkct0FjGQmd Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+yT/r8kocFXgPTRwRApojAKCQiVtkUveWU72DTkqg5/O99cRwGACfVROy 9fUoytpsfnYenFgF489pdAM= =1bgt -----END PGP SIGNATURE----- --WYTEVAkct0FjGQmd--