Date: Mon, 19 May 2003 22:34:52 +0200 From: "Simon L. Nielsen" <simon@nitro.dk> To: Tom Rhodes <trhodes@FreeBSD.org> Cc: freebsd-doc@freebsd.org Subject: Re: Application and command names in <title> elements Message-ID: <20030519203451.GB1120@nitro.dk> In-Reply-To: <20030519161700.27143841.trhodes@FreeBSD.org> References: <20030519192255.GB74434@submonkey.net> <20030519153048.51f20a06.trhodes@FreeBSD.org> <20030519200900.GA1120@nitro.dk> <20030519161700.27143841.trhodes@FreeBSD.org>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --] 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: > > > On 2003.05.19 15:30:48 -0400, Tom Rhodes wrote: > > > > > 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 appropriate: > > > <command> or manual page entities. > > > > 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. > > > > <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 > > proximity. So I used &man.dumpon.8; the first time, then just used > > <command>dumpon</command> elsewhere in the paragraph. > > </comment> > > > > I think this is seems like a good way since the man reference is still > > nice to have. > > 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... -- Simon L. Nielsen [-- Attachment #2 --] -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+yT/r8kocFXgPTRwRApojAKCQiVtkUveWU72DTkqg5/O99cRwGACfVROy 9fUoytpsfnYenFgF489pdAM= =1bgt -----END PGP SIGNATURE-----help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030519203451.GB1120>