From owner-freebsd-doc  Fri Jul 13 23:12:51 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from bazooka.unixfreak.org (bazooka.unixfreak.org [63.198.170.138])
	by hub.freebsd.org (Postfix) with ESMTP id D9B4637B405
	for <freebsd-doc@FreeBSD.org>; Fri, 13 Jul 2001 23:12:48 -0700 (PDT)
	(envelope-from dima@unixfreak.org)
Received: from hornet.unixfreak.org (hornet [63.198.170.140])
	by bazooka.unixfreak.org (Postfix) with ESMTP
	id 54EFF3E2F; Fri, 13 Jul 2001 23:12:48 -0700 (PDT)
To: Murray Stokely <murray.stokely@windriver.com>
Cc: freebsd-doc@FreeBSD.org
Subject: Re: marking up keystrokes 
In-Reply-To: <20010713183147.E27674@meow.osd.bsdi.com>; from murray.stokely@windriver.com on "Fri, 13 Jul 2001 18:31:47 -0700"
Date: Fri, 13 Jul 2001 23:12:48 -0700
From: Dima Dorfman <dima@unixfreak.org>
Message-Id: <20010714061248.54EFF3E2F@bazooka.unixfreak.org>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org

Murray Stokely <murray.stokely@windriver.com> writes:
>   &key.enter;
>   &key.ctrl.p;
>   &key.ctrl.alt.del;
>   &key.esc.p;
> 
>   Does anyone have any objections to me adding these to freebsd.ent
> and using them throughout the Handbook?  Other ideas?

Having an entity for every possible combination of <meta_key>-<something>
seems awfully wasteful.  Perhaps something like this:

	&key.ctrl;P

(note that 'P' isn't part of the entity) which would render as "Ctrl-P", or

	<keyctrl>P</keyctrl>

It's reasonable to have entities for the exotic comobinations (e.g.,
&key.ctrl.alt.del;), but I think having one for every letter will be a
maintenance headache.  If you only add the ones you need now,
non-committers will have trouble contrbuting something where they need an
entity that doesn't exist.

					Dima Dorfman
					dima@unixfreak.org

P.S.  Thanks for all your recent work on consistency; it's making things
look much better.  Perhaps you can get one of your minions to work on
making references to -stable and -current consistent, too, with the use of
the &stable; and &current; entities :-).

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message