Index: glossary.xml
===================================================================
--- glossary.xml	(revision 1460)
+++ glossary.xml	(working copy)
@@ -4,23 +4,46 @@
 
 ]>
 
+<!--
+Note:
+ - The glossary can contain general terminology from the (digital) recording domain, but should focus on Ardour-specific terms or senses.
+ 
+Questions (maybe to become notes as they are answered):
+ - Should this glossary contain only terms that are specific to Ardour, i.e. no MIDI, ALSA, etc.?
+ - Are "link" elements OK for linking to other glossary terms, or should we be using "glossterm" as an inline for these (or is this only for the first occurrence)?
+ - Why do the acronyms not appear on the HTML output? Ah, they have to be within some other element (e.g. glossterm).
+ - Capitalisation: lowercase for entries that are not acronyms or proper nouns?
+ - How will cross references be handled in the printed manual?  I guess we need to use "See Also"s and can't rely on links.  Then again, maybe a See Also is only required when the term is not actually used in the current definition (the reader could just look up an unfamiliar term when encountered).
+-->
+
 <glossary>
  <title>Ardour Glossary</title>
  <glossdiv>
   <title>A</title>
   <glossentry id="gt-alsa">
-   <glossterm><acronym>ALSA</acronym></glossterm>
+   <glossterm><acronym>ALSA</acronym> (Advanced Linux Sound Architecture)</glossterm>
    <glossdef>
     <para>
-     Abbreviation for Advanced Linux Sound Architecture. ALSA provides audio
-     and MIDI functionality to the Linux operating system.
+     ALSA provides audio and MIDI functionality to the Linux operating system.<!-- mention in-kernel parts, library, and utilities? -->
     </para>
     <para>
-     <ulink url="http://www.alsa-project.org"/>
+     Home page: <ulink url="http://www.alsa-project.org"/>
     </para>
    </glossdef>
   </glossentry>
 
+  <glossentry id="gt-api">
+   <glossterm><acronym>API</acronym> (Application Programming Interface)</glossterm>
+   <glossdef>
+    <para>
+     A set of functions exposed by a computer system (usually a library, service, or operating system) enabling it to be used by other systems.
+    </para>
+    <para>
+     An API is exposed at the level of source code, and is primarily used by programmers.
+    </para>
+   </glossdef>
+  </glossentry>
+
   <glossentry id="gt-audio-track">
    <glossterm>Audio Track</glossterm>
    <glossdef>
@@ -34,7 +57,7 @@
    <glossterm>Auditioner</glossterm>
    <glossdef>
     <para>
-     Some reasonable definition here.
+     A special <link linkend="gt-bus">bus</link> in Ardour that is independent of the rest of the mix, useful for auditioning specific regions by themselves.<!-- ??? -->
     </para>
    </glossdef>
   </glossentry>
@@ -46,8 +69,11 @@
    <glossterm>Bus</glossterm>
    <glossdef>
     <para>
-     Some reasonable definition here.
+     A virtual track that provides mixing and effects control over an entire group of tracks.  In analog mixing terminology, buses are sometimes known as groups or subs<!-- TODO: verify this -->.
     </para>
+    <para>
+     The output from each of the tracks assigned to the bus is sent to the bus and mixed, and the output of the bus can be sent to the master output bus or (less commonly) another bus.  The master bus is an always-present bus that usually provides a mix of all buses and tracks in the session, and is used to set the overall volume of the mix.
+    </para>
    </glossdef>
   </glossentry>
 
@@ -76,12 +102,14 @@
  <glossdiv>
   <title>D</title>
   <glossentry id="gt-daw">
-   <glossterm><acronym>DAW</acronym></glossterm>
+   <glossterm><acronym>DAW</acronym> (Digital Audio Workstation)</glossterm>
    <glossdef>
     <para>
-     Abbreviation of Digital Audio Workstation. Some reasonable definition
-     here.
+     A system for sound production, focusing on the functions of multi-track recording, playback, mixing, editing, and possibly also mastering.  DAWs often consist of specialised hardware (audio <!-- TODO: link? -->I/O devices, <!-- TODO: link? -->DSPs) and software.
     </para>
+    <para>
+     Since much of the functionality of a DAW can now be run in software on general-purpose personal computers, the term DAW can be used to refer specifically to an integrated software system for sound production.
+    </para>
    </glossdef>
   </glossentry>
 
@@ -89,7 +117,7 @@
    <glossterm>Destructive Recording</glossterm>
    <glossdef>
     <para>
-     Some reasonable definition here.
+     A recording mode in which any existing audio regions<!-- in a particular layer? --> in <!-- TODO: link -->armed tracks may be overwritten.  In Ardour, <link linkend="gt-tape-track">tape tracks</link> implement destructive recording.
     </para>
    </glossdef>
   </glossentry>
@@ -110,10 +138,10 @@
  <glossdiv>
   <title>H</title>
   <glossentry id="gt-hdr">
