1 <?xml version="1.0" standalone="no"?>
3 <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
7 <section id="sn-formatting-conventions">
8 <title>Formatting Conventions</title>
9 <section id="typography">
10 <title>Typography</title>
12 This manual uses a few conventions to indicate key commands, menu choices
13 and other user interactions:
17 Key commands such as <keycombo><keycap>Ctrl</keycap><keycap>a</keycap>
18 </keycombo> mean "Hold down the Ctrl key and press the 'a' key". New and
19 important terms are written like this.
23 The names of on-screen buttons are shown like this
24 <guibutton>Button</guibutton>
28 The name of a menu item is shown like <guimenuitem>This</guimenuitem>,
29 and nested menu items will appear like <menuchoice> <guimenu>Menu</guimenu>
30 <guisubmenu>Sub Menu</guisubmenu> </menuchoice>
34 <section id="admonitions">
35 <title>Admonitions</title>
38 Admonitions are set apart from the main
39 text and are meant to draw your attention to pieces of information.
40 In the order of how critical the information is to you, these items are marked as follows:
47 A note is typically information that you need to understand the
55 A tip is typically an alternative way of performing a task.
60 <title>Important</title>
63 Some appropriate definition
68 <title>Caution</title>
71 Some appropriate definition
76 <title>Warning</title>
79 Some appropriate definition
84 <section id="mouse-buttons">
85 <title>Mouse Buttons</title>
87 You might be used to terms like "right mouse button", "left mouse button"
88 etc. These are widely used, but they can be very confusing for left-handed
89 people, or people using mice with many buttons arranged in an
90 unconventional way. Ardour is typically used with mice equipped with at
91 least 3 buttons that can be remapped for left- and right-handed users,
92 making it hard to unambiguously define "left" and "right" in a useful way.
96 If you are right-handed and use a conventional mouse, then
97 <mousebutton>Button1</mousebutton> corresponds to "left mouse button",
98 <mousebutton>Button2</mousebutton> to "middle mouse button" and
99 <mousebutton>Button3</mousebutton> to "right mouse button". Otherwise, the
100 numbered button nomenclature refers to the same button numbers as defined
101 by your X Window configuration.
105 If you see instructions to use <keycombo><keycap>Ctrl</keycap>
106 <mousebutton>Button1</mousebutton> </keycombo> , it means "Hold down the
107 <keycap>Ctrl</keycap> key and click <mousebutton>Button1</mousebutton> ".
111 <section id="select-choose">
112 <title>Select/Choose</title>
114 In conventional English, "select" and "choose" are often used as synonyms.
115 In this manual, we use them to mean quite different things:
124 When you select something, it will stay selected. Putting a check-mark
125 in a box, for example, would be referred to as "selecting" that box.
126 This is also true for menu items that enable or disable options ("select
127 Big Clock from the Windows menu", for example) and various editing
137 "Choosing" involves clicking or using the keyboard to accomplish a
138 one-time action. A command to save the current session might be
139 described as, "Choose Save from the Session menu.
146 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
147 href="Some_Subsection.xml" />