diff options
Diffstat (limited to 'manual/xml/formatting_conventions.xml')
-rw-r--r-- | manual/xml/formatting_conventions.xml | 149 |
1 files changed, 149 insertions, 0 deletions
diff --git a/manual/xml/formatting_conventions.xml b/manual/xml/formatting_conventions.xml new file mode 100644 index 0000000000..286de128b9 --- /dev/null +++ b/manual/xml/formatting_conventions.xml @@ -0,0 +1,149 @@ +<?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". New and + important terms are written like this. + </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 like <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> + Some appropriate definition + </para> + </important> + + <caution> + <title>Caution</title> + + <para> + Some appropriate definition + </para> + </caution> + + <warning> + <title>Warning</title> + + <para> + Some appropriate definition + </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> |