Tim Mayberry
56e384349b
additions. Add dbhelper.vim key stroke mappings I use for working with docbook source. There are no xsl or css files for customizing the html output so it will look really boring...this will only be temporary. Support for content localization and generation of pdf's is planned. git-svn-id: svn://localhost/ardour2/trunk@1405 d708f5d6-7413-0410-9779-e7cbd77b26cf
150 lines
4.1 KiB
XML
150 lines
4.1 KiB
XML
<?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>
|