From owner-freebsd-doc Sat Jul 14 3:21: 4 2001 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (pc-62-31-42-140-hy.blueyonder.co.uk [62.31.42.140]) by hub.freebsd.org (Postfix) with ESMTP id 1B02B37B401 for ; Sat, 14 Jul 2001 03:21:00 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.3/8.11.3) id f6EA8QL92999; Sat, 14 Jul 2001 11:08:26 +0100 (BST) (envelope-from nik) Date: Sat, 14 Jul 2001 11:08:26 +0100 From: Nik Clayton To: Murray Stokely Cc: freebsd-doc@FreeBSD.org Subject: Re: marking up keystrokes Message-ID: <20010714110826.F35484@clan.nothing-going-on.org> References: <20010713183147.E27674@meow.osd.bsdi.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="udcq9yAoWb9A4FsZ" Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010713183147.E27674@meow.osd.bsdi.com>; from murray.stokely@windriver.com on Fri, Jul 13, 2001 at 06:31:47PM -0700 Organization: FreeBSD Project 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 --udcq9yAoWb9A4FsZ Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Jul 13, 2001 at 06:31:47PM -0700, Murray Stokely wrote: > There is no consistency to the way we currently mark up keystrokes > in the documentation. A quick glance will find many different styles:=20 >=20 > 1. CTRL+P > 2. CTRL-P > 3. ctrl-p > 4. Ctrl-P >=20 > Sometimes these are wrapped in a , but usually not. > O'Reilly's style guide dictates the last entry, The only book I've > got on my desk at the moment seems to switch back and forth between #2 > and #4. Let the stylesheets do the work. The markup for something like that would be: CtrlP This is used all over the place in the FAQ (and should probably be documented in the Primer). Valid values for 'action' are: Click Double-Click Other Press Seq Simul More details at http://www.docbook.org/tdg/html/keycombo.html > I think we should standardize with #4 but #2 isn't bad either. In > any case, I think that we should introduce some entities to keep > everything nice and easy and also allow us to give the correct > markup emphasis to keystrokes. >=20 > &key.enter; > &key.ctrl.p; > &key.ctrl.alt.del; > &key.esc.p; >=20 > Does anyone have any objections to me adding these to freebsd.ent > and using them throughout the Handbook? Other ideas? Entities for the various keys might be handy, but they'd really need to be written as &keycode.foo; (since DocBook also has a KeyCode element, with which it could get confused. Then the markup might become something like &keycap.ctrl;&keycap.p; which is a small improvement. N --=20 FreeBSD: The Power to Serve http://www.freebsd.org/ FreeBSD Documentation Project http://www.freebsd.org/docproj/ --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- --udcq9yAoWb9A4FsZ Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: For info see http://www.gnupg.org iEYEARECAAYFAjtQGhoACgkQk6gHZCw343UD8wCfRCeYB03ZOzUuMI+ypdaOzC0U 7awAn1eoQUAB9wcy8YJR5PGKR1xWtoSG =BR/S -----END PGP SIGNATURE----- --udcq9yAoWb9A4FsZ-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message