[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

Best tagging practice: multi-key sequences?

Hash: SHA1

Hello all,

I've come upon another scenario where I'm unsure what the best tagging
practice would be.

In general, if a user is instructed to perform a key combo we use the
keycombo and keycap tags:

	to initiate a reboot.

or, in the case of a key sequence, something like:

	Press <keycap>Esc</keycap>, <keycap>.</keycap> to recall the
	last argument of the last command in <command>bash</command>

When the user is being asked to type in text, we use userinput:

	Enter the text <userinput>I like penguins!</userinput> into
	text document.

The issue is that we're now marking up documentation that deals with
using vi and things are becoming a bit more ambiguous. What about an
instruction like:

	To save and quit, press :wq while in command mode

Technically, since :wq is a set of keypresses, rather than arbitrary
text that the user is entering, it seems that it should be marked up as

<keypress>:</keypress>, <keypress>w</keypress>, <keypress>q</keypress>

...but that is awfully klunky. We've instead been opting for


even though that is arguably incorrect.

The FDP docs guide doesn't really address situations like this
(multi-key sequences) directly, so is there an informal standard we
should know about before settling on one or the other?

- --Brad
Version: GnuPG v1.4.1 (GNU/Linux)
Comment: Using GnuPG with Fedora - http://enigmail.mozdev.org


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]