From owner-freebsd-doc Fri Jul 13 18:31:59 2001 Delivered-To: freebsd-doc@freebsd.org Received: from meow.osd.bsdi.com (meow.osd.bsdi.com [204.216.28.88]) by hub.freebsd.org (Postfix) with ESMTP id 4431E37B409 for ; Fri, 13 Jul 2001 18:31:57 -0700 (PDT) (envelope-from murray@meow.osd.bsdi.com) Received: (from murray@localhost) by meow.osd.bsdi.com (8.11.4/8.11.2) id f6E1Vlj34565 for freebsd-doc@FreeBSD.org; Fri, 13 Jul 2001 18:31:47 -0700 (PDT) (envelope-from murray) Date: Fri, 13 Jul 2001 18:31:47 -0700 From: Murray Stokely To: freebsd-doc@FreeBSD.org Subject: marking up keystrokes Message-ID: <20010713183147.E27674@meow.osd.bsdi.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D 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 There is no consistency to the way we currently mark up keystrokes in the documentation. A quick glance will find many different styles: 1. CTRL+P 2. CTRL-P 3. ctrl-p 4. Ctrl-P 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. 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. &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? - Murray To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message