-   <glossterm><acronym>HDR</acronym></glossterm>
+   <glossterm><acronym>HDR</acronym> (Hard Disk Recorder)</glossterm>
    <glossdef>
     <para>
-     Short for Hard Disk Recorder. Some reasonable definition here.
+     Software and/or hardware for recording and playing back audio, using a hard disk drive as the storage medium.
     </para>
    </glossdef>
   </glossentry>
@@ -134,14 +162,20 @@
  <glossdiv>
   <title>J</title>
   <glossentry id="gt-jack">
-   <glossterm><acronym>JACK</acronym></glossterm>
+   <glossterm><acronym>JACK</acronym> (Jack<!-- or JACK? --> Audio Connection Kit)</glossterm>
    <glossdef>
     <para>
-     Initialism of Jack Audio Connection Kit. Some reasonable definition here.
+     A low-latency audio server for POSIX systems (including Linux and Mac OS X).
     </para>
     <para>
-     <ulink url="http://jackaudio.org"/>
+     JACK enables audio streams to be freely routed between applications and sound hardware or other applications, in real-time, and with sample-accurate synchronization.  As of version 0.102.20, JACK also supports <link linkend="gt-midi">MIDI</link> routing.
     </para>
+    <para>
+     Ardour requires that the JACK server, <command>jackd</command>, be running in order to record and play sounds.
+    </para>
+    <para>
+     Home page: <ulink url="http://jackaudio.org"/>
+    </para>
    </glossdef>
   </glossentry>
  </glossdiv>
@@ -149,30 +183,56 @@
  <glossdiv>
   <title>L</title>
   <glossentry id="gt-ladpsa">
-   <glossterm><acronym>LADSPA</acronym> </glossterm>
+   <glossterm><acronym>LADSPA</acronym> (Linux Audio Developer&apos;s Simple Plugin API)</glossterm>
    <glossdef>
     <para>
-     Abbreviation of Linux Audio Developers Simple Plugin API. Some reasonable
-     definition here.
+     A standard <link linkend="gt-api">API</link> for audio <link linkend="gt-plugin">plugins</link> on Linux.
     </para>
     <para>
-     <ulink url="http://ladspa.org"/>
+     Home page: <ulink url="http://ladspa.org"/>
     </para>
    </glossdef>
   </glossentry>
+
+  <glossentry id="gt-layer">
+   <glossterm>layer</glossterm>
+   <glossdef>
+    <para>
+     TODO
+    </para>
+   </glossdef>
+  </glossentry>
+
  </glossdiv>
 
  <glossdiv>
   <title>M</title>
   <glossentry id="gt-midi">
-   <glossterm><acronym>MIDI</acronym> </glossterm>
+   <glossterm><acronym>MIDI</acronym> (Musical Instrument Digital Interface)</glossterm>
    <glossdef>
     <para>
-     Abbreviation for Musical Instrument Digital Interface. Some reasonable
-     definition here.
+     A standard for the coding and transmission of musical performance data in digital form.
     </para>
+    <para>
+     MIDI data is akin to a musical score, in that it consists of instructions specifying what notes are to be played, by which instrument, at what time, and with what nuances (e.g. how loud the note should be).  A MIDI stream is typically much smaller than a digital reproduction of the waveform of the same performance.  MIDI also provides for the transmission of control and system data, and clock signals for synchronisation.
+    </para>
    </glossdef>
   </glossentry>
+
+  <glossentry>
+   <glossterm>mixer strip</glossterm>
+   <glossdef>
+    <para>
+     A user interface element in Ardour for controlling the flow and processing of the sound from<!-- or "for"?--> a single track.
+    </para>
+    <para>
+     A mixer strip provides controls such as a fader (for controlling the level), pan or balance<!-- does Ardour actually distinguish between these? -->, and pre- and post-fader inserts.  Mixer strips reside on the Mixer window, and a new strip is created for each new track.
+     <!-- Does Ardour distinguish between recorded and live sound as far as mixer strips are concerned? Does a mixer strip actually apply to a "channel" (or equivalent term), which may or may not have a track mapped to it (e.g. in the case of a live mix)?-->
+    </para>
+   </glossdef>
+  </glossentry>
+
+  <!-- TODO: add Mixer Window? -->
  </glossdiv>
 
  <glossdiv>
@@ -181,8 +241,11 @@
    <glossterm>Playlist</glossterm>
    <glossdef>
     <para>
-     some reasonable definition here.
+     A collection of audio <link linkend="gt-region">regions</link> in an Ardour <link linkend="gt-track">track</link>.  A track may have only one playlist at a time, and an active playlist may belong to only one track<!-- ??? is this correct? -->.  <!-- TODO: mention something about layers? -->
     </para>
+    <para>
+     Playlists are commonly used in recording multiple takes of a performance.
+    </para>
    </glossdef>
   </glossentry>
 
@@ -190,17 +253,16 @@
    <glossterm>plugin</glossterm>
    <glossdef>
     <para>
