1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
<?xml version="1.0" standalone="no"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
]>
<section id="sn-formatting-conventions">
<title>Formatting Conventions</title>
<section id="typography">
<title>Typography</title>
<para>
This manual uses a few conventions to indicate key commands, menu
choices and other user interactions:
</para>
<para>
Key commands such as <keycombo><keycap>Ctrl</keycap><keycap>a</keycap>
</keycombo> mean "Hold down the Ctrl key and press the 'a' key".
</para>
<para>
The names of on-screen buttons are shown like this
<guibutton>Button</guibutton>
</para>
<para>
The name of a menu item is shown like <guimenuitem>This</guimenuitem>,
and nested menu items will appear as <menuchoice>
<guimenu>Menu</guimenu> <guisubmenu>Sub Menu</guisubmenu>
</menuchoice>
</para>
</section>
<section id="admonitions">
<title>Admonitions</title>
<para>
Admonitions are set apart from the main text and are meant to draw
your attention to pieces of information. In the order of how critical
the information is to you, these items are marked as follows:
</para>
<note>
<title>Note</title>
<para>
A note is typically information that you need to understand the
behavior of Ardour.
</para>
</note>
<tip><title>Tip</title>
<para>
A tip is typically an alternative way of performing a task.
</para>
</tip>
<important>
<title>Important</title>
<para>
The important admonition is used to draw attention to parts of the
interface that may be overlooked or certain settings that are vital
in determining the behaviour of ardour.
</para>
</important>
<warning>
<title>Warning</title>
<para>
The warning admonition is used where an action may result in
consequences that are unintended or permanent such as changes to the
session that can not be undone or the removal of files.
</para>
</warning>
</section>
<section id="mouse-buttons">
<title>Mouse Buttons</title>
<para>
You might be used to terms like "right mouse button", "left mouse
button" etc. These are widely used, but they can be very confusing for
left-handed people, or people using mice with many buttons arranged in
an unconventional way. Ardour is typically used with mice equipped
with at least 3 buttons that can be remapped for left- and
right-handed users, making it hard to unambiguously define "left" and
"right" in a useful way.
</para>
<para>
If you are right-handed and use a conventional mouse, then
<mousebutton>Button1</mousebutton> corresponds to "left mouse button",
<mousebutton>Button2</mousebutton> to "middle mouse button" and
<mousebutton>Button3</mousebutton> to "right mouse button". Otherwise,
the numbered button nomenclature refers to the same button numbers as
defined by your X Window configuration.
</para>
<para>
If you see instructions to use <keycombo><keycap>Ctrl</keycap>
<mousebutton>Button1</mousebutton> </keycombo> , it means "Hold down
the <keycap>Ctrl</keycap> key and click
<mousebutton>Button1</mousebutton> ".
</para>
</section>
<section id="select-choose">
<title>Select/Choose</title>
<para>
In conventional English, "select" and "choose" are often used as
synonyms. In this manual, we use them to mean quite different things:
</para>
<variablelist>
<title></title>
<varlistentry>
<term>Select</term>
<listitem>
<para>
When you select something, it will stay selected. Putting a
check-mark in a box, for example, would be referred to as
"selecting" that box. This is also true for menu items that
enable or disable options ("select Big Clock from the Windows
menu", for example) and various editing functions.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Choose</term>
<listitem>
<para>
"Choosing" involves clicking or using the keyboard to accomplish
a one-time action. A command to save the current session might
be described as, "Choose Save from the Session menu.
</para>
</listitem>
</varlistentry>
</variablelist>
</section>
<!--
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="Some_Subsection.xml" />
-->
</section>
|
