-----BEGIN PGP SIGNED MESSAGE----- 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: Press <keycombo> <keycap>Ctrl</keycap> <keycap>Alt</keycap> <keycap>Del</keycap> </keycombo> 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 <userinput>:wq</userinput> 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 -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.1 (GNU/Linux) Comment: Using GnuPG with Fedora - http://enigmail.mozdev.org iD8DBQFDhM8uDvp49DvQ8kcRAh+GAJ9R0hFXizWMNfZj2+5xbQR7duyoYQCfd58G XNqh9lHZpPUen67vtwEddow= =im/R -----END PGP SIGNATURE----- -- fedora-docs-list@xxxxxxxxxx To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-docs-list