-     some reasonable definition here.
+     A reusable code library that can be used within another program (for example, to perform audio data processing).  Plugins are not standalone programs, and must be loaded and run within a host application.
     </para>
    </glossdef>
   </glossentry>
 
   <glossentry id="gt-posix">
-   <glossterm><acronym>POSIX</acronym></glossterm>
+   <glossterm><acronym>POSIX</acronym> (Portable Operating System Interface for uniX)</glossterm>
    <glossdef>
     <para>
-     POSIX stands for Portable Operating System Interface for uniX. Some
-     reasonable definition here.
+     A set of standards defining system and user interfaces for compatibility with the Unix operating system.
     </para>
    </glossdef>
   </glossentry>
@@ -208,8 +270,8 @@
 
  <glossdiv>
   <title>R</title>
-  <glossentry id="gt-region">
-   <glossterm>Region</glossterm>
+  <glossentry id="gt-redirect">
+   <glossterm>Redirect</glossterm>
    <glossdef>
     <para>
      Some reasonable definition here.
@@ -217,14 +279,15 @@
    </glossdef>
   </glossentry>
 
-  <glossentry id="gt-redirect">
-   <glossterm>Redirect</glossterm>
+  <glossentry id="gt-region">
+   <glossterm>Region</glossterm>
    <glossdef>
     <para>
-     Some reasonable definition here.
+     The basic element of editing in Ardour, representing a contiguous section of one or more audio files<!-- What does contiguous mean when applied to multiple files? -->.  A region normally resides within a <link linkend="gt-playlist">playlist</link>, which in turn normally resides within a <link linkend="gt-track">track</link>.
     </para>
    </glossdef>
   </glossentry>
+
  </glossdiv>
 
  <glossdiv>
@@ -242,8 +305,11 @@
    <glossterm>Session</glossterm>
    <glossdef>
     <para>
-     Some reasonable definition here.
+     An Ardour project; a collection of control data and audio files that form a performance.  Commonly, a session would be used for recording a single piece of music, although one session could be used to record an entire album or suite (especially in the case of a live performance).
     </para>
+    <para>
+     The Ardour user interface<!--(the Editor Window, in particular)--> is basically a tool for managing and manipulating sessions.  Each session is saved within a folder on the filesystem, with subfolders for audio files and automation data, and files for the session metadata and state, along with snapshots and backups of the session.
+    </para>
    </glossdef>
   </glossentry>
 
@@ -251,7 +317,7 @@
    <glossterm>Session Template</glossterm>
    <glossdef>
     <para>
-     Some reasonable definition here.
+     A saved Ardour <link linkend="gt-session">session</link> that can be used as a convenient starting point for a new session.
     </para>
     <glossseealso otherterm="gt-session"/>
    </glossdef>
@@ -283,8 +349,14 @@
    <glossterm>Track</glossterm>
    <glossdef>
     <para>
-     Some reasonable definition here.
+     The basic unit of recording in an Ardour <link linkend="gt-session">session</link><!-- TODO: I'm not happy with this definition -->.  A track typically represents the recording of a single instrument, and has controls such as gain and pan/balance applied to it on playback.  A session typically comprises multiple tracks, which can be played back simultaneously.
     </para>
+    <para>
+     Each track has one <link linkend="gt-playlist">playlist</link> associated with it at any time, which contains the audio <link linkend="gt-region">regions</link> to be played.  A track&apos;s playlist may have multiple regions, enabling a performance to be constructed from several smaller sections, or to control the levels and effects of multiple regions with one set of track controls.
+    </para>
+    <para>
+     An Ardour track can have many channels multiplexed within it, but most commonly only one (mono) or two (stereo) are used.  Ardour&apos;s multichannel mixing is currently somewhat limited, so tracks with many channels might be better split into multiple tracks<!-- is this still true? -->.
+    </para>
    </glossdef>
   </glossentry>
  </glossdiv>
@@ -292,11 +364,14 @@
  <glossdiv>
   <title>V</title>
   <glossentry id="gt-vst">
-   <glossterm><acronym>VST</acronym></glossterm>
+   <glossterm><acronym>VST</acronym> (Virtual Studio Technology)</glossterm>
    <glossdef>
     <para>
-     Short for Virtual Studio Technology
+     An audio <link linkend="gt-plugin">plugin</link> architecture defined by <ulink url="http://www.steinberg.net">Steinberg</ulink>.  The main types of VST plugin are instruments (digital synthesizers) and effects.
     </para>
+    <para>
+     Steinberg&apos;s VST <!--TODO: link-->SDK may be freely downloaded, but the license agreement does not permit it to be redistributed.  While Ardour can be compiled to support VST plugins, the VST SDK license prevents you from redistributing the binary.  This in turn means that you cannot comply with the GPL license that applies to Ardour.
+    </para>
    </glossdef>
   </glossentry>
  </glossdiv>
